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

Cet article est le point d’entrée des métriques intégrées qui ASP.NET Core produit à l’aide de l’APISystem.Diagnostics.Metrics. La référence des métriques est organisée en pages ciblées par rubrique. Utilisez les pages suivantes pour rechercher les instruments, les attributs et les conseils d’utilisation pour chaque zone. Pour obtenir la liste des métriques basées sur l’ancienne API EventCounters , consultez Compteurs disponibles.

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

Note

À compter de .NET 11, les compteurs de serveur HTTP intégrés catalogés dans ces pages de référence (notamment Microsoft.AspNetCore.Hosting et Microsoft.AspNetCore.Server.Kestrel) émettent des données conformes aux parties requises des conventions sémantiques du serveur HTTP OpenTelemetry. Le OpenTelemetry.Instrumentation.AspNetCore package est facultatif pour les métriques de serveur HTTP : inscrivez ces compteurs directement auprès du Kit de développement logiciel (SDK) OpenTelemetry. Pour plus d’informations, consultez Métriques ASP.NET Core.

Pages de référence des métriques

Page Espaces de noms Exemples de métriques
Métriques HTTP Microsoft.AspNetCore.Hosting, Microsoft.AspNetCore.Routing, , Microsoft.AspNetCore.HeaderParsingMicrosoft.AspNetCore.RateLimiting, Microsoft.AspNetCore.Server.Kestrel, , Microsoft.AspNetCore.Http.Connections (SignalR) http.server.request.duration, , aspnetcore.routing.match_attemptskestrel.active_connections, ,signalr.server.active_connections
Métriques de diagnostic Microsoft.AspNetCore.Diagnostics aspnetcore.diagnostics.exceptions
Blazor Métriques (Composants) Microsoft.AspNetCore.Components, Microsoft.AspNetCore.Components.Lifecycle, Microsoft.AspNetCore.Components.Server.Circuits aspnetcore.components.navigation, aspnetcore.components.circuit.active
Métriques d’authentification et d’autorisation Microsoft.AspNetCore.Authorization, Microsoft.AspNetCore.Authentication aspnetcore.authorization.attempts, aspnetcore.authentication.challenges

Les Blazor pages de métriques d’authentification et d’autorisation (Composants) décrivent les métriques disponibles dans ASP.NET Core version 10.0 ou ultérieure. Sélectionnez ASP.NET Core 10.0 (ou une version ultérieure) avec le sélecteur de version pour afficher ce contenu.

Comment les métriques sont regroupées

Les métriques sont regroupées par public et rubrique. Étant donné que certains espaces de noms ne sont pas mappés correctement à une seule rubrique, les règles de placement suivantes s’appliquent :

  • La gestion des requêtes HTTP, le routage, la limitation du débit, l’analyse d’en-tête, le Kestrel serveur web et SignalR (Microsoft.AspNetCore.Http.Connections) sont regroupées sur la page des métriques HTTP, car elles concernent toutes les connexions HTTP et en temps réel.
  • Les métriques de middleware de gestion des erreurs se trouvent sur la page des métriques de diagnostic.
  • Blazor Les métriques (Composants) sont regroupées par leur composant, leur cycle de vie et leurs espaces de noms de circuit de serveur.
  • L’authentification, l’autorisation et Identity les métriques sont regroupées en tant que métriques liées à la sécurité.

Guide pratique pour lire cette référence

Chaque métrique des pages de référence est documentée avec les informations suivantes :

  • Nom : nom de la métrique (instrument).
  • Type d’instrument : type d’instrument, tel que Counter, UpDownCounterou Histogram.
  • Unité (UCUM) : unité de mesure, exprimée à l’aide du code unifié pour les unités de mesure (UCUM), par exemple s pendant des secondes.
  • Attribut : dimensions (balises) signalées avec la métrique.
  • Présence : lorsque l’attribut est présent, par exemple Always ou uniquement dans des conditions spécifiques.
  • Utilisation : Les exemples de questions que la métrique aide à répondre.

Pour obtenir des conseils sur la collecte, le rapport, l’enrichissement et le test avec ces métriques, consultez ASP.NET Core métriques.

  • Last updated on