Compartilhar via


Instrumentar um componente autônomo nativo e coletar dados de tempo com o criador de perfil usando a linha de comando

Este artigo descreve como usar as ferramentas de criação de perfil de linha de comando do Visual Studio para instrumentar um componente nativo, como um arquivo C++ .exe ou .dll , para coletar dados detalhados de tempo.

Para coletar dados de tempo detalhados de um componente nativo usando o método de instrumentação, use a ferramenta VSInstr.exe para gerar uma versão instrumentada do componente. Em seguida, inicie o criador de perfil da mesma forma que os outros cenários de linha de comando usando a configuração do agente PerfInstrumentation.json . Quando o componente instrumentado é executado, os dados de medição são coletados automaticamente em um arquivo .diagsession .

O caminho para as ferramentas de criação de perfil é Microsoft Visual Studio\version\Enterprise\Team Tools\DiagnosticsHub\Collector.

Observação

Para usar as ferramentas de linha de comando do criador de perfil, você deve usar o Prompt de Comando do Desenvolvedor do Visual Studio ou adicionar o caminho das ferramentas à variável de ambiente PATH da janela do Prompt de Comando.

Instrumento com VSInstr

Para instrumentar um componente nativo, como um C++ .exe ou .dll arquivo executado:

VSInstr /d:new ModuleToProfile.dll

Opcionalmente, você pode passar /EXCLUDESMALLFUNCS para excluir pequenas funções da instrumentação, reduzindo a sobrecarga da ferramenta e fornecendo resultados mais precisos.

Observação

A partir do Visual Studio 17.11 Preview 3, o /d:new sinalizador não é necessário porque é definido por padrão.