VSPerfReport

La herramienta de la línea de comandos VSPerfReport se usa para crear informes mediante las herramientas de generación de perfiles de archivos de datos de perfiles de Visual Studio. El formato de informe predeterminado es un archivo .csv.

VSPerfReport usa la sintaxis siguiente:

VSPerfReport [/U] vspfilename [/options]

Observe que filename debe ser un archivo .vsp o .vsps válido.

La herramienta de línea de comandos VSPerfReport también se usa para comparar archivos .vsp o .vsps. Para generar un informe de diferencias ("diff"), use la sintaxis siguiente:

VSPerfReport [/U] /diff vspfilename1 vspfilename2 [/options]

vspfilename1 and vspfilename2 deben ser archivos .vsp o .vsps válidos.

Archivos de símbolos

Para mostrar información de símbolos como nombres de función y números de línea, VSPerfReport requiere acceso a los archivos de símbolos (.PDB) de los componentes para los que se generan perfiles y a los archivos de símbolos de Windows. Para obtener más información, vea Cómo: Especificar ubicaciones del archivo de símbolos desde la línea de comandos.

Opciones generales de informe

En la tabla siguiente se describen las opciones generales de formato del informe y las opciones que seleccionan los datos de los que se va a informar.

Opciones	Descripción
U	El informe de resultados y la salida de la consola redirigida se escriben como Unicode. Debe ser la primera opción especificada.
Summary:[tipos]	Crea uno o más tipos de informes. All: se generan todos los tipos de informes. CallerCallee: relaciones de elemento primario/secundario entre funciones. Function: funciones invocadas. CallTree: jerarquía de funciones invocadas. Counter: todas las marcas junto con valores del contador de rendimiento de Windows. Ip: instrucciones para las que se generan perfiles. Life: duración de los objetos asignados (disponible cuando se han recopilado datos de asignaciones). Line: datos del perfil de la línea de código fuente. Header: el informe contiene información del encabezado del archivo. Mark: todas las marcas. Module: módulos para los que se generan perfiles. Process: procesos para los que se generan perfiles. Thread: subprocesos para los que se generan perfiles. Type: tipos asignados. Contention: contenciones de recursos. RuleWarnings: problemas de reglas de rendimiento. ETW : todos los eventos de Seguimiento de eventos para Windows (ETW) recopilados en la generación de perfiles. El archivo de datos .etl debe estar en su ubicación original o en el directorio que contiene el archivo .vsp o .vsps.
Xml	Informe de resultados en formato XML.
CallTrace	Crea una lista de entradas y salidas de la función, eventos ETW y marcas.
ClearPackedSymbols	Quita los símbolos incrustados previamente de un archivo de datos del generador de perfiles. Ejecute este comando antes de ejecutar PackSymbols por segunda vez.
SymbolPath:path	Especifica una o más rutas de acceso de búsqueda o servidores de símbolos que contienen los símbolos para el archivo de datos del generador de perfiles.
DebugSymPath	Enumera las ubicaciones en las que se buscan los símbolos y si se encuentran. Esta opción es útil para resolver problemas de resolución de símbolos.
PackSymbols	Guarda los símbolos en el archivo de datos de generación de perfiles (.vsp) de modo que los archivos de símbolos (.pdb) no se requieran en el análisis.
Output:ruta de acceso|filename	Especifica una ubicación alternativa para los archivos de informe generados. De forma predeterminada, los informes se crean en el directorio actual.
SummaryFile	Analiza y guarda la información analizada en un archivo de resumen .vsps.
PrintMarks	Muestra los nombres y marcas de tiempo para todas las marcas del archivo de informe especificado.
?	Muestra información de uso.
NoLogo	Oculta la información de versión cuando el informe se está ejecutando.
UserRulesDirectory	Especifica el directorio que contiene las reglas de rendimiento definidas por el usuario [todavía sin implementar].

Opciones de filtro

En la tabla siguiente se describen las opciones para filtrar los datos disponibles.

Opciones	Descripción
JustMyCode[:[caller][,callee]]	Solo se muestran las llamadas a funciones de aplicación de usuario; se ocultan las llamadas al sistema. Ningún parámetro: se ocultan todas las funciones del sistema. caller: se muestra un nivel de las funciones del sistema que llaman a las funciones de aplicación. callee: se muestra un nivel de las funciones del sistema invocadas por las funciones de aplicación de usuario.
StartTime:[value]	Sólo muestra los datos recopilados tras el valor (en milisegundos).
EndTime:[value]	Sólo muestra los datos recopilados antes del valor (en milisegundos).
FilterFile:VSPFFile	Especifica la ubicación de un archivo de filtro que se generó en la ventana Informe de rendimiento de Visual Studio.
MsFilter:[starttime, duración]	Solo se muestran los datos de starttime hasta la longitud de duration (en milisegundos).
Process:[pid]	Sólo muestra los datos del proceso especificado.
Thread:[threadid]	Sólo muestra los datos del subproceso especificado.
Thread:[threadid, processid]	Sólo muestra los datos del subproceso especificado asociado al proceso especificado.

Opciones del informe de diferencias

En la tabla siguiente se describen las opciones para comparar archivos de informe.

Opciones	Descripción
Diff vspfile1 vspfile2	Compare dos archivos de informe (.vsp o .vsps). Las opciones de resumen se omitirán mediante la opción diff.
Diff:[valor]	Se descarta cualquier diferencia entre dos valores que se encuentre bajo este valor de umbral. Asimismo, no se muestran nuevos datos que tengan valores por debajo de este umbral.
DiffTable:[nombreDeTabla]	Use esta tabla concreta para comparar archivos. El valor predeterminado es la tabla de funciones.
DiffColumn:[nombreDeColumna]	Use estos valores de comparación de columna específicos. El valor predeterminado es la columna de porcentaje de ejemplos exclusivos.
QueryDiffTables	Muestra las tablas y columnas válidas para los dos archivos de informe proporcionados.

Vea también

Otros recursos

Vistas de informes de las herramientas de generación de perfiles