ASP.NET Core integrierten Metriken

Dieser Artikel ist der Einstiegspunkt für die integrierten Metriken, die ASP.NET Core mithilfe der System.Diagnostics.Metrics API erzeugt. Der Metrikverweis ist nach Thema in fokussierten Seiten angeordnet. Verwenden Sie die folgenden Seiten, um die Instrumente, Attribute und Verwendungsanleitungen für jeden Bereich zu finden. Eine Auflistung von Metriken basierend auf der älteren EventCounters-API finden Sie unter "Verfügbare Leistungsindikatoren".

Informationen zum Sammeln, Melden, Anreichern und Testen mit ASP.NET Core Metriken finden Sie unter ASP.NET Core Metriken.

Note

Ab .NET 11 geben die integrierten HTTP-Serverzähler, die auf diesen Referenzseiten (vor allemMicrosoft.AspNetCore.Hosting) katalogisiert sind, Microsoft.AspNetCore.Server.KestrelDaten aus, die den erforderlichen Teilen der OpenTelemetry-HTTP-Serversemantikkonventionen entsprechen. Das OpenTelemetry.Instrumentation.AspNetCore Paket ist optional für HTTP-Servermetriken – registrieren Sie diese Meter direkt mit dem OpenTelemetry SDK. Weitere Informationen finden Sie unter ASP.NET Core-Metriken.

Metrikverweisseiten

Seite Namespaces Beispielmetriken
HTTP-Metriken Microsoft.AspNetCore.Hosting, , Microsoft.AspNetCore.RoutingMicrosoft.AspNetCore.RateLimiting, Microsoft.AspNetCore.HeaderParsing, Microsoft.AspNetCore.Server.Kestrel, Microsoft.AspNetCore.Http.Connections (SignalR) http.server.request.duration, aspnetcore.routing.match_attempts, kestrel.active_connections, signalr.server.active_connections
Diagnosemetriken Microsoft.AspNetCore.Diagnostics aspnetcore.diagnostics.exceptions
Blazor (Komponenten) Metriken Microsoft.AspNetCore.Components, Microsoft.AspNetCore.Components.LifecycleMicrosoft.AspNetCore.Components.Server.Circuits aspnetcore.components.navigation, aspnetcore.components.circuit.active
Authentifizierungs- und Autorisierungsmetriken Microsoft.AspNetCore.Authorization, Microsoft.AspNetCore.Authentication aspnetcore.authorization.attempts, aspnetcore.authentication.challenges

Die Blazor Seiten (Komponenten) und Authentifizierungs- und Autorisierungsmetriken beschreiben Metriken, die in ASP.NET Core 10.0 oder höher verfügbar sind. Wählen Sie ASP.NET Core 10.0 (oder eine höhere Version) mit der Versionsauswahl aus, um diesen Inhalt anzuzeigen.

Gruppieren von Metriken

Metriken werden nach Zielgruppe und Thema gruppiert. Da einige Namespaces einem einzelnen Thema nicht sauber zugeordnet werden, gelten die folgenden Platzierungsregeln:

  • HTTP-Anforderungsverarbeitung, Routing, Ratelimitierung, Headeranalyse, Webserver Kestrel und SignalR (Microsoft.AspNetCore.Http.Connections) werden auf der Seite mit HTTP-Metriken gruppiert, da sie alle mit der Bereitstellung von HTTP- und Echtzeitverbindungen zusammenhängen.
  • Middlewaremetriken zur Fehlerbehandlung befinden sich auf der Seite "Diagnosemetriken".
  • Blazor (Komponenten) Metriken werden nach komponenten-, lebenszyklus- und Serverschaltungsnamespaces gruppiert.
  • Authentifizierung, Autorisierung und Identity Metriken werden als sicherheitsbezogene Metriken gruppiert.

Lesen dieser Referenz

Jede Metrik auf den Referenzseiten wird mit den folgenden Informationen dokumentiert:

  • Name: Der Name der Metrik (Instrument).
  • Instrumenttyp: Die Art des Instruments, z Counter. B. , , UpDownCounteroder Histogram.
  • Einheit (UCUM): Die Maßeinheit, ausgedrückt mit dem einheitlichen Code für Maßeinheiten (UCUM), z s . B. für Sekunden.
  • Attribut: Die mit der Metrik gemeldeten Dimensionen (Tags).
  • Anwesenheit: Wenn das Attribut vorhanden ist, z. B Always . oder nur unter bestimmten Bedingungen.
  • Verwendung: Beispielfragen, die der Metrik helfen, zu beantworten.

Anleitungen zum Sammeln, Melden, Anreichern und Testen mit diesen Metriken finden Sie unter ASP.NET Core Metriken.

  • Last updated on