ASP.NET Core métricas integradas

Este artículo es el punto de entrada de las métricas integradas que ASP.NET Core genera mediante la System.Diagnostics.Metrics API. La referencia de métricas se organiza en páginas centradas por tema. Use las páginas siguientes para buscar los instrumentos, atributos e instrucciones de uso de cada área. Para obtener una lista de métricas basadas en la API EventCounters anterior, consulte Contadores disponibles.

Para obtener información sobre cómo recopilar, notificar, enriquecer y probar con métricas de ASP.NET Core, consulte ASP.NET Core métricas.

Note

A partir de .NET 11, los medidores de servidor HTTP integrados catalogados en estas páginas de referencia (especialmente Microsoft.AspNetCore.Hosting y Microsoft.AspNetCore.Server.Kestrel) emiten datos compatibles con las partes necesarias de las convenciones semánticas del servidor HTTP de OpenTelemetry. El OpenTelemetry.Instrumentation.AspNetCore paquete es opcional para las métricas del servidor HTTP: registre estos medidores directamente con el SDK de OpenTelemetry. Para obtener más información, consulta métricas de ASP.NET Core.

Páginas de referencia de métricas

Página Espacios de nombres Métricas de ejemplo
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_connections, signalr.server.active_connections
Métricas de diagnóstico Microsoft.AspNetCore.Diagnostics aspnetcore.diagnostics.exceptions
Blazor (Componentes) métricas Microsoft.AspNetCore.Components, , Microsoft.AspNetCore.Components.Lifecycle, Microsoft.AspNetCore.Components.Server.Circuits aspnetcore.components.navigation, aspnetcore.components.circuit.active
Métricas de autenticación y autorización Microsoft.AspNetCore.Authorization, Microsoft.AspNetCore.Authentication aspnetcore.authorization.attempts, aspnetcore.authentication.challenges

Las Blazor páginas (Componentes) y métricas de autenticación y autorización describen las métricas disponibles en ASP.NET Core 10.0 o posterior. Seleccione ASP.NET Core 10.0 (o una versión posterior) con el selector de versiones para ver ese contenido.

Cómo se agrupan las métricas

Las métricas se agrupan por audiencia y tema. Dado que algunos espacios de nombres no se asignan limpiamente a un solo tema, se aplican las siguientes reglas de selección de ubicación:

  • El control de solicitudes HTTP, el enrutamiento, la limitación de velocidad, el análisis de encabezados, el Kestrel servidor web y SignalR (Microsoft.AspNetCore.Http.Connections) se agrupan en la página de métricas HTTP, ya que todos se relacionan con el servicio de conexiones HTTP y en tiempo real.
  • Las métricas de middleware de control de errores se encuentran en la página métricas de diagnóstico.
  • Blazor (Componentes) las métricas se agrupan por sus espacios de nombres de componente, ciclo de vida y circuito de servidor.
  • La autenticación, la autorización y Identity las métricas se agrupan como métricas relacionadas con la seguridad.

Cómo leer esta referencia

Cada métrica de las páginas de referencia se documenta con la siguiente información:

  • Nombre: el nombre de la métrica (instrumento).
  • Tipo de instrumento: el tipo de instrumento, como Counter, UpDownCountero Histogram.
  • Unidad (UCUM): la unidad de medida, expresada mediante el código unificado para unidades de medida (UCUM), por ejemplo s , durante segundos.
  • Atributo: las dimensiones (etiquetas) notificadas con la métrica.
  • Presencia: cuando el atributo está presente, por ejemplo Always o solo en condiciones específicas.
  • Uso: preguntas de ejemplo que la métrica ayuda a responder.

Para obtener instrucciones sobre cómo recopilar, notificar, enriquecer y probar con estas métricas, consulte ASP.NET Core métricas.

  • Last updated on