メトリクスを始める - ASP.NET Core
ASP.NET Core アプリケーションで OpenTelemetry メトリクスを使う方法を学ぶ
このガイドでは、ASP.NET Core アプリケーションで OpenTelemetry .NET メトリクスを数分で始める方法を紹介します。
前提条件
- .NET SDK がコンピューターにインストールされていること
ASP.NET Core アプリケーションの作成
新しい ASP.NET Core ウェブアプリケーションを作成します。
dotnet new web -o aspnetcoreapp
cd aspnetcoreapp
OpenTelemetry メトリクスの追加
必要な OpenTelemetry パッケージをインストールします。
dotnet add package OpenTelemetry.Exporter.Console
dotnet add package OpenTelemetry.Extensions.Hosting
dotnet add package OpenTelemetry.Instrumentation.AspNetCore
Program.cs ファイルを以下のコードで更新します。
using OpenTelemetry.Metrics;
using OpenTelemetry.Resources;
var builder = WebApplication.CreateBuilder(args);
// OpenTelemetry をメトリクスと自動起動で設定する。
builder.Services.AddOpenTelemetry()
.ConfigureResource(resource => resource
.AddService(serviceName: builder.Environment.ApplicationName))
.WithMetrics(metrics => metrics
.AddAspNetCoreInstrumentation()
.AddConsoleExporter((exporterOptions, metricReaderOptions) =>
{
metricReaderOptions.PeriodicExportingMetricReaderOptions.ExportIntervalMilliseconds = 1000;
}));
var app = builder.Build();
app.MapGet("/", () => $"Hello from OpenTelemetry Metrics!");
app.Run();
アプリケーションの実行
アプリケーションを実行します。
dotnet run
コンソールに表示される URL（例: http://localhost:5000）にブラウザでアクセスします。
コンソールに以下のようなメトリクス出力が表示されるはずです。
Export http.server.duration, Measures the duration of inbound HTTP requests., Unit: ms, Meter: OpenTelemetry.Instrumentation.AspNetCore/1.0.0.0
(2023-04-11T21:49:43.6915232Z, 2023-04-11T21:50:50.6564690Z) http.flavor: 1.1 http.method: GET http.route: / http.scheme: http http.status_code: 200 net.host.name: localhost net.host.port: 5000 Histogram
Value: Sum: 3.5967 Count: 11 Min: 0.073 Max: 2.5539
(-Infinity,0]:0
(0,5]:11
(5,10]:0
(10,25]:0
(25,50]:0
(50,75]:0
(75,100]:0
(100,250]:0
(250,500]:0
(500,750]:0
(750,1000]:0
(1000,2500]:0
(2500,5000]:0
(5000,7500]:0
(7500,10000]:0
(10000,+Infinity]:0
おめでとうございます！ これで OpenTelemetry を使用して ASP.NET Core アプリケーションからメトリクスを収集できるようになりました。
仕組み
OpenTelemetry の登録
アプリケーションは、ASP.NET Core が提供する依存性注入コンテナを使用して OpenTelemetry サービスを登録します。
builder.Services.AddOpenTelemetry()
.ConfigureResource(resource => resource
.AddService(serviceName: builder.Environment.ApplicationName))
.WithMetrics(metrics => metrics
.AddAspNetCoreInstrumentation()
.AddConsoleExporter((exporterOptions, metricReaderOptions) =>
{
metricReaderOptions.PeriodicExportingMetricReaderOptions.ExportIntervalMilliseconds = 1000;
}));
このコードは以下を行います。
AddOpenTelemetry()でサービスコレクションに OpenTelemetry を追加するConfigureResource()でサービス情報を含むリソースを設定するWithMetrics()でメトリクスの収集を設定するAddAspNetCoreInstrumentation()で ASP.NET Core の自動計装を追加する- コンソールエクスポーターが毎秒メトリクスをエクスポートするように設定する
ASP.NET Core の計装
AddAspNetCoreInstrumentation() メソッドは、以下を含む HTTP リクエストメトリクスを自動的に収集します。
- リクエストの持続時間
- HTTP メソッド、ルート、ステータスコード
- ネットワーク情報
これらのメトリクスは、コントローラーやミドルウェアに追加のコードを記述することなく収集されます。
さらに学ぶ
フィードバック
このページは役に立ちましたか?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!