組み込みのメトリックを ASP.NET Coreする

この記事は、System.Diagnostics.Metrics API を使用して生成 ASP.NET Core組み込みのメトリックのエントリ ポイントです。 メトリックの参照は、トピックごとにフォーカスされたページに編成されます。 次のページを使用して、各領域のインストルメント、属性、および使用方法のガイダンスを確認します。 以前の EventCounters API に基づくメトリックの一覧については、「 使用可能なカウンター」を参照してください。

ASP.NET Coreメトリックを使用して収集、レポート、強化、テストを行う方法については、ASP.NET Coreメトリックを参照してください。

Note

.NET 11 以降では、これらの参照ページにカタログ化された組み込みの HTTP サーバー メーター (特にMicrosoft.AspNetCore.HostingとMicrosoft.AspNetCore.Server.Kestrel) は、OpenTelemetry HTTP サーバーセマンティック規則の必要な部分に準拠したデータを出力します。 OpenTelemetry.Instrumentation.AspNetCore パッケージは、HTTP サーバー メトリックでは省略可能です。これらのメーターを OpenTelemetry SDK に直接登録します。 詳細については、ASP.NET Core メトリック をご覧ください。

メトリックのリファレンス ページ

ページ 名前空間 メトリックの例
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
診断メトリック Microsoft.AspNetCore.Diagnostics aspnetcore.diagnostics.exceptions
Blazor (コンポーネント) メトリック Microsoft.AspNetCore.Components、Microsoft.AspNetCore.Components.Lifecycle、Microsoft.AspNetCore.Components.Server.Circuits aspnetcore.components.navigation、aspnetcore.components.circuit.active
認証と承認のメトリック Microsoft.AspNetCore.Authorization、Microsoft.AspNetCore.Authentication aspnetcore.authorization.attempts、aspnetcore.authentication.challenges

Blazor (コンポーネント) と認証および承認のメトリック ページには、ASP.NET Core 10.0 以降で使用できるメトリックが記載されています。 バージョン セレクター ASP.NET Core 10.0 (またはそれ以降のバージョン) を選択して、そのコンテンツを表示します。

メトリックのグループ化方法

メトリックは、対象ユーザーとトピックごとにグループ化されます。 一部の名前空間は 1 つのトピックにクリーンにマップされないため、次の配置規則が適用されます。

  • HTTP 要求の処理、ルーティング、レート制限、ヘッダーの解析、 Kestrel Web サーバー、 SignalR (Microsoft.AspNetCore.Http.Connections) は、すべて HTTP 接続とリアルタイム接続の提供に関連するため、HTTP メトリック ページでグループ化されます。
  • ミドルウェア メトリックの処理エラーは、診断メトリック ページにあります。
  • Blazor (コンポーネント) メトリックは、コンポーネント、ライフサイクル、およびサーバー回線の名前空間によってグループ化されます。
  • 認証、承認、および Identity メトリックは、セキュリティ関連のメトリックとしてグループ化されます。

このリファレンスを読む方法

リファレンス ページの各メトリックには、次の情報が記載されています。

  • 名前: メトリック (インストルメント) 名。
  • 楽器の種類: Counter、 UpDownCounter、 Histogramなどの楽器の種類。
  • 単位 (UCUM): 測定単位の 統一コード (UCUM) を使用して表される測定単位 (たとえば、 s 秒)。
  • 属性: メトリックで報告されたディメンション (タグ)。
  • プレゼンス: 属性が存在する場合 (たとえば、 Always または特定の条件下でのみ)。
  • 使用法: メトリックが回答に役立つ質問の例。

これらのメトリックを使用して収集、レポート、強化、テストを行う方法については、ASP.NET Coreメトリックを参照してください。

  • Last updated on