メトリクス計装

using System.Diagnostics.Metrics;

// Meter を作成する
var meter = new Meter("MyCompany.MyProduct", "1.0.0");

// カウンターを作成する
var requestCounter = meter.CreateCounter<long>("request_counter", "requests", "Counts the number of requests");

// 1 ずつ増加させる
requestCounter.Add(1);

// 属性付きで増加させる
requestCounter.Add(1, new("endpoint", "/api/users"), new("method", "GET"));

// アップダウンカウンターを作成する
var activeConnectionsCounter = meter.CreateUpDownCounter<int>("active_connections", "connections", "Number of active connections");

// 1 ずつ増加させる
activeConnectionsCounter.Add(1);

// 1 ずつ減少させる
activeConnectionsCounter.Add(-1);

// 属性付き
activeConnectionsCounter.Add(1, new("pool", "worker"), new("region", "west"));

// ヒストグラムを作成する
var requestDurationHistogram = meter.CreateHistogram<double>("request_duration", "ms", "Request duration in milliseconds");

// 時間を記録する
requestDurationHistogram.Record(213.5);

// 属性付き
requestDurationHistogram.Record(42.3, new("endpoint", "/api/users"), new("method", "GET"));

// オブザーバブルカウンターを作成する
meter.CreateObservableCounter("processed_items_total", () =>
{
    // 内部状態から現在のカウントを返す
    return new Measurement<long>(GetCurrentProcessedCount(), new("queue", "default"));
}, "items", "Total number of processed items");

// オブザーバブルアップダウンカウンターを作成する
meter.CreateObservableUpDownCounter("active_tasks", () =>
{
    // 内部状態から現在の値を返す
    return new[]
    {
        new Measurement<int>(GetHighPriorityTaskCount(), new("priority", "high")),
        new Measurement<int>(GetLowPriorityTaskCount(), new("priority", "low"))
    };
}, "tasks", "Current number of active tasks");

// オブザーバブルゲージを作成する
meter.CreateObservableGauge("cpu_usage", () =>
{
    // 現在の CPU 使用率を取得する
    return new Measurement<double>(GetCurrentCpuUsage());
}, "%", "Current CPU usage percentage");

// 複数のオブザーバブル計装に対して単一のコールバックを登録する
var observableCounter = meter.CreateObservableCounter<long>("my_observable_counter", "items");
var observableGauge = meter.CreateObservableGauge<double>("my_observable_gauge", "%");

meter.RegisterObservableCallback(observableInstruments =>
{
    // カウンターの値を記録する
    observableInstruments.Observe(observableCounter, 42, new("type", "product_a"));

    // ゲージの値を記録する
    observableInstruments.Observe(observableGauge, 12.3, new("resource", "cpu"));
}, observableCounter, observableGauge);

// 単位と説明を指定する
var requestSizeHistogram = meter.CreateHistogram<long>(
    name: "http.request.size",
    unit: "By",  // バイト
    description: "Size of HTTP request in bytes"
);