Tutorial: Generar perfiles utilizando la instrumentación en la línea de comandosWalkthrough: Command-Line Profiling Using Instrumentation

Este tutorial le guiará a través de la generación de perfiles de una aplicación independiente de .NET Framework.NET Framework para recopilar información de tiempo detallada y llamar a datos del contador mediante el método de instrumentación de las herramientas de generación de perfiles.This walkthrough takes you through profiling a .NET Framework.NET Framework stand-alone application to collect detailed timing and call count data by using the instrumentation method of the Profiling Tools. En este tutorial, se realizarán las siguientes tareas:In this walkthrough, you will accomplish the following tasks:

  • Utilizar la herramienta de línea de comandos VSInstr para generar binarios instrumentados.Use the VSInstr command line tool to generate instrumented binaries.

  • Utilizar la herramienta VSPerfCLREnv para establecer las variables de entorno para recopilar datos de generación de perfiles de .NET.Use the VSPerfCLREnv tool to set the environment variables to collect .NET profiling data.

  • Utilizar la herramienta VSPerfCmd para recopilar datos de generación de perfiles.Use the VSPerfCmd tool to collect profiling data.

  • Utilizar la herramienta VSPerfReport para generar informes basados en archivos de los datos de generación de perfiles.Use the VSPerfReport tool to generate file-based reports of the profiling data.

Requisitos previosPrerequisites

  • Visual Studio Application Lifecycle ManagementVisual Studio Application Lifecycle Management

  • Conocimientos intermedios de C#Intermediate understanding of C#

  • Conocimientos intermedios del uso de herramientas de la línea de comandosIntermediate understanding of working with command-line tools

  • Una copia de la muestra PeopleTraxA copy of the PeopleTrax Sample

  • Para trabajar con la información proporcionada por la generación de perfiles, es preferible disponer de la información de símbolos de depuración.To work with the information provided by profiling, it is best to have debugging symbol information available. Para obtener más información, consulte Cómo: Hacer referencia a información de símbolos de Windows.For more information, see How to: Reference Windows Symbol Information.

Generación de perfiles de la línea de comandos mediante el método de instrumentaciónCommand Line Profiling Using the Instrumentation Method

La instrumentación es un método de generación de perfiles mediante el cual versiones de los binarios de los que se generan perfiles creadas especialmente contienen funciones de sondeo que recopilan información de tiempo en la entrada y salida de funciones en un módulo instrumentado.Instrumentation is a profiling method by which specially built versions of the profiled binaries contain probe functions that collect timing information at the entry and exit to functions in an instrumented module. Dado que este método de generación de perfiles es más invasor que el muestreo, conlleva una mayor cantidad de sobrecarga.Because this method of profiling is more invasive than sampling, it incurs a greater amount of overhead. Los binarios instrumentados también son más grandes que los binarios de depuración o lanzamiento, y no están pensados para su implementación.Instrumented binaries are also larger than debug or release binaries and are not intended for deployment.

Nota

No envíe binarios instrumentados a los clientes.Do not send instrumented binaries to your customers. Los binarios instrumentados pueden contener varios riesgos.Instrumented binaries can contain several risks. Los binarios incluyen información que facilita realizar ingeniería inversa de la aplicación, así como los riesgos de seguridad.The binaries include information that makes your application easier to reverse engineer, as well as security risks.

Para generar perfiles de aplicación PeopleTrax mediante el método de instrumentaciónTo profile the PeopleTrax application by using the instrumentation method

  1. Instale la aplicación de ejemplo PeopleTrax y compile la versión de lanzamiento.Install the PeopleTrax sample application and build the Release version.

  2. Abra una ventana del símbolo del sistema y agregue el directorio de las herramientas de generación de perfiles a la variable de entorno local Path.Open a command prompt window and add the Profiling Tools directory to the local Path environment variable.

  3. Cambie el directorio de trabajo por el directorio que contiene los binarios de PeopleTrax.Change the working directory to the directory containing the PeopleTrax binaries.

  4. Cree un directorio para que contenga los informes basados en archivos.Create a directory to contain the file based reports. Escriba el comando siguiente:Type the following command:

    md Reports  
    
  5. Utilice la herramienta de línea de comandos VSInstr para instrumentar los binarios de la aplicación.Use the VSInstr command-line tool to instrument the binaries in the application. Escriba los siguientes comandos en líneas de comandos separadas:Type the following commands on separate command lines:

    VSInstr PeopleTrax.exe  
    VSInstr PeopleTrax.exe  
    VSInstr People.dll  
    VSInstr Person.dll  
    VSInstr Operation.dll  
    

    Nota De forma predeterminada, VSInstr guarda una copia de seguridad no instrumentada del archivo original.Note By default, VSInstr saves a non-instrumented backup of the original file. El nombre de archivo de copia de seguridad tiene la extensión .orig.The backup file name has the extension .orig. Por ejemplo, la versión original de "MyApp.exe" se guardaría como "MiAplic.exe.orig".For example, the original version of "MyApp.exe" would be saved as "MyApp.exe.orig."

  6. Escriba el comando siguiente para establecer las variables de entorno adecuadas:Type the following command to set the appropriate environment variables:

    VsPerfCLREnv /traceon  
    
  7. Escriba el siguiente comando para iniciar el generador de perfiles:To start the profiler, type the following command:

    VsPerfCmd /start:trace /output:Reports\Report.vsp  
    
  8. Después de iniciar el generador de perfiles en modo de seguimiento, ejecute la versión instrumentada del proceso PeopleTrax.exe para recopilar datos.After you start the profiler in trace mode, run the instrumented version of the PeopleTrax.exe process to collect data.

    Aparecerá la ventana de la aplicación PeopleTrax.The PeopleTrax application window appears.

  9. Haga clic en Get People.Click Get People.

    La cuadrícula de datos de PeopleTrax se rellena con datos.The PeopleTrax data grid populates with data.

  10. Haga clic en Exportar datos.Click Export Data.

    Se iniciará el Bloc de notas con un nuevo archivo que contiene una lista de personas de la aplicación de PeopleTrax.Notepad starts and displays a new file that contains a list of people from the PeopleTrax application.

  11. Cierre el Bloc de notas y después cierre la aplicación PeopleTrax.Close Notepad, and then close the PeopleTrax application.

  12. Cierre el generador de perfiles.Shut down the profiler. Escriba el comando siguiente:Type the following command:

    VSPerfCmd /shutdown  
    
  13. Escriba el siguiente comando para restablecer las variables de entorno:Type the following command to reset the environmental variables:

    VSPerfCLREnv /off  
    
  14. Use la herramienta VSPerfReport para generar o separar por comas archivos de informes de valores (.csv).Use the VSPerfReport tool to generate or comma-separated value (.csv) report files. Tipo:Type:

    VSPerfReport Reports\Report.vsp /output:Reports /summary:all  
    

    Puede analizar los informes generados en un programa de hoja de cálculo, o bien puede usar el IDE de Visual StudioVisual Studio para analizar los datos de generación de perfiles en el archivo Report.vsp.You can analyze the generated reports in a spreadsheet program, or you can use the Visual StudioVisual Studio IDE to analyze the profiling data in the Report.vsp file. Para obtener más información, consulte Analizar datos de las herramientas de rendimiento.For more information, see Analyzing Performance Tools Data.

Vea tambiénSee Also

Información general sobre las sesiones de rendimiento Performance Session Overview
Generación de perfiles desde la línea de comandos Profiling from the Command-Line
VSPerfCmd VSPerfCmd
Introducción a los valores de datos de muestreo Understanding Sampling Data Values
Vistas de informes de rendimientoPerformance Report Views