Como: Iniciar 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 o Visual Studio ferramentas de linha de comando de ferramentas de criação de perfil para iniciar um.Aplicativo de autônomo (cliente) do NET Framework e coletar dados de simultaneidade de thread e processo

Observação

Ferramentas de linha de comando das ferramentas de criação de perfil estão localizadas no subdiretório de ferramentas \Team Tools\Performance 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 mais informações, consulte Especificando o caminho para a criação de perfil de ferramentas de linha de comando.

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 criador de perfil não deve ser anexado ao aplicativo e o criador de perfil deve ser desligado explicitamente.

Iniciando o aplicativo com o criador de perfil

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.Você usar 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 o aplicativo de destino for iniciado.Você usar /globalon em uma linha de comando separada para começar a coletar dados.

Para iniciar um aplicativo com o criador de perfil

1. Abra uma janela de prompt de comando.

2. Inicie o profiler.Tipo:

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

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

     /start:concurrency	Habilita a coleta de contenção de recursos e de dados de execução da thread.
     /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.

   • The /output**:**OutputFile option is required with /start.OutputFileEspecifica o nome e localização do arquivo de dados (Vsp) criação de 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 os eventos de coleta do contador 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).

3. 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

Enquanto o aplicativo de destino é executado, você pode controlar a coleta de dados, iniciar e parar a gravação de dados para o arquivo usando as opções de VSPerfCmd.Controlar a coleta de dados permite que você colete 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 VSPerfCmd opções de 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
  /GLOBALON /globaloff	É iniciado (/globalon) ou pára (/globaloff) a coleta de dados para todos os processos.
  /processon:PID/processoff:PID	É iniciado (/processon) ou pára (/processoff) a coleta de dados para o processo especificado pelo identificador do processo (PID).
  /attach:{PID|ProcName} /detach[:{PID|ProcName}]	/attachcomeça 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 criador de perfil deve não ser coletando dados.Você pode parar de coletar 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 de criação de perfil.O VSPerfClrEnv /off comando limpa as variáveis de ambiente de criação de perfil.

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

Consulte também

Conceitos

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

Alterar Histórico

Date	History	Razão
Dezembro de 2011.	Removido VSPerfClrEnv /sampleon etapa.	Correção de bug de conteúdo.