Como: Instrumento autônomo.NET Framework componente e coletar dados de memória com o criador de perfil 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 para instrumentar um.O componente NET Framework de um aplicativo autônomo, como, por exemplo, um arquivo. exe ou. dll coletar informações e da memória usando o profiler.

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 coletar dados de memória de um.O componente NET Framework usando o método de instrumentação, use o VSInstr ferramenta para gerar uma versão instrumentada do componente e o VSPerfCLREnv.cmd ferramenta para inicializar variáveis de ambiente de criação de perfil. Inicie o profiler usando o VSPerfCmd.exe ferramenta.

Quando o componente instrumentado é executado, os dados da memória são coletados automaticamente para um arquivo de dados. Você pode pausar e continuar a coleta de dados durante a sessão de criação de perfil.

Para finalizar uma sessão de criação de perfil, você pode fecha o aplicativo de destino e explicitamente, desligar o profiler. Na maioria dos casos, é recomendável limpar as variáveis de ambiente de criação de perfil no final de uma sessão.

Iniciar o aplicativo com o Profiler

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

Abra a janela Prompt de Comando.
Use o VSInstr ferramenta para gerar uma versão instrumentada do aplicativo de destino.

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

VSPerfClrEnv {/tracegc | /tracegclife}

O /tracegc e /tracegclife Opções inicializar as variáveis de ambiente para coletar somente 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	Descrição
/tracegc	Permite a coleta de dados de alocação de memória somente.
/tracegclife	Habilita a coleta de alocação de memória e de dados de tempo de vida do objeto.

Inicie o profiler. Tipo:

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

O /start:trace 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:trace 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	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.
/GLOBALOFF	Para iniciar o profiler com coleta de dados em pausa, adicione a /globaloff a opção para o /start a linha de comando. Use /globalon para continuar a criação de perfil.
/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.
/Counter:Config	Coleta informações do contador de desempenho do processador é especificado no arquivo Config. Informações sobre o contador é adicionado aos dados coletados em cada evento de criação de perfil.
eventos: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).

Inicie o aplicativo de destino a partir da janela do Prompt de comando.

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 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 VSPerfCmd 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	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).
/THREADON:TID /threadoff:TID	Inicia (/threadon) ou pára (/threadoff) a coleta de dados para o segmento que é especificado pelo ID do thread (TID).

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, feche o aplicativo que está executando o componente instrumentado e depois 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 a criação de perfil variáveis de ambiente.

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

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