Compartilhar via


Como: Inicie autônoma.NET Framework com o criador de perfil para coletar dados de simultaneidade, usando a linha de comando

Este tópico descreve como usar ferramentas de linha de comando de ferramentas de criação de perfilVisual Studio para iniciar um.Aplicativo de autônomo (cliente) do NET Framework e coletar dados de simultaneidade de processo e segmento

ObservaçãoObservação

Ferramentas de linha de comando das ferramentas de criação de perfil estão localizadas na subpasta \Team Tools\Performance ferramentas da Visual Studio diretório de instalação. Em computadores de 64 bits, as versões de 64 bits e de 32 bits das ferramentas estão disponíveis. Para usar as ferramentas de linha de comando do profiler, você deve adicionar o caminho de ferramentas para a variável de ambiente PATH da janela do prompt de comando ou adicioná-lo para o próprio comando. Para obter mais informações, consulte Especificando o caminho para as ferramentas de linha de comando de criação de perfil.

Para coletar dados de desempenho de um.NET do aplicativo do Framework, o ambiente adequado de variáveis devem ser inicializadas antes que o aplicativo de destino for iniciado. Enquanto o profiler é anexado ao aplicativo, você pode pausar e reiniciar a coleta de dados. Para finalizar uma sessão de criação de perfil, o Profiler não deve ser anexado ao aplicativo e o criador de perfil deve ser desligado explicitamente. Na maioria dos casos, é recomendável limpar as variáveis de ambiente de criação de perfil quando tiver concluído a criação de perfil.

Iniciar o aplicativo com o Profiler

Para iniciar um.Aplicativo de destino do NET Framework com o criador de perfil, use VSPerfClrEnv.exe para definir o.NET Framework, variáveis de criação de perfil. Use o VSPerfCmd /start e /launch Opções para inicializar o Profiler e inicie o aplicativo. Você pode especificar /start e /launch e suas respectivas opções em uma única linha de comando. Você também pode adicionar o /globaloff opção de linha de comando para pausar a coleta de dados quando é iniciado de aplicativo de destino. Você usar /globalon em uma linha de comando separada para começar a coletar dados.

Para iniciar um aplicativo com o Profiler

  1. Abra uma janela de prompt de comando.

  2. Inicializar o.Variáveis de ambiente de criação de perfil de NET Framework. Tipo:

    VSPerfClrEnv /sampleon

    • O /sampleon inicializa de opção o.Memória do NET Framework profiling variáveis de ambiente variáveis.
  3. Inicie o profiler. Tipo:

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

    • O /start opção inicializa o profiler.

      /start:concurrency

      Permite coletar dados de execução do thread e de contenção de recursos.

      /start:concurrency,resourceonly

      Habilita a coleta de dados somente de contenção de recursos.

      /start:concurrency,threadonly

      Habilita a coleta de dados de execução de thread único.

    • O /output**:**OutputFile opção é necessária com /start. OutputFileEspecifica o nome e o local do arquivo de dados (. vsp) do perfil.

    Você pode usar qualquer uma das seguintes opções com o /start:concurrency opção.

    Opção

    Descrição

    /user:domain\username

    Especifica o domínio opcional e nome de usuário da conta para ter acesso ao profiler.

    /crosssession

    Permite criação de perfil de processos em outras sessões de logon.

    /wincounter:WinCounterPath

    Especifica um contador de desempenho do Windows a serem coletados durante perfilação.

    /automark:Interval

    Use com /wincounter somente. Especifica o número de milissegundos entre eventos de coleção de contadores de desempenho do Windows. O padrão é 500 ms.

    /Events:Config

    Especifica um evento de rastreamento de eventos para Windows (ETW) a serem coletados durante perfilação. Eventos ETW são coletados em um arquivo separado (. ETL).

  4. Inicie o aplicativo de destino. Tipo:

    VSPerfCmd /launch**:**AppNameOptions] [Sample Event]

    Você pode usar qualquer uma das seguintes opções com o /launch opção.

    Opção

    Descrição

    /args:Arguments

    Especifica uma seqüência de caracteres que contém os argumentos de linha de comando a serem passados para o aplicativo de destino.

    /Console

    Inicia o aplicativo de linha de comando de destino em uma janela separada.

    /targetclr:Version

    Especifica a versão do common language runtime (CLR) para criar o perfil quando mais de uma versão do tempo de execução é carregada em um aplicativo.

Controlar a coleta de dados

Durante a execução do aplicativo de destino, você pode controlar a coleta de dados por iniciar e parar a gravação de dados para o arquivo usando as opções de VSPerfCmd. Controlar a coleta de dados permite coletar dados para uma parte específica da execução do programa, como o início ou o desligamento do aplicativo.

Para iniciar e interromper a coleta de dados

  • Os seguintes pares de opções de VSPerfCmd iniciar e interromper a coleta de dados. Especifica cada opção em uma separada de linha de comando. Você pode ativar a coleta de dados de logon e logoff várias vezes.

    Opção

    Descrição

    /globaloff de /GLOBALON

    Inicia (/globalon) ou pára (/globaloff) a coleta de dados para todos os processos.

    /PROCESSON:PID /processoff:PID

    Inicia (/processon) ou pára (/processoff) a coleta de dados para o processo especificado pelo ID do processo (PID).

    / conexão:{PID|ProcName} /detach[:{PID|ProcName}]

    /attachInicia a coletar dados para o processo especificado pelo ID do processo (PID) ou o nome do processo (ProcName). /detachpára a coleta de dados para o processo especificado ou para todos os processos se um processo específico não for especificado.

Encerrando a sessão de criação de perfil

Para finalizar uma sessão de criação de perfil, o profiler deve não ser coletando dados. Você pode interromper a coleta de dados de simultaneidade fechando o aplicativo perfilado, ou chamando o VSPerfCmd /detach opção. Você então chama o VSPerfCmd /shutdown opção para desativar o profiler e feche o arquivo de dados criação de perfil. O VSPerfClrEnv /off comando limpa a criação de perfil variáveis de ambiente.

Para finalizar uma sessão de criação de perfil

  1. Faça o seguinte para desanexar o criador de perfil do aplicativo de destino.

    • Feche o aplicativo de destino.

      - ou -

    • TipoVSPerfCmd /detach

  2. Desligar o profiler

    VSPerfCmd /Shutdown

  3. Limpar o.NET Framework, variáveis de criação de perfil. Tipo

    VSPerfClrEnv /off

Consulte também

Conceitos

Coleta de dados de simultaneidade para aplicativos autônomos, usando a linha de comando do Profiler