Visualizar contadores Dotnet a partir do perfilador do Visual Studio

A ferramenta Contadores .NET permite visualizar contadores do .NET ao longo do tempo diretamente no perfilador do Visual Studio.

Observação

A Ferramenta de Contadores .NET requer o Visual Studio 2019, versão 16.7 ou superior, e é direcionada ao .NET Core 3.0+ e ao .NET 5+.

Para obter informações adicionais sobre como aprender a usar a ferramenta Contadores .NET de forma eficaz, consulte Estudo de caso: isolar um problema de desempenho.

Configuração

  1. No projeto do Visual Studio, defina a configuração da solução como Release e selecione o destino de implantação.

    O destino de implantação normalmente corresponde ao nome do projeto, indicando uma implantação local.

  2. Abra o Performance Profiler (Alt + F2 ou Debug -> Performance Profiler) no Visual Studio.

  3. Marque a caixa de seleção Contadores .NET.

    Captura de ecrã da ferramenta Contadores em Visual Studio selecionado.

    Captura de ecrã da ferramenta Counters selecionada.

  4. Clique no botão Iniciar para executar a ferramenta.

Para obter mais informações sobre como otimizar o desempenho da ferramenta, consulte Otimizando as configurações do Profiler.

Compreender os seus dados

Embora a ferramenta esteja inicialmente coletando dados, você pode ver os valores em tempo real de contadores de dotnet.

Captura de ecrã dos valores em tempo real recolhidos pela ferramenta dotnet Counter em Visual Studio.

Captura de ecrã da ferramenta dotnet Counter a recolher dados.

Você também pode visualizar gráficos dos contadores marcando a caixa de seleção ao lado dos nomes dos contadores. Você pode exibir os gráficos de vários contadores ao mesmo tempo.

Depois de terminar de exercitar seu aplicativo e coletar dados, você pode interromper a coleta para obter um relatório ainda mais detalhado. Para fazer isso, pressione o botão Stop Collection.

Quando o relatório for carregado, você verá um relatório finalizado semelhante ao mostrado abaixo.

Captura de ecrã do relatório final da ferramenta Contador em Visual Studio.

Captura de ecrã do relatório final da ferramenta Counter.

O relatório mostra os seguintes valores:

  • Min - O valor mínimo para esse contador no intervalo de tempo selecionado.
  • Max - O valor máximo para esse contador no intervalo de tempo selecionado.
  • Média - O valor médio desse contador no intervalo de tempo selecionado.

Você pode filtrar ou adicionar colunas na tabela clicando com o botão direito do mouse nos cabeçalhos das colunas e selecionando um título.

Captura de ecrã das colunas da ferramenta Contador em Visual Studio.

Captura de ecrã das colunas da ferramenta Counter.

Você pode também visualizar gráficos no relatório detalhado marcando as caixas de seleção ao lado dos contadores. Os dados nas tabelas representam os valores de toda a duração do rastreio recolhido por padrão. Para filtrar os dados para um intervalo de tempo específico, clique e arraste nos gráficos.

Captura de ecrã da filtragem de tempo na ferramenta Counter no Visual Studio.

Captura de ecrã da filtragem por tempo da ferramenta Counter.

A tabela é atualizada para valores relevantes para o tempo selecionado nos gráficos. Utilize o botão Limpar Seleção para redefinir o intervalo de tempo selecionado para todo o traço.

Exibir dados do contador do .NET Meter

A partir da versão 17.8 do Visual Studio 2022, a ferramenta Contadores do .NET oferece suporte à integração com a API do .NET Meter, adicionando suporte para opções de instrumentos, como Counter e ObservableCounter.

O Counter regista a mudança de um valor ao longo do tempo, com o chamador a relatar atualizações usando Counter.Add. Em contraste, ObservableCounter é semelhante a Counter, mas o chamador se encarrega de manter o controle do valor total. A ferramenta .NET Counters relata a taxa de variação do total.

Para obter mais informações, consulte Criação de métricas.

Exibir dados de histograma do .NET Meter

A partir da versão 17.12 Preview 2 do Visual Studio 2022, a ferramenta Contadores do .NET oferece suporte à integração do histograma Meter do .NET.

O Histograma do Medidor .NET permite identificar e analisar dados de histograma gerados por instrumentos de histograma .NET, gravados usando CreateHistogram. Ao registrar dados usando o instrumento de histograma, os resultados são visualizados, fornecendo uma representação clara da distribuição dos dados.

Os dados do histograma em tempo real são mostrados junto com os outros contadores, sob o nome da instância do medidor.

Para abrir o gráfico de histograma, selecione o nome do instrumento na instância do Medidor, como ilustrado aqui.

Contadores .NET medidor de dados de histograma.

No exemplo anterior, a ferramenta mostra dados para os percentis 50, 90 e 95 das medições registradas.

Conteúdo relacionado

  • Last updated on