0Pricing
C# Academy · レッスン

メトリクスの収集

カウンター、ゲージ、ヒストグラムを記録します。

「メトリクスの収集」はCoddyKit上の無料C# Academyレッスンです。 これはレッスン3/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはC# Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 C# Academyコースには全4レッスンが含まれています。

なぜメトリクスなのか

メトリクスは、時間の経過に伴って集約された数値測定値です。リクエスト数、エラー数、レイテンシ、キューの深さなど、ダッシュボードやアラートに利用されます。ログとは異なり、集約されるため、大量に発生しても低コストに保てます。

Meter API

.NET はSystem.Diagnostics.Metricsを通じてメトリクスを出力します。Meterを作成し、それを使ってカウンターやヒストグラムなどのインストゥルメントを作成します。

using System.Diagnostics.Metrics;

private static readonly Meter Meter = new("Checkout.Orders");

カウンター

Counterは増加するだけの値で、注文数やエラー数などのイベントのカウントに適しています。Addを呼び出して値を増やします。

private static readonly Counter<long> OrdersPlaced =
    Meter.CreateCounter<long>("orders.placed");

OrdersPlaced.Add(1);

Counter のディメンション

ステータスやリージョンなどのディメンションでカウンターを分割できるよう、タグを付加します。これにより、バックエンドで集計やフィルタリングができます。

OrdersPlaced.Add(1,
    new KeyValuePair<string, object>("status", "completed"),
    new KeyValuePair<string, object>("region", "eu"));

ヒストグラム

Histogramは値の分布を記録するため、レイテンシやペイロードサイズに適しています。バックエンドは、記録されたサンプルからパーセンタイル（p50、p95、p99）を計算します。

private static readonly Histogram<double> OrderDuration =
    Meter.CreateHistogram<double>("order.duration", "ms");

OrderDuration.Record(elapsedMs);

UpDownCounter

UpDownCounterは増加と減少の両方が可能で、アクティブな接続数や現在キューに入っている項目数などに適しています。

private static readonly UpDownCounter<long> ActiveOrders =
    Meter.CreateUpDownCounter<long>("orders.active");

ActiveOrders.Add(1);   // started
ActiveOrders.Add(-1);  // finished

Observable インストゥルメント

Observableインストゥルメントは、コールバックを介して必要なときに読み取られます。増分を記録するのではなくサンプリングする、現在のメモリ使用量やキャッシュサイズなどのゲージに適しています。

Meter.CreateObservableGauge("cache.size",
    () => _cache.Count);

Meter の登録

トレーシングと同様に、OTel は登録したメーターだけを収集します。メーター名を指定してAddMeterを使用します。

builder.Services.AddOpenTelemetry()
    .WithMetrics(metrics => metrics
        .AddMeter("Checkout.Orders"));

組み込みメトリクス

計装パッケージは、ASP.NET Core（リクエスト時間、アクティブなリクエスト）やランタイム（GC、スレッドプール）用のすぐに使えるメトリクスを公開するため、すぐに運用状況を把握できます。

metrics
    .AddAspNetCoreInstrumentation()
    .AddRuntimeInstrumentation();

適切なインストゥルメントの選択

動作に応じて選択します。単調増加するカウントなら Counter、増減する値なら UpDownCounter、分布なら Histogram、サンプリングした現在値なら Observable Gauge です。適切に選択すると、ダッシュボードやアラートを簡単に構成できます。

カーディナリティを管理する

タグの一意な組み合わせごとに、個別の時系列が作成されます。ユーザー ID のような高カーディナリティのタグは、ストレージ容量とコストを急増させる可能性があります。ステータスやリージョンのように、値の範囲が限定された低カーディナリティのディメンションを使用します。

クイックチェック

メトリクスの収集を確認します。

まとめ

メトリクスは数値測定値を低コストで集約します。Meter API はインストゥルメントを作成します。Counter（単調増加）、UpDownCounter（増減）、Histogram（パーセンタイル用の分布）、Observableゲージ（サンプリング）です。タグでディメンションを追加できますが、カーディナリティには注意してください。AddMeterでメーターを登録し、ASP.NET Core とランタイムの組み込み計装を追加すれば、すぐに状況を把握できます。

よくある質問

「メトリクスの収集」レッスンは無料ですか？

はい。「メトリクスの収集」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、C# Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 C# Academyコースには全4レッスンが含まれています。

「メトリクスの収集」で何を学びますか？

カウンター、ゲージ、ヒストグラムを記録します。 ブラウザで直接実行するハンズオンコードでC# Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

C# Academyを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのC# Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン3/4です。

「メトリクスの収集」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このC# Academyレッスンでコードを書いて実行できますか？

はい。すべてのC# Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

  1. 可観測性の3本柱
  2. 分散トレーシング
  3. メトリクスの収集
  4. バックエンドへのエクスポート
← C# Academyに戻る