可観測性の3本柱

可観測性とは、システムが出力するデータから内部状態を理解できる能力です。稼働中のサービスについて、正常か、なぜ遅いのか、何が失敗したのかを把握できます。可観測性はトレース、メトリクス、ログの3本柱で成り立ちます。

OpenTelemetry（OTel）は、テレメトリを生成およびエクスポートするための、ベンダーに依存しない標準とライブラリ群です。一度インストルメンテーションを行えば、Jaeger、Prometheus、Grafana など多くのバックエンドにデータを送信できます。

ログは、個別のイベント（「ユーザー42がログインした」「支払いに失敗した」）を時刻付きで記録したものです。詳細で人間が読みやすいコンテキストを提供しますが、単独では情報量が多く、集約も困難になりがちです。

メトリクスは、時間の経過に伴って集計された数値データです（リクエスト数、エラー率、レイテンシーのパーセンタイル、CPU 使用率など）。保存コストが低く、ダッシュボードやアラートに適しています。

トレースは、サービス間を流れる1つのリクエストを追跡し、時間が計測されたスパンに分割します。どこで時間がかかっているのか、どの依存関係が遅延の原因なのかを明らかにします。

メトリクスは問題が起きていることを示します（エラー率が急上昇した）。トレースは問題がどこで起きているかを示します（決済サービス）。ログはなぜ起きたのかを示します（特定の注文で null 参照が発生した）。これらを組み合わせることで、デバッグに必要な全体像が得られます。

真の力を発揮するのは、データを相関付けたときです。ログとスパンに共通のトレース IDを付与すると、メトリクスのアラートから、失敗した1つのリクエストの正確なトレースとログへ移動できます。

OTel では、これらの柱をシグナルと呼びます。.NET では、トレースに Activity/ActivitySource、メトリクスに Meter、ログに ILogger という使い慣れたプリミティブを対応させます。

AddOpenTelemetry() を使ってシグナルを有効にし、トレースとメトリクスを構成します。各シグナルについては、次のレッスンで詳しく説明します。

リソースは、テレメトリを生成するエンティティ（サービス名、バージョン、環境）を表します。一貫して設定すると、バックエンドでデータを正しくグループ化・フィルタリングできます。

OTel では ASP.NET Core、HttpClient などの自動計装に加え、ビジネス固有の洞察を得るために独自のスパンやメトリクスを追加する手動計装も利用できます。

3つの柱を確認します。

オブザーバビリティは3つの柱で成り立っています。ログ（イベント、なぜ起きたか）、メトリクス（集約された数値、何が起きたか）、トレース（リクエスト単位のスパン、どこで起きたか）です。OpenTelemetryは、3つすべてをシグナルとして出力するベンダーニュートラルな標準であり、.NET ではそれぞれActivity、Meter、ILoggerに対応します。トレース ID と適切に設定したリソースによる関連付けで、これらを結び付けられます。