ASP.NET Core wbudowanych metryk

Ten artykuł jest punktem wejścia dla wbudowanych metryk, które ASP.NET Core tworzy przy użyciu interfejsu System.Diagnostics.Metrics API. Dokumentacja metryk jest zorganizowana na ukierunkowane strony według tematu. Skorzystaj z poniższych stron, aby znaleźć instrumenty, atrybuty i wskazówki dotyczące użycia dla każdego obszaru. Aby uzyskać listę metryk na podstawie starszego interfejsu API EventCounters , zobacz Dostępne liczniki.

Aby uzyskać informacje na temat zbierania, raportowania, wzbogacania i testowania za pomocą metryk ASP.NET Core, zobacz ASP.NET Core metryki.

Note

Począwszy od .NET 11, wbudowane mierniki serwera HTTP wymienione na tych stronach referencyjnych (w szczególności Microsoft.AspNetCore.Hosting i Microsoft.AspNetCore.Server.Kestrel) emitują dane zgodne z wymaganymi częściami semantyki serwera HTTP OpenTelemetry. Pakiet OpenTelemetry.Instrumentation.AspNetCore jest opcjonalny dla metryk serwera HTTP — zarejestruj te mierniki bezpośrednio przy użyciu zestawu OpenTelemetry SDK. Aby uzyskać więcej informacji, zobacz ASP.NET Core metrics (Metryki podstawowe ASP.NET).

Strony referencyjne metryk

Strona Przestrzenie nazw Przykładowe metryki
Metryki HTTP Microsoft.AspNetCore.Hosting, Microsoft.AspNetCore.Routing, , Microsoft.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
Metryki diagnostyczne Microsoft.AspNetCore.Diagnostics aspnetcore.diagnostics.exceptions
Blazor (Składniki) metryki Microsoft.AspNetCore.Components, Microsoft.AspNetCore.Components.Lifecycle, Microsoft.AspNetCore.Components.Server.Circuits aspnetcore.components.navigate, aspnetcore.components.circuit.active
Metryki uwierzytelniania i autoryzacji Microsoft.AspNetCore.Authorization, Microsoft.AspNetCore.Authentication aspnetcore.authorization.attempts, aspnetcore.authentication.challenges

Strony Blazor metryk uwierzytelniania i autoryzacji (składniki) opisują metryki dostępne w ASP.NET Core 10.0 lub nowszym. Wybierz ASP.NET Core 10.0 (lub nowszą wersję) z selektorem wersji, aby wyświetlić tę zawartość.

Sposób grupowania metryk

Metryki są grupowane według odbiorców i tematów. Ponieważ niektóre przestrzenie nazw nie są mapowanie w sposób czysty na pojedynczy temat, obowiązują następujące reguły umieszczania:

  • Obsługa żądań HTTP, routing, ograniczanie szybkości, analizowanie nagłówków, Kestrel serwer internetowy i SignalR (Microsoft.AspNetCore.Http.Connections) są grupowane razem na stronie metryk HTTP, ponieważ wszystkie odnoszą się do obsługi połączeń HTTP i w czasie rzeczywistym.
  • Metryki oprogramowania pośredniczącego obsługujące błędy znajdują się na stronie metryk diagnostycznych.
  • Blazor (Składniki) metryki są grupowane według ich składników, cyklu życia i przestrzeni nazw obwodu serwera.
  • Uwierzytelnianie, autoryzacja i Identity metryki są grupowane razem jako metryki związane z zabezpieczeniami.

Jak przeczytać tę dokumentację

Każda metryka na stronach referencyjnych jest udokumentowana następującymi informacjami:

  • Nazwa: nazwa metryki (instrument).
  • Typ instrumentu: rodzaj instrumentu, taki jak Counter, UpDownCounterlub Histogram.
  • Jednostka (UCUM): jednostka miary wyrażona przy użyciu ujednoliconego kodu dla jednostek miary (UCUM) na przykład s przez sekundy.
  • Atrybut: wymiary (tagi) zgłoszone za pomocą metryki.
  • Obecność: gdy atrybut jest obecny, na przykład Always lub tylko w określonych warunkach.
  • Użycie: Przykładowe pytania, na które pomaga metryka.

Aby uzyskać wskazówki dotyczące zbierania, raportowania, wzbogacania i testowania przy użyciu tych metryk, zobacz ASP.NET Core metryki.

  • Ostatnia aktualizacja o