Referencia: comandos de vcperf
Las herramientas de C++ Build Insights están disponibles a partir de Visual Studio 2019 y versiones posteriores. Para ver la documentación de esta versión, establezca el control de selector de la versión de Visual Studio, que está en este artículo, en Visual Studio 2019 o en una versión posterior. Se encuentra en la parte superior de la tabla de contenido de esta página.
En este artículo se enumeran y describen los comandos disponibles en vcperf.exey cómo usarlos.
Comandos para iniciar y detener seguimientos
Importante
A menos que especifique /noadmin, los siguientes comandos requieren privilegios administrativos.
| Opción | Argumentos y descripción |
|---|---|
/start |
[] [/nocpusampling] [/level1/level3 | /level2 | ]/noadmin<sessionName> |
| Inicia un seguimiento bajo el nombre de sesión especificado. La /noadmin opción ejecuta vcperf.exe sin privilegios de administrador y omite la /nocpusampling opción. Al ejecutar vcperf sin privilegios de administrador, puede haber más de una sesión activa en un equipo determinado. La /nocpusampling opción especifica vcperf.exe no recopila muestras de CPU. Impide el uso de la vista Uso de CPU (muestreado) en Windows Performance Analyzer, pero hace que los seguimientos recopilados sean más pequeños. Las /level1opciones , /level2o /level3 especifican los eventos MSVC que se van a recopilar, en el aumento del nivel de información. El nivel 3 incluye todos los eventos. El nivel 2 incluye todos los eventos excepto los eventos de creación de instancias de plantilla. El nivel 1 incluye todos los eventos excepto la creación de instancias de plantilla, la función y los eventos de archivo. Si no se especifica, /level2 se selecciona de forma predeterminada. Una vez que vcperf.exe inicia el seguimiento, devuelve inmediatamente. El seguimiento recopila eventos en todo el sistema para todos los procesos que se ejecutan en la máquina. Esto significa que no es necesario compilar el proyecto en la misma ventana del símbolo del sistema que usa para ejecutar vcperf.exe. Por ejemplo, puede compilar el proyecto en Visual Studio. |
|
/stop |
(1) [/templates] <sessionName> <outputFile.etl> (2) [ /templates] <sessionName> /timetrace <outputFile.json> |
Detiene el seguimiento identificado por el nombre de sesión determinado. Ejecuta un paso posterior al procesamiento en el seguimiento para generar un archivo especificado por el <outputFile> parámetro . La /templates opción incluye eventos de creación de instancias de plantilla en el archivo. (1) Genera un archivo visible en Windows Analizador de rendimiento (WPA). El archivo de salida requiere una .etl extensión.(2) Genera un archivo visible en el visor de seguimiento de Microsoft Edge ( edge://tracing). El archivo de salida requiere una .json extensión. |
|
/stopnoanalyze |
<sessionName> <rawOutputFile.etl> |
| Detiene el seguimiento identificado por el nombre de sesión determinado y escribe los datos sin formato y sin procesar en el archivo de salida especificado. El archivo resultante no está pensado para ver en WPA. En ocasiones, el paso posterior al procesamiento implicado en el comando /stop puede ser largo. Puede usar el comando /stopnoanalyze para retrasar este paso posterior al procesamiento. Use el /analyze comando cuando esté listo para generar un archivo visible en Windows Analizador de rendimiento o el visor de seguimiento de Microsoft Edge. |
Comandos varios
| Opción | Argumentos y descripción |
|---|---|
/analyze |
(1) [/templates] <rawInputFile.etl> <outputFile.etl> (2) [ /templates] <rawInputFile.etl> /timetrace <outputFile.json> |
Acepta un archivo de seguimiento sin procesar generado por el comando /stopnoanalyze. Ejecuta un paso posterior al procesamiento en este seguimiento para generar el archivo especificado por el <outputFile> parámetro . La /templates opción incluye eventos de creación de instancias de plantilla en el archivo. (1) Genera un archivo visible en Windows Analizador de rendimiento (WPA). El archivo de salida requiere una .etl extensión. (2) Genera un archivo visible en el visor de seguimiento de Microsoft Edge ( edge://tracing). El archivo de salida requiere una .json extensión. |
Consulte también
Introducción a C++ Build Insights
Tutorial: Conceptos básicos de Windows Analizador de rendimiento
Referencia: Vistas de windows Analizador de rendimiento
Windows Performance Analyzer