Como instrumentar um componente do .NET Framework autônomo e coletar dados de memória com o criador de perfil usando a linha de comando
Este tópico descreve como usar as ferramentas de linha de comando de Visual Studio Ferramentas de Criação de Perfil para prover um componente do.NET Framework de um aplicativo autônomo como um arquivo ou arquivo .dll e para coletar informações de memória usando o profiler.
.gif "Observação") Observação |
|---|
As ferramentas de linha de comando de Ferramentas de Criação de Perfil estão localizadas no no subdiretório \ ferramentas de equipe \ ferramentas de desempenho do diretório de instalação do Visual Studio.Nos computadores de 64 bits, ambas as versões de 64 bits e de 32 bits das ferramentas está disponível.Para usar as ferramentas de linha de comando do criador de perfis, você deve adicionar o caminho das ferramentas para a variável de ambiente PATH da janela Prompt de Comando ou adicioná-lo ao próprio comando.Para obter mais informações, consulte Especificando o caminho para ferramentas de linha de comando de ferramentas de criação de perfil. |
Para coletar dados de memória de um componente do.NET Framework usando o método de gerenciamento, use a ferramenta de VSInstr.exe para gerar uma versão instrumentada do componente e da ferramenta de VSPerfCLREnv.cmd para inicializar analisar as variáveis de ambiente.Você iniciar no profiler usando a ferramenta de VSPerfCmd.exe .
Quando o componente instrumentado é executado, os dados da memória são coletados automaticamente em um arquivo de dados.Você pode pausar e retomar a coleção de dados durante a sessão de criação de perfis.
Para terminar uma sessão, analisando você fecha o aplicativo de destino e feche explicitamente o profiler.Na maioria dos casos, recomendamos limpar as variáveis de ambiente ao final de uma sessão.
Iniciando o aplicativo com o criador de perfis
Para anexar o criador de perfis a um aplicativo do .NET Framework que está em execução
Abra uma janela de prompt de comando.
Use a ferramenta VSInstr para gerar uma versão instrumentada do aplicativo de destino.
Inicializar o.NET Framework que analisa as variáveis de ambiente.Tipo:
VSPerfClrEnv {/tracegc | /tracegclife}
As opções de /tracegc e de /tracegclife inicializam as variáveis de ambiente para coletar apenas dados de alocação de memória, ou para coletar a alocação de memória para o objeto e dados de tempo de vida.
Opção
Descrição
/tracegc
Habilita a coleção de dados de alocação de memória apenas.
/tracegclife
Habilita a coleção de dados do tempo de vida de alocação de memória e do objeto.
Inicie o criador de perfis.Tipo:
**VSPerfCmd /start:trace /output:**OutputFile [Options]
A opção /start:trace inicializa o criador de perfis.
A opção /output**:**OutputFileé necessária com /startOutputFile especifica o nome e o local dos dados de perfil (.vsp).
Você pode usar qualquer uma das seguintes opções com a opção /start:trace.
Opção
Descrição
/user:[Domain\]UserName
Especifica o domínio e o nome do usuário da conta que possui o processo com perfil.Essa opção é necessária somente se o processo estiver sendo executado como um usuário diferente do usuário conectado.O proprietário do processo é listado na coluna de nome de usuário na guia de processos do gerenciador de tarefas do Windows.
Permite analisar os processos em outras sessões.Essa opção será necessária se o aplicativo estiver sendo executado em uma sessão diferente.O identificador de sessão é listado na coluna ID da sessão na guia Processos do Windows Task Manager./CS pode ser especificado como uma abreviação para /crosssession.
Para iniciar o criador de perfis com a coleção de dados pausada, adicione a opção de /globaloff à linha de comando /start.Use /globalon para continuar a criação de perfis.
/wincounter:WinCounterPath
Especifica o contador de desempenho do Windows que será coletado durante a análise.
/automark:Interval
Uso com /wincounter somente.Especifica o número de milissegundos entre eventos de coleção contador de desempenho do Windows.O padrão é 500 ms.
/counter:Config
Coleta informações do contador de desempenho de processador que é especificada na configuração.As informações do contador é adicionado aos dados coletados em cada evento analisando.
eventos:Config
Especifica um rastreamento de evento para evento do Windows (ETW) para ser coletado durante a análise.Os eventos de ETW são coletados em um arquivo separado (.etl).
Inicie o aplicativo de destino na janela prompt de comando.
Coleta de dados de controle
Durante a execução do aplicativo de destino, é possível controlar a coleção de dados iniciando e interrompendo a gravação de dados no arquivo usando as opções de VSPerfCmd.exe.A coleta de dados de controle permite que você colete dados para uma parte específica de execução do programa, como o inicio ou término do aplicativo.
Para iniciar e parar a coleção de dados
Os seguintes pares de opções VSPerfCmd iniciam e interrompem a coleção de dados.Especifique cada opção em uma linha separada de comando.É possível desativar e ativar a coleção de dados várias vezes.
Opção
Descrição
Inicia (/globalon) ou para (/globaloff) a coleção de dados para todos os processos.
/processon:PID/processoff:PID
Inicia/processon() ou para coleta de dados (de/processoff) para o processo que é especificado pela ID de processo (PID).
/threadon:TID/threadoff:TID
Inicia/threadon() ou para coleta de dados () de/threadoffdo thread que é especificado pela ID de threadTID().
Finalizando a sessão de análise
Para terminar uma sessão, analisando feche o aplicativo que está executando o componente provido, e para chamar na opção de VSPerfCmd /shutdown desativar o profiler e para fechar os dados de perfil arquivo.O comando VSPerfClrEnv /off apaga as variáveis de ambiente de criação de perfis.
Para finalizar uma sessão de criação de perfil
Feche o aplicativo de destino.
Encerrar o criador de perfis.Tipo:
VSPerfCmd /shutdown
(Opcional) Limpe as variáveis do ambiente do perfil.Tipo:
VSPerfCmd /off
Consulte também
Conceitos
Criação de perfil de linha de comando dos aplicativos autônomos
Outros recursos
Exibições de dados da memória do .NET das ferramentas de criação de perfil