Como: instrumentar um componente independente nativo e coletar dados de tempo com o criador de perfil da linha de comando
Este tópico descreve como usar o Visual Studio ferramentas de linha de comando de ferramentas de criação de perfil para instrumentar um componente nativo, como um arquivo. exe ou. dll do C++ e coletar dados de tempo detalhado.
.gif "Observação") 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. |
Para coletar dados de tempo detalhado de um componente usando o método de instrumentação, você usa o VSInstr ferramenta para gerar uma versão instrumentada do componente.Em seguida, iniciar o profiler.Quando o componente instrumentado é executado, os dados de tempo 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 encerrar uma sessão de criação de perfil, você fecha o aplicativo de destino e, em seguida, explicitamente desligar o profiler.
Iniciando a sessão de criação de perfil
Para iniciar a criação de perfil usando o método de instrumentação
Abra uma janela de Prompt de comando.
Use o VSInstr ferramenta para gerar uma versão instrumentada do aplicativo de destino.
Inicie o profiler.Tipo:
**VSPerfCmd /start:trace /output:**OutputFile [Options]
O /start:trace 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 um ou mais 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 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.
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.O identificador de 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.
Inicia que o profiler com coleta de dados em pausa.Use /globalon para continuar a criação de perfil.
/Counter:Config
Coleta informações de que o contador de desempenho do processador que está especificado no Config.Informações sobre o contador é adicionado aos dados que são obtidos em cada evento de 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 os eventos de coleta do contador de desempenho do Windows.O padrão é 500 ms.
/Events: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 da maneira típica.
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
É 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 ID do processo (PID).
/threadon:TID/threadoff:TID
É iniciado (/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.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 em relatórios de profiler e exibições de 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.
Para finalizar uma sessão de criação de perfil
Feche o aplicativo de destino.
Desligar o profiler.Tipo:
VSPerfCmd /shutdown
Consulte também
Conceitos
A criação de linha de comando de perfil de aplicativos autônomos