ASP.NET métriques intégrées Core

Cet article décrit les métriques intégrées pour ASP.NET Core produites à l’aide de l’API System.Diagnostics.Metrics . Pour obtenir la liste des métriques basées sur l’ancienne API EventCounters , consultez Compteurs disponibles.

Pour plus d’informations sur la collecte, le rapport, l’enrichissement et le test avec des métriques ASP.NET Core, consultez ASP.NET Métriques principales.

Métrique : http.server.request.duration

Nom	Type d’instrument	Unité (UCUM)	Descriptif
http.server.request.duration	Histogramme	s	Mesure la durée des requêtes HTTP entrantes.

Attribut	Catégorie	Descriptif	Exemples	Présence
http.route	ficelle	Itinéraire correspondant.	{controller}/{action}/ {id?}	S’il est disponible.
error.type	ficelle	Décrit une classe d’erreur avec qui l’opération s’est terminée.	timeout; name_resolution_error; ; 500	Si la demande s’est terminée avec une erreur.
http.request.method	ficelle	Méthode de requête HTTP.	GET; POST; ; HEAD	Toujours
http.response.status_code	Int	code d’état de réponse HTTP.	200	Si on a été envoyé.
network.protocol.version	ficelle	Version du protocole spécifié dans network.protocol.name.	3.1.1	Toujours
url.scheme	ficelle	Le schéma d’URI composant identifiant le protocole utilisé.	http; https	Toujours
aspnetcore.request.is_unhandled	Booléen	True lorsque la requête n’a pas été gérée par le pipeline d’application.	true	Si la demande n’a pas été gérée.

Temps utilisé pour gérer une requête HTTP entrante mesurée au niveau de la couche d’hébergement de ASP.NET Core. La mesure du temps démarre une fois que l’hôte web sous-jacent a :

• Suffisamment analysé les en-têtes de requête HTTP sur le flux réseau entrant pour identifier la nouvelle requête.
• Initialisé les structures de données de contexte telles que le HttpContext.

L’heure se termine quand :

• Le pipeline de gestionnaire principal ASP.NET est terminé en cours d’exécution.
• Toutes les données de réponse ont été envoyées.
• Les structures de données de contexte pour la requête sont supprimées.

Lorsque vous utilisez OpenTelemetry, les compartiments par défaut de cette métrique sont définis sur [ 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étrique : http.server.active_requests

Nom	Type d’instrument	Unité (UCUM)	Descriptif
http.server.active_requests	UpDownCounter	{request}	Mesure le nombre de requêtes HTTP simultanées actuellement en cours d’exécution.

Attribut	Catégorie	Descriptif	Exemples	Présence
http.request.method	ficelle	Méthode de requête HTTP. [1]	GET; POST; ; HEAD	Toujours
url.scheme	ficelle	Le schéma d’URI composant identifiant le protocole utilisé.	http; https	Toujours

Microsoft.AspNetCore.Routing

Les métriques signalent des informations sur le Microsoft.AspNetCore.Routingroutage des requêtes HTTP vers des points de terminaison principaux ASP.NET :

• aspnetcore.routing.match_attempts

Métrique : aspnetcore.routing.match_attempts

Nom	Type d’instrument	Unité (UCUM)	Descriptif
aspnetcore.routing.match_attempts	Compteur	{match_attempt}	Nombre de demandes qui ont été tentées d’être mises en correspondance avec un point de terminaison.

Attribut	Catégorie	Descriptif	Exemples	Présence
aspnetcore.routing.match_status	ficelle	Résultat de correspondance	success; failure	Toujours
aspnetcore.routing.is_fallback_route	booléen	Valeur qui indique si l’itinéraire correspondant est un itinéraire de secours.	True	Si un itinéraire a été correctement mis en correspondance.
http.route	ficelle	Itinéraire mis en correspondance	{controller}/{action}/ {id?}	Si un itinéraire a été correctement mis en correspondance.

Microsoft.AspNetCore.Diagnostics

Les Microsoft.AspNetCore.Diagnostics métriques signalent les informations de diagnostic de ASP.NET middleware de gestion des erreurs de base :

• aspnetcore.diagnostics.exceptions

Métrique : aspnetcore.diagnostics.exceptions

Nom	Type d’instrument	Unité (UCUM)	Descriptif
aspnetcore.diagnostics.exceptions	Compteur	{exception}	Nombre d’exceptions interceptées par le middleware de gestion des exceptions.

Attribut	Catégorie	Descriptif	Exemples	Présence
aspnetcore.diagnostics.exception.result	ficelle	ASP.NET Résultat de gestion des intergiciels d’exception Core	handled; unhandled	Toujours
aspnetcore.diagnostics.handler.type	ficelle	Nom de type complet de l’implémentation IExceptionHandler qui a géré l’exception.	Contoso.MyHandler	Si l’exception a été gérée par ce gestionnaire.
exception.type	ficelle	Nom complet du type d’exception.	System.OperationCanceledException; Contoso.MyException	Toujours

Microsoft.AspNetCore.RateLimiting

Les Microsoft.AspNetCore.RateLimiting métriques signalent les informations de limitation du taux de ASP.NET middleware de limitation de débit de base :

• 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étrique : aspnetcore.rate_limiting.active_request_leases

Nom	Type d’instrument	Unité (UCUM)	Descriptif
aspnetcore.rate_limiting.active_request_leases	UpDownCounter	{request}	Nombre de demandes actuellement actives sur le serveur qui contiennent un bail limitant le débit.

Attribut	Catégorie	Descriptif	Exemples	Présence
aspnetcore.rate_limiting.policy	ficelle	Nom de la stratégie de limitation de débit.	fixed; sliding; ; token	Si le point de terminaison correspondant à la demande avait une stratégie de limitation de débit.

Métrique : aspnetcore.rate_limiting.request_lease.duration

Nom	Type d’instrument	Unité (UCUM)	Descriptif
aspnetcore.rate_limiting.request_lease.duration	Histogramme	s	Durée du bail limitant le taux détenu par les demandes sur le serveur.

Attribut	Catégorie	Descriptif	Exemples	Présence
aspnetcore.rate_limiting.policy	ficelle	Nom de la stratégie de limitation de débit.	fixed; sliding; ; token	Si le point de terminaison correspondant à la demande avait une stratégie de limitation de débit.

Métrique : aspnetcore.rate_limiting.queued_requests

Nom	Type d’instrument	Unité (UCUM)	Descriptif
aspnetcore.rate_limiting.queued_requests	UpDownCounter	{request}	Nombre de demandes actuellement mises en file d’attente en attente d’acquisition d’un bail de limitation de débit.

Attribut	Catégorie	Descriptif	Exemples	Présence
aspnetcore.rate_limiting.policy	ficelle	Nom de la stratégie de limitation de débit.	fixed; sliding; ; token	Si le point de terminaison correspondant à la demande avait une stratégie de limitation de débit.

Métrique : aspnetcore.rate_limiting.request.time_in_queue

Nom	Type d’instrument	Unité (UCUM)	Descriptif
aspnetcore.rate_limiting.request.time_in_queue	Histogramme	s	Temps passé dans une file d’attente en attente d’acquisition d’un bail limitant le taux.

Attribut	Catégorie	Descriptif	Exemples	Présence
aspnetcore.rate_limiting.policy	ficelle	Nom de la stratégie de limitation de débit.	fixed; sliding; ; token	Si le point de terminaison correspondant à la demande avait une stratégie de limitation de débit.
aspnetcore.rate_limiting.result	ficelle	Le résultat de limitation du taux indique si le bail a été acquis ou contient une raison de rejet.	acquired; request_canceled	Toujours

Métrique : aspnetcore.rate_limiting.requests

Nom	Type d’instrument	Unité (UCUM)	Descriptif
aspnetcore.rate_limiting.requests	Compteur	{request}	Nombre de demandes qui ont tenté d’acquérir un bail limitant le taux.

Attribut	Catégorie	Descriptif	Exemples	Présence
aspnetcore.rate_limiting.policy	ficelle	Nom de la stratégie de limitation de débit.	fixed; sliding; ; token	Si le point de terminaison correspondant à la demande avait une stratégie de limitation de débit.
aspnetcore.rate_limiting.result	ficelle	Le résultat de limitation du taux indique si le bail a été acquis ou contient une raison de rejet.	acquired; request_canceled	Toujours

Microsoft.AspNetCore.HeaderParsing

Les Microsoft.AspNetCore.HeaderParsing métriques signalent des informations sur ASP.NET analyse d’en-tête Core :

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

Métrique : aspnetcore.header_parsing.parse_errors

Nom	Type d’instrument	Unité (UCUM)	Descriptif
aspnetcore.header_parsing.parse_errors	Compteur	{parse_error}	Nombre d’erreurs qui se sont produites lors de l’analyse des en-têtes de requête HTTP.

Attribut	Catégorie	Descriptif	Exemples	Présence
aspnetcore.header_parsing.header.name	ficelle	Nom de l’en-tête.	Content-Type	Toujours
error.type	ficelle	Message d’erreur.	Unable to parse media type value.	Toujours

Métrique : aspnetcore.header_parsing.cache_accesses

La métrique est émise uniquement pour les analyseurs d’en-tête de requête HTTP qui prennent en charge la mise en cache.

Nom	Type d’instrument	Unité (UCUM)	Descriptif
aspnetcore.header_parsing.cache_accesses	Compteur	{cache_access}	Nombre de fois qu’un cache stockant les valeurs d’en-tête analysées a été accédé.

Attribut	Catégorie	Descriptif	Exemples	Présence
aspnetcore.header_parsing.header.name	ficelle	Nom de l’en-tête.	Content-Type	Toujours
aspnetcore.header_parsing.cache_access.type	ficelle	Valeur indiquant si la valeur de l’en-tête a été trouvée dans le cache ou non.	Hit; Miss	Toujours

Microsoft.AspNetCore.Server.Kestrel

Les Microsoft.AspNetCore.Server.Kestrel métriques signalent les informations de connexion HTTP à partir de ASP.NET serveur web Core Kestrel:

• 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étrique : kestrel.active_connections

Nom	Type d’instrument	Unité (UCUM)	Descriptif
kestrel.active_connections	UpDownCounter	{connection}	Nombre de connexions actuellement actives sur le serveur.

Attribut	Catégorie	Descriptif	Exemples	Présence
network.transport	ficelle	de la couche de transport OSI ou méthode de communication interprocessus.	tcp; unix	Toujours
network.type	ficelle	couche réseau OSI ou équivalent non-OSI.	ipv4; ipv6	Si le transport est tcp ou udp.
server.address	ficelle	Nom de domaine d’adresse du serveur s’il est disponible sans recherche DNS inversée ; sinon, adresse IP ou nom de socket de domaine Unix.	example.com	Toujours
server.port	Int	Numéro de port du serveur	80; 8080; ; 443	Si le transport est tcp ou udp.

Métrique : kestrel.connection.duration

Nom	Type d’instrument	Unité (UCUM)	Descriptif
kestrel.connection.duration	Histogramme	s	Durée des connexions sur le serveur.

Attribut	Catégorie	Descriptif	Exemples	Présence
error.type	ficelle	Décrit un type d’erreur avec lequel la connexion s’est terminée ou le type d’exception non géré levée pendant le pipeline de connexion. Des erreurs de connexion connues sont disponibles dans les conventions sémantiques pour Kestrel les métriques de serveur web.	connection_reset; invalid_request_headers; ; System.OperationCanceledException	Si la connexion s’est terminée avec une erreur connue ou qu’une exception a été levée.
network.protocol.name	ficelle	Couche d’application OSI ou équivalent non-OSI.	http; web_sockets	Toujours
network.protocol.version	ficelle	Version du protocole spécifié dans network.protocol.name.	1.1; 2	Toujours
network.transport	ficelle	de la couche de transport OSI ou méthode de communication interprocessus.	tcp; unix	Toujours
network.type	ficelle	couche réseau OSI ou équivalent non-OSI.	ipv4; ipv6	Si le transport est tcp ou udp.
server.address	ficelle	Nom de domaine d’adresse du serveur s’il est disponible sans recherche DNS inversée ; sinon, adresse IP ou nom de socket de domaine Unix.	example.com	Toujours
server.port	Int	Numéro de port du serveur	80; 8080; ; 443	Si le transport est tcp ou udp.
tls.protocol.version	ficelle	Version du protocole TLS.	1.2; 1.3	Si la connexion est sécurisée avec TLS.

Étant donné que cette métrique effectue le suivi de la durée de la connexion et que, dans l’idéal, les connexions HTTP sont utilisées pour plusieurs requêtes, les compartiments doivent être plus longs que ceux utilisés pour les durées de requête. Par exemple, l’utilisation de [ 0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 30, 60, 120, 300] fournit un compartiment supérieur de 5 minutes.

Lorsqu’une connexion se termine par une erreur connue, la valeur de l’attribut error.type est définie sur le type d’erreur connu. Des erreurs de connexion connues sont disponibles dans les conventions sémantiques pour Kestrel les métriques de serveur web.

Métrique : kestrel.rejected_connections

Nom	Type d’instrument	Unité (UCUM)	Descriptif
kestrel.rejected_connections	Compteur	{connection}	Nombre de connexions rejetées par le serveur.

Attribut	Catégorie	Descriptif	Exemples	Présence
network.transport	ficelle	de la couche de transport OSI ou méthode de communication interprocessus.	tcp; unix	Toujours
network.type	ficelle	couche réseau OSI ou équivalent non-OSI.	ipv4; ipv6	Si le transport est tcp ou udp.
server.address	ficelle	Nom de domaine d’adresse du serveur s’il est disponible sans recherche DNS inversée ; sinon, adresse IP ou nom de socket de domaine Unix.	example.com	Toujours
server.port	Int	Numéro de port du serveur	80; 8080; ; 443	Si le transport est tcp ou udp.

Les connexions sont rejetées lorsque le nombre actif dépasse la valeur configurée avec MaxConcurrentConnections.

Métrique : kestrel.queued_connections

Nom	Type d’instrument	Unité (UCUM)	Descriptif
kestrel.queued_connections	UpDownCounter	{connection}	Nombre de connexions actuellement mises en file d’attente et en attente de démarrage.

Attribut	Catégorie	Descriptif	Exemples	Présence
network.transport	ficelle	de la couche de transport OSI ou méthode de communication interprocessus.	tcp; unix	Toujours
network.type	ficelle	couche réseau OSI ou équivalent non-OSI.	ipv4; ipv6	Si le transport est tcp ou udp.
server.address	ficelle	Nom de domaine d’adresse du serveur s’il est disponible sans recherche DNS inversée ; sinon, adresse IP ou nom de socket de domaine Unix.	example.com	Toujours
server.port	Int	Numéro de port du serveur	80; 8080; ; 443	Si le transport est tcp ou udp.

Métrique : kestrel.queued_requests

Nom	Type d’instrument	Unité (UCUM)	Descriptif
kestrel.queued_requests	UpDownCounter	{request}	Nombre de requêtes HTTP sur des connexions multiplexées (HTTP/2 et HTTP/3) actuellement mises en file d’attente et en attente de démarrage.

Attribut	Catégorie	Descriptif	Exemples	Présence
network.protocol.name	ficelle	Couche d’application OSI ou équivalent non-OSI.	http; web_sockets	Toujours
network.protocol.version	ficelle	Version du protocole spécifié dans network.protocol.name.	1.1; 2	Toujours
network.transport	ficelle	de la couche de transport OSI ou méthode de communication interprocessus.	tcp; unix	Toujours
network.type	ficelle	couche réseau OSI ou équivalent non-OSI.	ipv4; ipv6	Si le transport est tcp ou udp.
server.address	ficelle	Nom de domaine d’adresse du serveur s’il est disponible sans recherche DNS inversée ; sinon, adresse IP ou nom de socket de domaine Unix.	example.com	Toujours
server.port	Int	Numéro de port du serveur	80; 8080; ; 443	Si le transport est tcp ou udp.

Métrique : kestrel.upgraded_connections

Nom	Type d’instrument	Unité (UCUM)	Descriptif
kestrel.upgraded_connections	UpDownCounter	{connection}	Nombre de connexions actuellement mises à niveau (WebSockets).

Attribut	Catégorie	Descriptif	Exemples	Présence
network.transport	ficelle	de la couche de transport OSI ou méthode de communication interprocessus.	tcp; unix	Toujours
network.type	ficelle	couche réseau OSI ou équivalent non-OSI.	ipv4; ipv6	Si le transport est tcp ou udp.
server.address	ficelle	Nom de domaine d’adresse du serveur s’il est disponible sans recherche DNS inversée ; sinon, adresse IP ou nom de socket de domaine Unix.	example.com	Toujours
server.port	Int	Numéro de port du serveur	80; 8080; ; 443	Si le transport est tcp ou udp.

Le compteur effectue uniquement le suivi des connexions HTTP/1.1.

Métrique : kestrel.tls_handshake.duration

Nom	Type d’instrument	Unité (UCUM)	Descriptif
kestrel.tls_handshake.duration	Histogramme	s	Durée des liaisons TLS sur le serveur.

Attribut	Catégorie	Descriptif	Exemples	Présence
error.type	ficelle	Nom complet du type d’exception.	System.OperationCanceledException; Contoso.MyException	Si une exception a été levée.
network.transport	ficelle	de la couche de transport OSI ou méthode de communication interprocessus.	tcp; unix	Toujours
network.type	ficelle	couche réseau OSI ou équivalent non-OSI.	ipv4; ipv6	Si le transport est tcp ou udp.
server.address	ficelle	Nom de domaine d’adresse du serveur s’il est disponible sans recherche DNS inversée ; sinon, adresse IP ou nom de socket de domaine Unix.	example.com	Toujours
server.port	Int	Numéro de port du serveur	80; 8080; ; 443	Si le transport est tcp ou udp.
tls.protocol.version	ficelle	Version du protocole TLS.	1.2; 1.3	Si la connexion est sécurisée avec TLS.

Lorsque vous utilisez OpenTelemetry, les compartiments par défaut pour ce metic sont définis sur [ 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étrique : kestrel.active_tls_handshakes

Nom	Type d’instrument	Unité (UCUM)	Descriptif
kestrel.active_tls_handshakes	UpDownCounter	{handshake}	Nombre de négociation TLS en cours sur le serveur.

Attribut	Catégorie	Descriptif	Exemples	Présence
network.transport	ficelle	de la couche de transport OSI ou méthode de communication interprocessus.	tcp; unix	Toujours
network.type	ficelle	couche réseau OSI ou équivalent non-OSI.	ipv4; ipv6	Si le transport est tcp ou udp.
server.address	ficelle	Nom de domaine d’adresse du serveur s’il est disponible sans recherche DNS inversée ; sinon, adresse IP ou nom de socket de domaine Unix.	example.com	Toujours
server.port	Int	Numéro de port du serveur	80; 8080; ; 443	Si le transport est tcp ou udp.

Microsoft.AspNetCore.Http.Connections

Les Microsoft.AspNetCore.Http.Connections informations de connexion du rapport des métriques à partir de ASP.NET Core SignalR:

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

Métrique : signalr.server.connection.duration

Nom	Type d’instrument	Unité (UCUM)	Descriptif
signalr.server.connection.duration	Histogramme	s	Durée des connexions sur le serveur.

Attribut	Catégorie	Descriptif	Exemples	Présence
signalr.connection.status	ficelle	SignalR État de fermeture de connexion HTTP.	app_shutdown; timeout	Toujours
signalr.transport	ficelle	SignalR type de transport	web_sockets; long_polling	Toujours

Valeur	Descriptif
normal_closure	La connexion a été fermée normalement.
timeout	La connexion a été fermée en raison d’un délai d’expiration.
app_shutdown	La connexion a été fermée, car l’application s’arrête.

signalr.transport est l’un des éléments suivants :

Valeur	Descriptif
server_sent_events	événements envoyés par le serveur
long_polling	Interrogation longue
web_sockets	WebSocket

Étant donné que cette métrique effectue le suivi de la durée de connexion et que SignalR les connexions sont idéalement durables, les compartiments doivent être plus longs que ceux utilisés pour les durées de requête. Par exemple, l’utilisation de [0, 0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 30, 60, 120, 300, 300] fournit un compartiment supérieur de 5 minutes.

Métrique : signalr.server.active_connections

Nom	Type d’instrument	Unité (UCUM)	Descriptif
signalr.server.active_connections	UpDownCounter	{connection}	Nombre de connexions actuellement actives sur le serveur.

Attribut	Catégorie	Descriptif	Exemples	Présence
signalr.connection.status	ficelle	SignalR État de fermeture de connexion HTTP.	app_shutdown; timeout	Toujours
signalr.transport	ficelle	SignalR type de transport	web_sockets; long_polling	Toujours