Compartilhar via


Visualizar contadores dotnet do criador de perfil do Visual Studio

A ferramenta Contadores do .NET permite visualizar contadores dotnet ao longo do tempo diretamente de dentro do criador de perfil do Visual Studio.

Nota

A ferramenta Contadores do .NET requer o Visual Studio 2019 versão 16.7 ou posterior e tem como destino o .NET Core 3.0+ e o .NET 5+.

Para obter informações adicionais sobre como aprender a usar a ferramenta Contadores do .NET com eficiência, consulte Estudo de caso: isolar um problema de desempenho.

Configuração

  1. Abra o Criador de Perfil de Desempenho (Alt + F2 ou Depurar -> Criador de Perfil de Desempenho) no Visual Studio.

  2. Marque a caixa de seleção Contadores do .NET.

    Ferramenta Contadores selecionada.

  3. 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 Criador de Perfil.

Entender seus dados

Embora a ferramenta esteja coletando dados inicialmente, você pode ver os valores dinâmicos dos contadores dotnet.

Coleta da ferramenta de Contador do .NET.

Você também pode exibir grafos dos contadores selecionando a caixa de seleção ao lado dos nomes dos contadores. É possível exibir os grafos de vários contadores por vez.

Depois de terminar de testar seu aplicativo e coletar dados, você pode interromper a coleta para gerar um relatório ainda mais detalhado. Para isso, pressione o botão Parar Coleta.

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

relatório da ferramenta .NET Counter.

O relatório mostra os seguintes valores:

  • Min – O valor mínimo para esse contador no intervalo de tempo selecionado.
  • Máximo – 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 títulos da coluna e selecionando um título.

colunas de ferramentas do .NET Counter.

Exiba também grafos 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 rastreamento coletado por padrão. Para filtrar os dados para um intervalo de tempo específico, clique e arraste os grafos.

Filtragem de tempo da ferramenta de Contadores do .NET.

A tabela é atualizada para valores relevantes para o tempo selecionado nos grafos. Use o botão Limpar Seleção para redefinir o intervalo de tempo selecionado para todo o rastreamento.

Exibir dados do contador do Medidor do .NET

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

O Counter acompanha a variação de um valor ao longo do tempo, com o chamador relatando atualizações usando Counter.Add. Por outro lado, ObservableCounter é semelhante a Counter, mas é responsabilidade do chamador manter o controle do valor total. A ferramenta Contadores do .NET relata a taxa de alteração total.

Para obter mais informações, consulte Criando métricas.

Exibir dados do histograma do .NET Meter

A partir do Visual Studio 2022 versão 17.12 Versão prévia 2, a ferramenta .NET Counters dá suporte à integração do .NET Meter Histogram.

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

Os dados de histograma dinâmicos são mostrados com o restante dos contadores, sob o nome da instância do Medidor.

Para abrir o gráfico de histograma, selecione o nome do instrumento para a instância do medidor, como mostrado aqui.

Dados de histograma de medidor de Contadores do .NET.

No exemplo anterior, a ferramenta mostra dados dos percentis 50, 90 e 95 das medidas registradas.