Partilhar via


Instrumentar seu aplicativo .NET no Visual Studio (C#, C++, Visual Basic, F#)

Com o lançamento do Visual Studio 2022 versão 17.5, você pode usar a nova ferramenta Instrumentação dinâmica. Essa ferramenta mostra o número exato de vezes que suas funções são chamadas e é mais rápida do que a versão anterior da ferramenta Instrumentação. Ela dá suporte à instrumentação do .NET Core sem a necessidade de PDBs. A partir do Visual Studio 2022 versão 17.6 Versão Prévia 2, a ferramenta também dá suporte a C/C++.

A ferramenta é semelhante à ferramenta Uso da CPU, exceto que se baseia no tempo real decorrido em vez de na utilização da CPU. Para obter informações adicionais sobre como aprender a usar a ferramenta Instrumentação de maneira efetiva, consulte Visão geral da instrumentação e Aprimorando o desempenho do Visual Studio com a nova ferramenta de instrumentação.

Instrumentar seu aplicativo

  1. Selecione Alt+F2 (ou Depurar > Criador de Perfil de Desempenho) para abrir o criador de perfil de desempenho no Visual Studio.

  2. Marque a caixa de seleção Instrumentação.

    Captura de tela mostrando a ferramenta Instrumentação selecionada.

    Se você habilitar a opção Iniciar com a coleção em pausa antes de iniciar o criador de perfil, os dados não serão coletados até que você selecione o botão Gravar na exibição da sessão de diagnóstico.

    Observação

    Se a ferramenta não estiver disponível para seleção, desmarque a caixa de seleção de todas as outras ferramentas, pois algumas ferramentas precisam ser executadas sozinhas. Para saber mais sobre como executar ferramentas em conjunto, consulte Usando várias ferramentas de criação de perfil simultaneamente.

    Se a ferramenta ainda não estiver disponível, verifique se o projeto atende aos requisitos anteriores. Verifique se o projeto está no modo Versão para capturar os dados mais precisos.

  3. Selecione o botão Iniciar para executar a ferramenta.

  4. Selecione os itens no programa para instrumentar.

    Captura de tela mostrando a caixa de diálogo Selecionar itens para instrumentar.

    A partir do Visual Studio 2022 versão 17.11 Versão Prévia 1, o criador de perfil mantém os itens selecionados para a próxima execução de criação de perfil.

  5. Selecione OK.

  6. Após a ferramenta começar a ser executada, percorra o cenário cujo perfil você deseja criar em seu aplicativo. Em seguida, selecione Parar coleta ou feche o aplicativo para ver seus dados.

Analisar o relatório de Instrumentação

Seus dados de criação de perfil são exibidos no Visual Studio.

Captura de tela mostrando os dados de Instrumentação do .NET.

A exibição de dados de Instrumentação mostra uma lista de funções ordenadas pela execução mais prolongada, com a função no topo em Principais Funções. A seção Caminho Crítico mostra a pilha de chamadas para as funções que estão usando mais tempos. Essas listas podem ajudar a levar você para funções em que estão ocorrendo gargalos de desempenho.

Clique em uma função de seu interesse e você obterá uma exibição mais detalhada.

As informações disponíveis são semelhantes às da ferramenta Uso da CPU, exceto que se baseiam no tempo real decorrido e na contagem de chamadas, em vez de na utilização da CPU. Isso significa que o tempo bloqueado, por exemplo, o tempo gasto aguardando bloqueios, aparecerá no rastreamento de instrumentação, ao contrário do que ocorre com a ferramenta Uso da CPU. Para obter informações detalhadas sobre os modos de exibição, consulte Analisar o desempenho usando a criação de perfil da CPU.