Como: Anexar o Profiler para um.NET Framework aplicativo autônomo para coletar os dados da memória usando a linha de comando

Artigo
08/08/2011

Este tópico descreve como usar ferramentas de linha de comando de ferramentas de criação de perfilVisual Studio Premium para anexar o profiler para uma execução.Aplicativo de autônomo (cliente) do NET Framework e memória de coleta de dados.

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.

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 anexar a um.NET Framework e memória de coleta de dados, você deve usar o VSPerfCLREnv.cmd ferramenta para inicializar as variáveis de ambiente apropriado antes do aplicativo de destino for iniciado. Quando o profiler é anexado ao aplicativo, você pode usar o VSPerfCmd.exe ferramenta para pausar e continuar a coleta de dados.

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. Na maioria dos casos, é recomendável limpar as variáveis de ambiente de criação de perfil no final de uma sessão.

Anexar o Profiler

Para anexar o Profiler para uma execução.Aplicativo do NET Framework

Abra a janela Prompt de Comando.
Inicialize as variáveis de ambiente de criação de perfil. Tipo:

VSPerfClrEnv {/samplegc | /samplegclife} [/samplelineoff]
- O /samplegc e /samplegclife opções especificam se deseja coletar apenas dados de alocação de memória, ou para coletar alocação de memória e dados de tempo de vida do objeto. Opção de apenas um deve ser especificada.
  
  Opção
  
  Descrições
  
  /samplegc
  
  Colete dados de alocação de memória somente.
  
  /samplegclife
  
  Colete alocação de memória e de dados de tempo de vida do objeto.
- O /samplelineoff opção desativa a coleção de origem código linha número dados.

Opção	Descrições
/samplegc	Colete dados de alocação de memória somente.
/samplegclife	Colete alocação de memória e de dados de tempo de vida do objeto.

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
/user:Domain\UserName	Especifica o nome de usuário e domínio da conta que possui o processo perfilado. Esta opção é necessária somente se o processo está sendo executado como um usuário diferente, por exemplo, o usuário conectado. O proprietário do processo está listado na coluna Nome do usuário na guia processos do Gerenciador de tarefas do Windows.
/crosssession \| /CS	Permite criação de perfil de processos em outras sessões. Esta opção é necessária se o aplicativo é executado em uma sessão diferente. Idenitifer a sessão está listado na coluna Identificação da sessão na guia processos do Gerenciador de tarefas do Windows. /CSpode ser especificado como uma abreviação de /crosssession.
/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.

Se necessário, inicie o aplicativo de destino da maneira típica.
Anexe o profiler ao aplicativo de destino. Tipo:

VSPerfCmd / conexão:{PID|ProcName} [/targetclr**:**Version
- PIDEspecifica a identificação de processo do aplicativo de destino. ProcessNameEspecifica o nome do processo. Observe que, se você especificar ProcessName e vários processos que têm o mesmo nome estão em execução, os resultados são imprevisível. Você pode exibir as identificações de todos os processos em execução de processos no Gerenciador de tarefas do Windows.
- **/targetclr:**VersionEspecifica 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. Opcional.

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 PID.
/ conexão:{PID\|ProcName} /detach[:{PID\|ProcName}]	/attachcomeça a coletar dados para o processo que é especificado pelo 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.

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

Execute uma das seguintes etapas para desconectar o gerador de perfil do aplicativo de destino:
- TipoVSPerfCmd /detach
  
  - ou -
- Feche o aplicativo de destino.
Desligar o profiler. Tipo:

VSPerfCmd /Shutdown
(Opcional) Desmarque as variáveis de ambiente de criação de perfil. Tipo:

VSPerfCmd /off

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

Compartilhar via