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 |
[/nocpusampling] [/enableSilos] [/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 Analizador de rendimiento, 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. Para recopilar eventos de creación de instancias de plantilla para el análisis con /templates, use /level3. Una vez que vcperf.exe inicia el seguimiento, devuelve inmediatamente. El seguimiento recopila eventos en todo el sistema para los procesos. 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. |
|
La opción /enableSilos, cuando está disponible, permite que una sesión de seguimiento de host recopile eventos MSVC de silos de servidor de Windows, incluidos los contenedores de Windows aislados del proceso (no los contenedores que usan aislamiento de Hyper-V). La colección de silo está deshabilitada de forma predeterminada. Afecta solo al proveedor MSVC y no cambia la configuración de eventos del sistema o de muestreo de CPU. |
|
/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 creación de instancias de plantilla en el archivo si el seguimiento se inició con /level3. Genera un archivo visible para 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 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 creación de instancias de plantilla en el archivo si el seguimiento se inició con /level3. Genera un archivo visible para 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. |
|
/grantusercontrol |
No hay argumentos. |
Concede al usuario actual permiso para iniciar y detener las sesiones de seguimiento de vcperf que usan /noadmin sin elevación. Ejecute vcperf /grantusercontrol desde un símbolo del sistema con privilegios elevados una vez por usuario en cada máquina. El muestreo de CPU todavía requiere una traza con privilegios elevados sin /noadmin. El comando se agregó en vcperf release 2.5.25121101. |
Seguimiento sin privilegios de administrador
En un símbolo del sistema con privilegios elevados, conceda al usuario actual permiso para controlar las sesiones de seguimiento:
vcperf /grantusercontrol
En un símbolo del sistema sin elevación, inicie un seguimiento:
vcperf /start /noadmin MySession
Compile el proyecto y, a continuación, detenga el seguimiento desde un símbolo del sistema sin elevación:
vcperf /stop MySession output.etl
Consulte también
Primeros pasos con C++ Build Insights
Tutorial: conceptos básicos de Windows Analizador de rendimiento
Referencia: vistas de Windows Analizador de rendimiento
Analizador de rendimiento de Windows