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
Abra o Performance Profiler (Alt + F2 ou Debug -> Performance Profiler) no Visual Studio.
Marque a caixa de seleção Contadores .NET.
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.
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.
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.
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.
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.
No exemplo anterior, a ferramenta mostra dados para os percentis 50, 90 e 95 das medições registradas.