Métricas incorporadas do ASP.NET Core

Este artigo é o ponto de entrada para as métricas incorporadas que o ASP.NET Core produz usando a System.Diagnostics.Metrics API. A referência das métricas está organizada em páginas focadas por tema. Use as páginas seguintes para encontrar os instrumentos, atributos e orientações de utilização para cada área. Para obter uma lista de métricas com base na API EventCounters mais antiga, consulte Contadores disponíveis.

Para informações sobre como recolher, reportar, enriquecer e testar com métricas ASP.NET Core, consulte métricas ASP.NET Core.

Note

A partir do .NET 11, os contadores de servidores HTTP incorporados catalogados nestas páginas de referência (mais notavelmente Microsoft.AspNetCore.Hosting e Microsoft.AspNetCore.Server.Kestrel) emitem dados compatíveis com as partes exigidas das convenções semânticas do servidor HTTP do OpenTelemetry. O OpenTelemetry.Instrumentation.AspNetCore pacote é opcional para métricas de servidor HTTP — registar estes contadores diretamente com o SDK OpenTelemetry. Para obter mais informações, consulte ASP.NET Core métricas.

Páginas de referência de métricas

Página Namespaces Métricas de exemplo
Métricas HTTP Microsoft.AspNetCore.Hosting, , , , , (Microsoft.AspNetCore.Http.ConnectionsSignalR) Microsoft.AspNetCore.Server.KestrelMicrosoft.AspNetCore.HeaderParsingMicrosoft.AspNetCore.RateLimitingMicrosoft.AspNetCore.Routing http.server.request.duration, aspnetcore.routing.match_attempts, kestrel.active_connections, signalr.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 (Componentes) e métricas de autenticação e autorização descrevem 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ões para visualizar esse conteúdo.

Como as métricas são agrupadas

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

  • O tratamento de pedidos HTTP, o encaminhamento, a limitação de taxa, a análise de cabeçalhos, o Kestrel servidor web e SignalR (Microsoft.AspNetCore.Http.Connections) estão agrupados na página de métricas HTTP, porque todos se relacionam com o serviço de ligações HTTP e em tempo real.
  • As métricas de middleware de gestão de erros estão na página de métricas de diagnóstico.
  • Blazor As métricas (de componentes) são agrupadas pelos seus espaços de nomes de componentes, ciclo de vida e circuitos de servidor.
  • Autenticação, autorização e Identity métricas estão agrupadas como métricas relacionadas com a segurança.

Como ler esta referência

Cada métrica nas páginas de referência é documentada com a seguinte informação:

  • Nome: O nome métrico (instrumento).
  • Tipo de Instrumento: O tipo de instrumento, como Counter, UpDownCounter, ou Histogram.
  • Unidade (UCUM): A unidade de medida, expressa usando o Código Unificado para Unidades de Medida (UCUM), por exemplo s , para segundos.
  • Atributo: As dimensões (tags) reportadas com a métrica.
  • Presença: Quando o atributo está presente, por exemplo Always ou apenas sob condições específicas.
  • Utilização: Perguntas de exemplo que a métrica ajuda a responder.

Para orientações sobre como recolher, reportar, enriquecer e testar com estas métricas, consulte métricas ASP.NET Core.

  • Last updated on