ASP.NET Core métricas internas

Este artigo é o ponto de entrada para as métricas internas que ASP.NET Core produz usando a System.Diagnostics.Metrics API. A referência de métricas é organizada em páginas focadas por tópico. Use as páginas a seguir para localizar os instrumentos, os atributos e as diretrizes de uso para cada área. Para obter uma listagem de métricas com base na API EventCounters mais antiga, consulte contadores disponíveis.

Para obter informações sobre como coletar, relatar, enriquecer e testar com métricas de ASP.NET Core, consulte ASP.NET Core métricas.

Note

A partir do .NET 11, os medidores de servidor HTTP internos catalogados nessas páginas de referência (mais notavelmente Microsoft.AspNetCore.Hosting e Microsoft.AspNetCore.Server.Kestrel) emitem dados em conformidade com as partes necessárias das convenções semânticas do servidor HTTP OpenTelemetry. O OpenTelemetry.Instrumentation.AspNetCore pacote é opcional para métricas de servidor HTTP— registre esses medidores diretamente com o SDK do OpenTelemetry. Para saber mais, confira Métricas do ASP.NET Core

Páginas de referência de métricas

Página Namespaces Métricas de exemplo
Métricas HTTP Microsoft.AspNetCore.Hosting, Microsoft.AspNetCore.Routing, Microsoft.AspNetCore.RateLimiting, Microsoft.AspNetCore.HeaderParsing, , Microsoft.AspNetCore.Http.ConnectionsMicrosoft.AspNetCore.Server.Kestrel(SignalR) http.server.request.duration, aspnetcore.routing.match_attempts, , kestrel.active_connectionssignalr.server.active_connections
Métricas de diagnóstico Microsoft.AspNetCore.Diagnostics aspnetcore.diagnostics.exceptions
Blazor Métricas (componentes) Microsoft.AspNetCore.Components, Microsoft.AspNetCore.Components.Lifecycle, Microsoft.AspNetCore.Components.Server.Circuits aspnetcore.components.navigation, aspnetcore.components.circuit.active
Métricas de autenticação e autorização Microsoft.AspNetCore.Authorization, Microsoft.AspNetCore.Authentication aspnetcore.authorization.attempts, aspnetcore.authentication.challenges

As Blazor páginas de métricas (Componentes) e de autenticação e autorização descrevem as métricas disponíveis no ASP.NET Core 10.0 ou posterior. Selecione ASP.NET Core 10.0 (ou uma versão posterior) com o seletor de versão para exibir esse conteúdo.

Como as métricas são agrupadas

As métricas são agrupadas por audiência e tópico. Como alguns namespaces não são mapeados de forma limpa para um único tópico, as seguintes regras de posicionamento se aplicam:

  • O tratamento de solicitações HTTP, o roteamento, a limitação de taxa, a análise de cabeçalho, o Kestrel servidor Web e SignalR (Microsoft.AspNetCore.Http.Connections) são agrupados na página de métricas HTTP, porque todos eles se relacionam ao serviço de conexões HTTP e em tempo real.
  • As métricas de middleware de tratamento de erro estão na página de métricas de diagnóstico.
  • Blazor As métricas (componentes) são agrupadas por seus namespaces de componente, ciclo de vida e circuito de servidor.
  • Autenticação, autorização e Identity métricas são agrupadas como métricas relacionadas à segurança.

Como ler essa referência

Cada métrica nas páginas de referência é documentada com as seguintes informações:

  • Nome: o nome da métrica (instrumento).
  • Tipo de instrumento: o tipo de instrumento, como Counter, UpDownCounterou Histogram.
  • Unidade (UCUM): a unidade de medida, expressa usando o Código Unificado para Unidades de Medida (UCUM), por exemplo s , por segundos.
  • Atributo: as dimensões (marcas) relatadas com a métrica.
  • Presença: quando o atributo está presente, por exemplo Always ou apenas em condições específicas.
  • Uso: perguntas de exemplo que a métrica ajuda a responder.

Para obter diretrizes sobre como coletar, relatar, enriquecer e testar com essas métricas, consulte ASP.NET Core métricas.

  • Last updated on