Como instrumentar um componente autônomo nativo e coletar dados de tempo com o criador de perfil a partir da linha de comando

Artigo
06/08/2015

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 nativo como c criando .exe ou arquivo .dll, e para coletar dados de controle de tempo detalhado.

Observação
Ferramentas de linha de comando das Ferramentas de Criação de Perfil estão localizadas no subdiretório \Team Tools\Performance Tools do diretório de instalação 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.

Ferramentas de linha de comando das Ferramentas de Criação de Perfil estão localizadas no subdiretório \Team Tools\Performance Tools do diretório de instalação 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 controle de tempo detalhado de um componente usando o método de gerenciamento, use a ferramenta de VSInstr.exe para gerar uma versão instrumentada do componente.Inicie o criador de perfis.Durante a execução do componente instrumentado, os dados do tempo 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ê fechar o aplicativo de destino e então feche explicitamente o profiler.

Iniciando a sessão de análise

Para iniciar a análise usando o método de gerenciamento

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

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 uma ou mais das seguintes opções com a opção de /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.
/crosssession	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.A identificação da sessão é listada na coluna ID da sessão na guia de processos do gerenciador de tarefas do Windows./CS pode ser especificado como uma abreviação para /crosssession.
/globaloff	Inicia o profiler com a coleta de dados pausada.Use /globalon para continuar analisar.
/counter:Config	Coleta informações do contador de desempenho de processador que é especificado em Config.As informações do contador é adicionado aos dados coletados em cada evento analisando.
/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.
/events: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 destino da forma normal.

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 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
/globalon /globaloff	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.

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

Feche o aplicativo de destino.
Encerrar o criador de perfis.Tipo:

VSPerfCmd /shutdown

Consulte também

Conceitos

Criação de perfil de linha de comando dos aplicativos autônomos

Outros recursos

Exibições de dados do método de instrumentação do criador de perfil

Compartilhar via