Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Las herramientas de C++ Build Insights están disponibles a partir de Visual Studio 2019 y versiones posteriores. Para ver la documentación de esa versión, establezca el selector de versión de Visual Studio en Visual Studio 2019 o en una versión posterior para este artículo. 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 registros
Importante
A menos que especifique /noadmin, los siguientes comandos requieren privilegios administrativos.
| Opción | Argumentos y descripción |
|---|---|
/start |
[] [/noadmin] [/nocpusampling/level1 | /level2 | ]/level3<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 las trazas recopiladas sean más pequeñas. Las /level1 opciones, /level2 o /level3 especifican qué eventos MSVC se van a recopilar, con un nivel creciente 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 utiliza 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 de post-procesamiento en el seguimiento para generar un archivo especificado por el parámetro <outputFile>. La /templates opción incluye eventos de instanciación de plantillas en el archivo. Genera un archivo visible para Windows Performance Analyzer (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 dado 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 de post-procesamiento en este seguimiento para generar el archivo especificado por el parámetro <outputFile>. La /templates opción incluye eventos de instanciación de plantilla en el archivo. Genera un archivo visualizable en el Analizador de rendimiento de Windows (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 del Analizador de rendimiento de Windows
Analizador de rendimiento de Windows