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

Artigo
02/25/2013

Este tópico descreve como usar o Visual Studio Premium ferramentas de linha de comando de ferramentas de criação de perfil para anexar o profiler a 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 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 obter mais informações, consulte Especificando o caminho para a criação de perfil de ferramentas de linha de comando.

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 obter mais informações, consulte Especificando o caminho para a criação de perfil de ferramentas de linha de comando.

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 reiniciar a coleta de dados.

Anexar o Profiler

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

Abra uma janela de 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 deve coletar dados de alocação de memória apenas ou para coletar alocação de memória e de dados de tempo de vida do objeto.Somente uma opção 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 dados de número de linha de código fonte.

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.
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: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 com perfil.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 os eventos de coleta do contador de desempenho do Windows.O padrão é 500 ms.

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

VSPerfCmd /attach:{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 execução de vários processos que têm o mesmo nome, os resultados serão imprevisíveis.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 o VSPerfCmd.exe opções.Controlar a coleta de dados permite que você colete 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
/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 que é especificado pelo PID.
/attach:{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.exedd255359(v=vs.110).md marca/ opção para inserir uma marca de criação de perfil no 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 com perfil e o criador de perfil deve ser desligado explicitamente.Você pode desconectar o gerador de perfil de um aplicativo que teve seu perfil publicado 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 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

Execute uma das seguintes etapas para desconectar-se o criador 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

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

Outros recursos

Ferramentas de criação de perfil.Modos de exibição de dados de memória de NET

Compartilhar via