Como: Inicie autônoma.NET Framework com o criador de perfil para coletar os dados da memória 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 memória de coleta de dados.

Uma sessão de criação de perfil possui três partes:

• Iniciando o aplicativo usando o profiler.

• Coleta de dados de criação de perfil.

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

Observaçã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.

Iniciar o aplicativo com o Profiler

Para iniciar um aplicativo de destino usando o criador de perfil, use o VSPerfCmd.exe /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 linha de comando.

Você também pode adicionar o /globaloff Opções para pausar a coleta de dados no início do aplicativo de destino. Você usar /globalon para começar a coletar dados.

Para iniciar um aplicativo usando o criador de perfil

1. Abra a janela Prompt de Comando.

2. Inicie o profiler. Tipo:

   **VSPerfCmd /start:sample /output:**OutputFile [Options]

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

   • 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:sample opção.

   Opção	Descrição
   /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.

3. Inicie o aplicativo de destino. Tipo:

   VSPerfCmd /launch**:**appName /gc:{allocation|lifetime}[Options]

   • O /gc**:**Keyword opção é necessária para coletar.Dados de memória do NET Framework. O parâmetro de palavra-chave especifica se coletar dados de alocação de memória ou para coletar alocação de memória e de dados de tempo de vida do objeto.

     Keyword	Descrição
     allocation	Colete dados de alocação de memória somente.
     lifetime	Colete alocação de memória e de dados de tempo de vida do objeto.

   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.
   /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).
   /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

Quando o aplicativo de destino está executando, você pode controlar a coleta de dados por iniciar e parar a gravação de dados para o arquivo usando VSPerfCmd.exe Opções. Controlar a coleta de dados permite coletar dados para uma parte específica da execução do programa, como iniciar ou desligar o aplicativo.

Para iniciar e interromper a coleta de dados

• Os seguintes pares de opções de iniciar e interromper a coleta de dados. Especifica cada opção em uma linha de comando separada. 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 que é especificado pelo ID do processo (PID).
  / conexão:PID / Desanexar	/attachcomeça a coletar dados para o processo que é especificado por PID (a identificação do processo). /detachpára a coleta de dados para todos os processos.

• Você também pode usar o VSPerfCmd.exe dd255359(v=vs.100).mdmarca/ a opção para inserir uma marca de criação de perfil para o arquivo de dados. O /mark comando adiciona um identificador, um carimbo de hora e uma seqüência de caracteres de um texto opcional definido pelo usuário. Marcas podem ser usadas para filtrar os dados.

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

Para finalizar uma sessão de criação de perfil, o criador de perfil deve ser desconectado de todos os processos de perfil e o criador de perfil deve ser desligado explicitamente. Você pode desconectar o gerador de perfil de um aplicativo que foi perfilado usando o método de amostragem, fechando o aplicativo ou chamando o VSPerfCmd /detach opção. Em seguida, chamar 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. Execute uma das seguintes etapas para desconectar o gerador de perfil do aplicativo de destino:

   • Feche o aplicativo de destino.

     - ou -

   • TipoVSPerfCmd /detach

2. Desligar o profiler. Tipo:

   VSPerfCmd /Shutdown

Consulte também

Conceitos

Ferramentas de criação de perfil de linha de comando de aplicativos autônomos

Outros recursos

Ferramentas de criação de perfil.Exibições de dados de memória de NET