ingebouwde metrische gegevens ASP.NET Core

Dit artikel is het toegangspunt voor de ingebouwde metrische gegevens die ASP.NET Core produceert met behulp van de System.Diagnostics.Metrics API. De naslaginformatie over metrische gegevens is ingedeeld in pagina's met prioriteit per onderwerp. Gebruik de volgende pagina's om de instrumenten, kenmerken en gebruiksrichtlijnen voor elk gebied te vinden. Zie Beschikbare tellers voor een lijst met metrische gegevens op basis van de oudere EventCounters-API.

Zie ASP.NET Core metrische gegevens voor informatie over het verzamelen, rapporteren, verrijken en testen met ASP.NET Core metrische gegevens.

Note

Vanaf .NET 11 verzenden de ingebouwde HTTP-servermeters die zijn gecatalogusd op deze referentiepagina's (met name Microsoft.AspNetCore.Hosting en Microsoft.AspNetCore.Server.Kestrel) gegevens die voldoen aan de vereiste onderdelen van de semantische http-serverconventies van OpenTelemetry. Het OpenTelemetry.Instrumentation.AspNetCore pakket is optioneel voor metrische HTTP-servergegevens. Registreer deze meters rechtstreeks bij de OpenTelemetry SDK. Zie ASP.NET Core-metrische gegevensvoor meer informatie.

Referentiepagina's voor metrische gegevens

Pagina Naamruimten Voorbeeld van metrische gegevens
Metrische HTTP-gegevens Microsoft.AspNetCore.Hosting, , Microsoft.AspNetCore.RateLimitingMicrosoft.AspNetCore.Routing, Microsoft.AspNetCore.HeaderParsing, , , ( Microsoft.AspNetCore.Http.ConnectionsSignalRMicrosoft.AspNetCore.Server.Kestrel http.server.request.duration,aspnetcore.routing.match_attempts,kestrel.active_connections,signalr.server.active_connections
Diagnostische metrische gegevens Microsoft.AspNetCore.Diagnostics aspnetcore.diagnostics.exceptions
Blazor (Onderdelen) metrische gegevens Microsoft.AspNetCore.Components, Microsoft.AspNetCore.Components.Lifecycle, Microsoft.AspNetCore.Components.Server.Circuits aspnetcore.components.navigation, aspnetcore.components.circuit.active
Metrische gegevens over verificatie en autorisatie Microsoft.AspNetCore.Authorization, Microsoft.AspNetCore.Authentication aspnetcore.authorization.attempts, aspnetcore.authentication.challenges

Op de Blazor pagina's met metrische gegevens (Onderdelen) en verificatie en autorisatie worden metrische gegevens beschreven die beschikbaar zijn in ASP.NET Core 10.0 of hoger. Selecteer ASP.NET Core 10.0 (of een latere versie) met de versiekiezer om die inhoud weer te geven.

Hoe metrische gegevens worden gegroepeerd

Metrische gegevens worden gegroepeerd op doelgroep en onderwerp. Omdat sommige naamruimten niet schoon worden toegewezen aan één onderwerp, zijn de volgende plaatsingsregels van toepassing:

  • Verwerking van HTTP-aanvragen, routering, snelheidsbeperking, headerparsering, de Kestrel webserver en SignalR (Microsoft.AspNetCore.Http.Connections) worden gegroepeerd op de pagina met metrische HTTP-gegevens, omdat ze allemaal betrekking hebben op het leveren van HTTP- en realtime-verbindingen.
  • Foutafhandeling van middleware-metrische gegevens bevindt zich op de pagina met metrische gegevens voor diagnostische gegevens.
  • Blazor (Onderdelen) metrische gegevens worden gegroepeerd op hun onderdeel, levenscyclus en servercircuitnaamruimten.
  • Verificatie, autorisatie en Identity metrische gegevens worden gegroepeerd als beveiligingsgerelateerde metrische gegevens.

Lees deze naslaginformatie

Elke metrische waarde op de referentiepagina's wordt gedocumenteerd met de volgende informatie:

  • Naam: de naam van de metrische waarde (instrument).
  • Type instrument: het type instrument, zoals Counter, UpDownCounterof Histogram.
  • Eenheid (UCUM): de maateenheid, uitgedrukt met behulp van de Unified Code for Units of Measure (UCUM), bijvoorbeeld s voor seconden.
  • Kenmerk: De dimensies (tags) die zijn gerapporteerd met de metrische waarde.
  • Aanwezigheid: Wanneer het kenmerk aanwezig is, bijvoorbeeld of Always alleen onder specifieke voorwaarden.
  • Gebruik: Voorbeeldvragen die metrische gegevens helpen beantwoorden.

Zie ASP.NET Core metrische gegevens voor hulp bij het verzamelen, rapporteren, verrijken en testen van deze metrische gegevens.