métricas integradas de ASP.NET Core

En este artículo se describen las métricas integradas para ASP.NET Core generado mediante la System.Diagnostics.Metrics API. 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 métricas de ASP.NET Core.

Métrica: http.server.request.duration

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
http.server.request.duration	Histograma	s	Mide la duración de las solicitudes HTTP entrantes.

Atributo	Tipo	Descripción	Ejemplos	Presencia
http.route	cuerda / cadena	Ruta coincidente.	{controller}/{action}/ {id?}	Si está disponible.
error.type	cuerda / cadena	Describe una clase de error con la que finalizó la operación.	timeout; name_resolution_error; 500	Si la solicitud ha finalizado con un error.
http.request.method	cuerda / cadena	Método de solicitud HTTP.	GET; POST; HEAD	Siempre
http.response.status_code	Int	código de estado de respuesta HTTP.	200	Si se envió uno.
network.protocol.version	cuerda / cadena	Versión del protocolo especificado en network.protocol.name.	3.1.1	Siempre
url.scheme	cuerda / cadena	El esquema de URI componente que identifica el protocolo usado.	http; https	Siempre
aspnetcore.request.is_unhandled	Booleano	True cuando la canalización de la aplicación no controla la solicitud.	true	Si la solicitud no se ha controlado.

El tiempo usado para controlar una solicitud HTTP entrante como se mide en la capa de hospedaje de ASP.NET Core. La medida de tiempo se inicia una vez que el host web subyacente tiene:

• Se analizaron suficientemente los encabezados de solicitud HTTP en el flujo de red entrante para identificar la nueva solicitud.
• Inicializó las estructuras de datos de contexto, como .HttpContext

La hora finaliza cuando:

• La canalización del controlador de ASP.NET Core ha terminado de ejecutarse.
• Se han enviado todos los datos de respuesta.
• Se eliminan las estructuras de datos de contexto de la solicitud.

Cuando se usa OpenTelemetry, los cubos predeterminados para esta métrica se establecen en [ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10 ].

Métrica: http.server.active_requests

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
http.server.active_requests	UpDownCounter	{request}	Mide el número de solicitudes HTTP simultáneas que están actualmente en curso.

Atributo	Tipo	Descripción	Ejemplos	Presencia
http.request.method	cuerda / cadena	Método de solicitud HTTP. [1]	GET; POST; HEAD	Siempre
url.scheme	cuerda / cadena	El esquema de URI componente que identifica el protocolo usado.	http; https	Siempre

Microsoft.AspNetCore.Routing

La Microsoft.AspNetCore.Routing información del informe de métricas sobre el enrutamiento de solicitudes HTTP a ASP.NET puntos de conexión principales:

• aspnetcore.routing.match_attempts

Métrica: aspnetcore.routing.match_attempts

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
aspnetcore.routing.match_attempts	Contador	{match_attempt}	Número de solicitudes que se intentaron coincidir con un punto de conexión.

Atributo	Tipo	Descripción	Ejemplos	Presencia
aspnetcore.routing.match_status	cuerda / cadena	Resultado de coincidencia	success; failure	Siempre
aspnetcore.routing.is_fallback_route	booleano	Valor que indica si la ruta coincidente es una ruta de reserva.	True	Si una ruta coincide correctamente.
http.route	cuerda / cadena	Ruta coincidente	{controller}/{action}/ {id?}	Si una ruta coincide correctamente.

Microsoft.AspNetCore.Diagnostics

La Microsoft.AspNetCore.Diagnostics información de diagnóstico de métricas del middleware de control de errores de ASP.NET Core:

• aspnetcore.diagnostics.exceptions

Métrica: aspnetcore.diagnostics.exceptions

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
aspnetcore.diagnostics.exceptions	Contador	{exception}	Número de excepciones detectadas por el middleware de control de excepciones.

Atributo	Tipo	Descripción	Ejemplos	Presencia
aspnetcore.diagnostics.exception.result	cuerda / cadena	ASP.NET resultado del control del middleware de excepciones de Core	handled; unhandled	Siempre
aspnetcore.diagnostics.handler.type	cuerda / cadena	Nombre de tipo completo de la IExceptionHandler implementación que controló la excepción.	Contoso.MyHandler	Si este controlador controló la excepción.
exception.type	cuerda / cadena	Nombre completo del tipo de excepción.	System.OperationCanceledException; Contoso.MyException	Siempre

Microsoft.AspNetCore.RateLimiting

La Microsoft.AspNetCore.RateLimiting información de limitación de velocidad del informe de métricas de ASP.NET middleware de limitación de velocidad core:

• aspnetcore.rate_limiting.active_request_leases
• aspnetcore.rate_limiting.request_lease.duration
• aspnetcore.rate_limiting.queued_requests
• aspnetcore.rate_limiting.request.time_in_queue
• aspnetcore.rate_limiting.requests

Métrica: aspnetcore.rate_limiting.active_request_leases

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
aspnetcore.rate_limiting.active_request_leases	UpDownCounter	{request}	Número de solicitudes que están activas actualmente en el servidor que contienen una concesión de limitación de velocidad.

Atributo	Tipo	Descripción	Ejemplos	Presencia
aspnetcore.rate_limiting.policy	cuerda / cadena	Nombre de directiva de limitación de velocidad.	fixed; sliding; token	Si el punto de conexión coincidente de la solicitud tenía una directiva de limitación de velocidad.

Métrica: aspnetcore.rate_limiting.request_lease.duration

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
aspnetcore.rate_limiting.request_lease.duration	Histograma	s	Duración de la concesión de limitación de velocidad mantenida por las solicitudes en el servidor.

Atributo	Tipo	Descripción	Ejemplos	Presencia
aspnetcore.rate_limiting.policy	cuerda / cadena	Nombre de directiva de limitación de velocidad.	fixed; sliding; token	Si el punto de conexión coincidente de la solicitud tenía una directiva de limitación de velocidad.

Métrica: aspnetcore.rate_limiting.queued_requests

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
aspnetcore.rate_limiting.queued_requests	UpDownCounter	{request}	Número de solicitudes en cola que están actualmente en cola para adquirir una concesión de limitación de velocidad.

Atributo	Tipo	Descripción	Ejemplos	Presencia
aspnetcore.rate_limiting.policy	cuerda / cadena	Nombre de directiva de limitación de velocidad.	fixed; sliding; token	Si el punto de conexión coincidente de la solicitud tenía una directiva de limitación de velocidad.

Métrica: aspnetcore.rate_limiting.request.time_in_queue

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
aspnetcore.rate_limiting.request.time_in_queue	Histograma	s	El tiempo que una solicitud pasó en una cola en espera de adquirir una concesión de limitación de velocidad.

Atributo	Tipo	Descripción	Ejemplos	Presencia
aspnetcore.rate_limiting.policy	cuerda / cadena	Nombre de directiva de limitación de velocidad.	fixed; sliding; token	Si el punto de conexión coincidente de la solicitud tenía una directiva de limitación de velocidad.
aspnetcore.rate_limiting.result	cuerda / cadena	El resultado de limitación de velocidad muestra si se adquirió la concesión o contiene un motivo de rechazo.	acquired; request_canceled	Siempre

Métrica: aspnetcore.rate_limiting.requests

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
aspnetcore.rate_limiting.requests	Contador	{request}	Número de solicitudes que intentaron adquirir una concesión de limitación de velocidad.

Atributo	Tipo	Descripción	Ejemplos	Presencia
aspnetcore.rate_limiting.policy	cuerda / cadena	Nombre de directiva de limitación de velocidad.	fixed; sliding; token	Si el punto de conexión coincidente de la solicitud tenía una directiva de limitación de velocidad.
aspnetcore.rate_limiting.result	cuerda / cadena	El resultado de limitación de velocidad muestra si se adquirió la concesión o contiene un motivo de rechazo.	acquired; request_canceled	Siempre

Microsoft.AspNetCore.HeaderParsing

La Microsoft.AspNetCore.HeaderParsing información del informe de métricas sobre el análisis de encabezados de ASP.NET Core:

• aspnetcore.header_parsing.parse_errors
• aspnetcore.header_parsing.cache_accesses

Métrica: aspnetcore.header_parsing.parse_errors

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
aspnetcore.header_parsing.parse_errors	Contador	{parse_error}	Número de errores que se produjeron al analizar encabezados de solicitud HTTP.

Atributo	Tipo	Descripción	Ejemplos	Presencia
aspnetcore.header_parsing.header.name	cuerda / cadena	Nombre del encabezado.	Content-Type	Siempre
error.type	cuerda / cadena	Mensaje de error.	Unable to parse media type value.	Siempre

Métrica: aspnetcore.header_parsing.cache_accesses

La métrica solo se emite para analizadores de encabezados de solicitud HTTP que admiten el almacenamiento en caché.

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
aspnetcore.header_parsing.cache_accesses	Contador	{cache_access}	Número de veces que se ha accedido a una memoria caché que almacena valores de encabezado analizados.

Atributo	Tipo	Descripción	Ejemplos	Presencia
aspnetcore.header_parsing.header.name	cuerda / cadena	Nombre del encabezado.	Content-Type	Siempre
aspnetcore.header_parsing.cache_access.type	cuerda / cadena	Valor que indica si el valor del encabezado se encontró en la memoria caché o no.	Hit; Miss	Siempre

Microsoft.AspNetCore.Server.Kestrel

Las Microsoft.AspNetCore.Server.Kestrel métricas informan de la información de conexión HTTP del servidor web de ASP.NET CoreKestrel:

• kestrel.active_connections
• kestrel.connection.duration
• kestrel.rejected_connections
• kestrel.queued_connections
• kestrel.queued_requests
• kestrel.upgraded_connections
• kestrel.tls_handshake.duration
• kestrel.active_tls_handshakes

Métrica: kestrel.active_connections

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
kestrel.active_connections	UpDownCounter	{connection}	Número de conexiones que están activas actualmente en el servidor.

Atributo	Tipo	Descripción	Ejemplos	Presencia
network.transport	cuerda / cadena	de capa de transporte OSI o método de comunicación entre procesos.	tcp; unix	Siempre
network.type	cuerda / cadena	capa de red OSI o equivalente que no sea OSI.	ipv4; ipv6	Si el transporte es tcp o udp.
server.address	cuerda / cadena	Nombre de dominio de dirección del servidor si está disponible sin búsqueda inversa de DNS; De lo contrario, la dirección IP o el nombre del socket de dominio de Unix.	example.com	Siempre
server.port	Int	Número de puerto del servidor	80; 8080; 443	Si el transporte es tcp o udp.

Métrica: kestrel.connection.duration

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
kestrel.connection.duration	Histograma	s	Duración de las conexiones en el servidor.

Atributo	Tipo	Descripción	Ejemplos	Presencia
error.type	cuerda / cadena	Describe un tipo de error con el que finalizó la conexión o el tipo de excepción no controlado que se produjo durante la canalización de conexión. Los errores de conexión conocidos se pueden encontrar en Convenciones semánticas para Kestrel las métricas del servidor web.	connection_reset; invalid_request_headers; System.OperationCanceledException	Si la conexión finalizó con un error conocido o se produjo una excepción.
network.protocol.name	cuerda / cadena	Capa de aplicación OSI o equivalente que no es de OSI.	http; web_sockets	Siempre
network.protocol.version	cuerda / cadena	Versión del protocolo especificado en network.protocol.name.	1.1; 2	Siempre
network.transport	cuerda / cadena	de capa de transporte OSI o método de comunicación entre procesos.	tcp; unix	Siempre
network.type	cuerda / cadena	capa de red OSI o equivalente que no sea OSI.	ipv4; ipv6	Si el transporte es tcp o udp.
server.address	cuerda / cadena	Nombre de dominio de dirección del servidor si está disponible sin búsqueda inversa de DNS; De lo contrario, la dirección IP o el nombre del socket de dominio de Unix.	example.com	Siempre
server.port	Int	Número de puerto del servidor	80; 8080; 443	Si el transporte es tcp o udp.
tls.protocol.version	cuerda / cadena	Versión del protocolo TLS.	1.2; 1.3	Si la conexión está protegida con TLS.

Dado que esta métrica realiza un seguimiento de la duración de la conexión y, idealmente, las conexiones HTTP se usan para varias solicitudes, los cubos deben ser más largos que los usados durante las solicitudes. Por ejemplo, el uso de [ 0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 30, 60, 120, 300] proporciona un cubo superior de 5 minutos.

Cuando una conexión finaliza con un error conocido, el valor del error.type atributo se establece en el tipo de error conocido. Los errores de conexión conocidos se pueden encontrar en Convenciones semánticas para Kestrel las métricas del servidor web.

Métrica: kestrel.rejected_connections

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
kestrel.rejected_connections	Contador	{connection}	Número de conexiones rechazadas por el servidor.

Atributo	Tipo	Descripción	Ejemplos	Presencia
network.transport	cuerda / cadena	de capa de transporte OSI o método de comunicación entre procesos.	tcp; unix	Siempre
network.type	cuerda / cadena	capa de red OSI o equivalente que no sea OSI.	ipv4; ipv6	Si el transporte es tcp o udp.
server.address	cuerda / cadena	Nombre de dominio de dirección del servidor si está disponible sin búsqueda inversa de DNS; De lo contrario, la dirección IP o el nombre del socket de dominio de Unix.	example.com	Siempre
server.port	Int	Número de puerto del servidor	80; 8080; 443	Si el transporte es tcp o udp.

Las conexiones se rechazan cuando el recuento activo supera el valor configurado con MaxConcurrentConnections.

Métrica: kestrel.queued_connections

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
kestrel.queued_connections	UpDownCounter	{connection}	Número de conexiones que están actualmente en cola y que están esperando iniciarse.

Atributo	Tipo	Descripción	Ejemplos	Presencia
network.transport	cuerda / cadena	de capa de transporte OSI o método de comunicación entre procesos.	tcp; unix	Siempre
network.type	cuerda / cadena	capa de red OSI o equivalente que no sea OSI.	ipv4; ipv6	Si el transporte es tcp o udp.
server.address	cuerda / cadena	Nombre de dominio de dirección del servidor si está disponible sin búsqueda inversa de DNS; De lo contrario, la dirección IP o el nombre del socket de dominio de Unix.	example.com	Siempre
server.port	Int	Número de puerto del servidor	80; 8080; 443	Si el transporte es tcp o udp.

Métrica: kestrel.queued_requests

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
kestrel.queued_requests	UpDownCounter	{request}	Número de solicitudes HTTP en conexiones multiplexadas (HTTP/2 y HTTP/3) que están actualmente en cola y que están esperando iniciarse.

Atributo	Tipo	Descripción	Ejemplos	Presencia
network.protocol.name	cuerda / cadena	Capa de aplicación OSI o equivalente que no es de OSI.	http; web_sockets	Siempre
network.protocol.version	cuerda / cadena	Versión del protocolo especificado en network.protocol.name.	1.1; 2	Siempre
network.transport	cuerda / cadena	de capa de transporte OSI o método de comunicación entre procesos.	tcp; unix	Siempre
network.type	cuerda / cadena	capa de red OSI o equivalente que no sea OSI.	ipv4; ipv6	Si el transporte es tcp o udp.
server.address	cuerda / cadena	Nombre de dominio de dirección del servidor si está disponible sin búsqueda inversa de DNS; De lo contrario, la dirección IP o el nombre del socket de dominio de Unix.	example.com	Siempre
server.port	Int	Número de puerto del servidor	80; 8080; 443	Si el transporte es tcp o udp.

Métrica: kestrel.upgraded_connections

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
kestrel.upgraded_connections	UpDownCounter	{connection}	Número de conexiones que se actualizan actualmente (WebSockets).

Atributo	Tipo	Descripción	Ejemplos	Presencia
network.transport	cuerda / cadena	de capa de transporte OSI o método de comunicación entre procesos.	tcp; unix	Siempre
network.type	cuerda / cadena	capa de red OSI o equivalente que no sea OSI.	ipv4; ipv6	Si el transporte es tcp o udp.
server.address	cuerda / cadena	Nombre de dominio de dirección del servidor si está disponible sin búsqueda inversa de DNS; De lo contrario, la dirección IP o el nombre del socket de dominio de Unix.	example.com	Siempre
server.port	Int	Número de puerto del servidor	80; 8080; 443	Si el transporte es tcp o udp.

El contador solo realiza un seguimiento de las conexiones HTTP/1.1.

Métrica: kestrel.tls_handshake.duration

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
kestrel.tls_handshake.duration	Histograma	s	Duración de los protocolos de enlace TLS en el servidor.

Atributo	Tipo	Descripción	Ejemplos	Presencia
error.type	cuerda / cadena	Nombre completo del tipo de excepción.	System.OperationCanceledException; Contoso.MyException	Si se produjo una excepción.
network.transport	cuerda / cadena	de capa de transporte OSI o método de comunicación entre procesos.	tcp; unix	Siempre
network.type	cuerda / cadena	capa de red OSI o equivalente que no sea OSI.	ipv4; ipv6	Si el transporte es tcp o udp.
server.address	cuerda / cadena	Nombre de dominio de dirección del servidor si está disponible sin búsqueda inversa de DNS; De lo contrario, la dirección IP o el nombre del socket de dominio de Unix.	example.com	Siempre
server.port	Int	Número de puerto del servidor	80; 8080; 443	Si el transporte es tcp o udp.
tls.protocol.version	cuerda / cadena	Versión del protocolo TLS.	1.2; 1.3	Si la conexión está protegida con TLS.

Cuando se usa OpenTelemetry, los cubos predeterminados para este metic se establecen en [ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10 ].

Métrica: kestrel.active_tls_handshakes

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
kestrel.active_tls_handshakes	UpDownCounter	{handshake}	Número de protocolos de enlace TLS que están actualmente en curso en el servidor.

Atributo	Tipo	Descripción	Ejemplos	Presencia
network.transport	cuerda / cadena	de capa de transporte OSI o método de comunicación entre procesos.	tcp; unix	Siempre
network.type	cuerda / cadena	capa de red OSI o equivalente que no sea OSI.	ipv4; ipv6	Si el transporte es tcp o udp.
server.address	cuerda / cadena	Nombre de dominio de dirección del servidor si está disponible sin búsqueda inversa de DNS; De lo contrario, la dirección IP o el nombre del socket de dominio de Unix.	example.com	Siempre
server.port	Int	Número de puerto del servidor	80; 8080; 443	Si el transporte es tcp o udp.

Microsoft.AspNetCore.Http.Connections

La Microsoft.AspNetCore.Http.Connections información de conexión del informe de métricas de ASP.NET Core SignalR:

• signalr.server.connection.duration
• signalr.server.active_connections

Métrica: signalr.server.connection.duration

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
signalr.server.connection.duration	Histograma	s	Duración de las conexiones en el servidor.

Atributo	Tipo	Descripción	Ejemplos	Presencia
signalr.connection.status	cuerda / cadena	SignalR Estado de cierre de conexión HTTP.	app_shutdown; timeout	Siempre
signalr.transport	cuerda / cadena	SignalR tipo de transporte	web_sockets; long_polling	Siempre

Valor	Descripción
normal_closure	La conexión se cerró normalmente.
timeout	La conexión se cerró debido a un tiempo de espera.
app_shutdown	La conexión se cerró porque la aplicación se apaga.

signalr.transport es uno de los siguientes:

Valor	Descripción
server_sent_events	eventos enviados por el servidor
long_polling	Sondeo largo
web_sockets	WebSocket

Dado que esta métrica realiza un seguimiento de la duración de la conexión y, idealmente SignalR , las conexiones son duraderas, los cubos deben ser más largos que los usados durante las solicitudes. Por ejemplo, el uso de [0, 0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 30, 60, 120, 300] proporciona un cubo superior de 5 minutos.

Métrica: signalr.server.active_connections

Nombre	Tipo de instrumento	Unidad (UCUM)	Descripción
signalr.server.active_connections	UpDownCounter	{connection}	Número de conexiones que están activas actualmente en el servidor.

Atributo	Tipo	Descripción	Ejemplos	Presencia
signalr.connection.status	cuerda / cadena	SignalR Estado de cierre de conexión HTTP.	app_shutdown; timeout	Siempre
signalr.transport	cuerda / cadena	SignalR tipo de transporte	web_sockets; long_polling	Siempre