Demonstra Passo a passo: Linha de comando usando a instrumentação de criação de perfil

Esta explicação passo a passo leva você através da criação de perfil um .NET Framework um aplicativo autônomo detalhada de temporização de coletar e chamar a contagem de dados usando o método de instrumentação de ferramentas de criação de perfil. Esta explicação passo a passo, você irá realizar as seguintes tarefas:

• Use o VSInstr ferramenta de linha de comando para gerar binários instrumentados.

• Use o a ferramentaVSPerfCLREnv para definir as variáveis de ambiente para coletar.NET para criação de perfil de dados.

• Use o VSPerfCmd ferramenta para coletar dados de criação de perfil.

• Use o VSPerfReport ferramenta para gerar relatórios de arquivo de dados de criação de perfil.

Pré-requisitos

• Visual Studio Application Lifecycle Management

• Compreensão intermediária das C#

• Intermediários de compreensão de como trabalhar com ferramentas de linha de comando

• Uma cópia doExemplo PeopleTrax (ferramentas de perfilação)

• Para trabalhar com as informações fornecidas pelo perfil, é melhor ter informações de símbolo disponíveis de depuração. Para obter mais informações, consulte Como: Informações de referência do símbolo de Windows.

Usando o método de instrumentação de perfil de linha de comando

Instrumentação é um método de perfilação pelo qual o especialmente projetadas versões dos binários do perfil contêm funções de teste que coletam informações de temporização na entrada e saída para funções em um módulo instrumentado. Porque esse método de criação de perfil é mais invasivo do que a amostragem, ele gera uma quantidade maior de sobrecarga. Binários instrumentados também são maiores do que o debug ou release binários e não são destinados a implantação.

Observação
Não envie binários instrumentados para seus clientes. Binários instrumentados podem conter vários riscos. Os binários incluem informações que facilita o seu aplicativo para engenharia reversa, bem como os riscos de segurança.

Para criar o perfil de aplicativo PeopleTrax usando o método de instrumentação

1. Instalar o aplicativo de exemplo PeopleTrax e cria a versão de lançamento.

2. Abra uma janela de prompt de comando e adicionar o Ferramentas de criação de perfil diretório para a variável de ambiente do caminho local.

3. Altere o diretório de trabalho para o diretório que contém os binários do PeopleTrax.

4. Crie um diretório para conter os relatórios baseada em arquivo. Digite o seguinte comando:

   md Reports
   

5. Use a ferramenta de linha de comando VSInstr instrumentar binários no aplicativo. Digite os seguintes comandos em linhas separadas do comando:

   VSInstr PeopleTrax.exe
   VSInstr PeopleTrax.exe
   VSInstr People.dll
   VSInstr Person.dll
   VSInstr Operation.dll
   

   Nota por padrão, VSInstr salva o backup do arquivo original não instrumentado. O nome do arquivo de backup tem a extensão. orig. Por exemplo, a versão original do "MyApp. exe" seriam salvos como "MyApp.exe.orig".

6. Digite o seguinte comando para definir as variáveis de ambiente apropriado:

   VsPerfCLREnv /traceon
   

7. Para iniciar o profiler, digite o seguinte comando:

   VsPerfCmd /start:trace /output:Reports\Report.vsp
   

8. Após iniciar o profiler no modo de rastreamento, execute a versão de instrumentado do processo de PeopleTrax.exe para coletar dados.

   O PeopleTrax janela do aplicativo é exibida.

9. Clique em obter pessoas.

   A grade de dados de PeopleTrax é preenchida com dados.

10. Clique em Exportar dados.

    O bloco de notas é iniciado e exibe um novo arquivo que contém uma lista de pessoas a partir de PeopleTrax aplicativo.

11. Feche o bloco de notas e feche o PeopleTrax aplicativo.

12. Desligar o profiler. Digite o seguinte comando:

    VSPerfCmd /shutdown
    

13. Digite o seguinte comando para redefinir as variáveis ambientais:

    VSPerfCLREnv /off
    

14. Use a ferramenta do VSPerfReport para gerar ou arquivos de relatório de valores separados por ponto-e-vírgula (. csv). Tipo:

    VSPerfReport Reports\Report.vsp /output:Reports /summary:all
    

    Você pode analisar os relatórios gerados em um programa de planilha, ou você pode usar o Visual Studio IDE para analisar os dados de criação de perfil no arquivo Report.vsp. Para obter mais informações, consulte Analisando dados de ferramentas de criação de perfil.

Consulte também

Referência

VSPerfCmd

Conceitos

Visão geral de sessão de desempenho de ferramentas de criação de perfil

Usando as ferramentas de criação de perfil na linha de comando

Noções básicas sobre os valores de dados de amostragem em ferramentas de criação de perfil

Outros recursos

Exibições de relatório de ferramentas de criação de perfil