Cómo: Iniciar una aplicación de .NET Framework independiente con el generador de perfiles para recopilar datos de simultaneidad utilizando la línea de comandos

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

En este tema se describe cómo utilizar las herramientas de línea de comandos de las herramientas de generación de perfiles de Visual StudioVisual Studio para iniciar una aplicación independiente (cliente) de .NET Framework y recopilar datos de simultaneidad de procesos y de subprocesos.

Nota

Las herramientas de línea de comandos de las Herramientas de generación de perfiles se encuentran en el subdirectorio \Team Tools\Performance Tools del directorio de instalación de Visual StudioVisual Studio. En equipos de 64 bits, están disponibles versiones de 64 bits y de 32 bits de las herramientas. Para utilizar las herramientas de línea de comandos del generador de perfiles, debe agregar la ruta de acceso de las herramientas a la variable de entorno PATH de la ventana de símbolo del sistema o agregarla al propio comando. Para obtener más información, vea Especificar la ruta de acceso a las herramientas de línea de comandos.

Mientras el generador de perfiles está adjunto a la aplicación, puede pausar y reanudar la recolección de datos. Para finalizar una sesión de generación de perfiles, el generador de perfiles no debe estar ya asociado a la aplicación y debe cerrarse explícitamente.

Iniciar la aplicación con el generador de perfiles

Para iniciar una aplicación de destino de .NET Framework con el generador de perfiles, utilice VSPerfClrEnv.exe para establecer las variables de generación de perfiles de .NET Framework. A continuación, utilice las opciones /start y /launch de VSPerfCmd para inicializar el generador de perfiles e iniciar la aplicación. Puede especificar /start y /launch y sus opciones respectivas en una línea de comandos única. También puede agregar la opción /globaloff a la línea de comandos para pausar la recolección de datos cuando se inicia la aplicación de destino. A continuación, utilice /globalon en una línea de comandos independiente para empezar a recopilar datos.

Para iniciar una aplicación con el generador de perfiles

  1. Abra una ventana de símbolo del sistema.

  2. Inicie el generador de perfiles. Escriba:

    VSPerfCmd /start:concurrency[,{ResourceOnly|ThreadOnly}] /output:OutputFile [Options]

    • La opción /start inicializa el generador de perfiles.

      /start:concurrency Habilita la recolección tanto de datos de contención de recursos como de ejecución de subprocesos.
      /start:concurrency,resourceonly Habilita únicamente la recolección de datos de contención de recursos.
      /start:concurrency,threadonly Habilita únicamente la recolección de datos de ejecución de subprocesos.
    • La opción /output:OutputFile es necesaria con /start. OutputFile especifica el nombre y la ubicación del archivo de datos de generación de perfiles (.vsp).

      Puede usar cualquiera de las siguientes opciones con la opción /start:concurrency .

    Opción Descripción
    /user :[domain\]username Especifica el dominio y el nombre de usuario opcionales de la cuenta a la que se va a conceder acceso al generador de perfiles.
    /crosssession Habilita la generación de perfiles de procesos en otros inicios de sesión.
    /wincounter : WinCounterPath Especifica un contador de rendimiento de Windows que se va a recopilar durante la generación de perfiles.
    /automark : Interval Se utiliza únicamente con /wincounter. Especifica el número de milisegundos entre eventos de recopilación de contadores de rendimiento de Windows. El valor predeterminado es 500 ms.
    /events : Config Especifica un evento de Seguimiento de eventos para Windows (ETW) que se va a recopilar durante la generación de perfiles. Los eventos ETW se recopilan en un archivo (.etl) independiente.
  3. Inicie la aplicación de destino. Escriba:

    VSPerfCmd /launch : AppName [Options] [Sample Event]

    Puede usar cualquiera de las siguientes opciones con la opción /launch.

    Opción Descripción
    /args : Arguments Especifica una cadena que contiene los argumentos de la línea de comandos que se van a pasar a la aplicación de destino.
    /console Inicia la aplicación de línea de comandos de destino en otra ventana.
    /targetclr : Version Especifica la versión de Common Language Runtime (CLR) para generar perfiles cuando se carga más de una versión del runtime en una aplicación.

Controlar la recolección de datos

Mientras se ejecuta la aplicación de destino, puede controlar la recolección de datos iniciando o deteniendo la escritura de los datos en el archivo con las opciones de VSPerfCmd.exe. Al controlar la recolección de datos, puede recopilar datos de una parte específica de la ejecución de un programa, como por ejemplo el inicio o el cierre de la aplicación.

Para iniciar y detener la recolección de datos

  1. Los siguientes pares de opciones de VSPerfCmd.exe inician y detienen la recolección de datos. Especifique cada opción en una línea de comandos diferente. Puede activar y desactivar la recolección de datos varias veces.

    Opción Descripción
    /globalon /globaloff Inicia (/globalon) o detiene (/globaloff) la recolección de datos de todos los procesos.
    /processon : PID /processoff:PID Inicia (/processon) o detiene (/processoff) la recolección de datos del proceso especificado por el identificador de proceso (PID).
    /attach :{PID|ProcName} /detach[:{PID|ProcName}] /attach inicia la recolección de datos para el proceso especificado por el identificador de proceso (PID) o por el nombre de proceso (ProcName). /detach detiene la recolección de datos para el proceso especificado o para todos los procesos si no se especifica uno.

Finalizar la sesión de generación de perfiles

Para finalizar la sesión de generación de perfiles, el generador de perfiles no debe estar recopilando datos. Puede dejar de recopilar datos de simultaneidad cerrando la aplicación para la que se generan perfiles o invocando la opción VSPerfCmd /detach. Después invoque la opción VSPerfCmd /shutdown para desactivar el generador de perfiles y cerrar el archivo de datos de generación de perfiles. El comando VSPerfClrEnv /off borra las variables de entorno de generación de perfiles.

Para finalizar una sesión de generación de perfiles

  1. Siga uno de estos procedimientos para desasociar el generador de perfiles de la aplicación de destino.

    • Cierre la aplicación de destino.

      O bien

    • Escriba VSPerfCmd /detach

  2. Apague el generador de perfiles.

    VSPerfCmd /shutdown

Vea también

Recopilar datos de simultaneidad