OpenTelemetry と Prometheus の違いと組み合わせ方
計装、収集、保存、アラートの役割を比較。OTLP 受信の設定と、転送経路を変える際のラベルや集計の確認方法を解説します。
購入処理の遅延を Prometheus で監視しているとします。OpenTelemetry でスパンを追加すれば、どの処理に時間がかかったかを追えます。既存のアラートはそのまま動かせますが、メトリクスの経路も OTLP に変えるなら話は別です。スクレイプ先のラベルで絞っていたクエリは、同じ計測値を送っても結果が変わることがあります。
OpenTelemetry は計装とテレメトリーの転送を担い、Prometheus はメトリクスの保存、クエリ、アラートルールの評価を担います。 どの処理をどちらに任せるか決めると、両方を組み合わせやすくなります。
OpenTelemetry と Prometheus の要点
- OpenTelemetry はトレース、メトリクス、ログなどを扱います。Prometheus が保存してクエリする対象はメトリクスの時系列です。
- OTLP は送信側から送ります。Collector は Prometheus のエンドポイントをスクレイプでき、Prometheus Server も設定すれば OTLP/HTTP のメトリクスを受け取れます。
- Prometheus は PromQL クエリとアラートルールを実行します。Alertmanager は通知のグループ化、重複排除、振り分けを行います。
- メトリクスは Prometheus に残し、トレースとログを別の送信先に渡せます。
どの処理をどちらが担うか
| 確認したいこと | OpenTelemetry | Prometheus |
|---|---|---|
| アプリケーションの計装 | API、SDK、自動計装でテレメトリーを生成 | クライアントライブラリでメトリクスを公開 |
| メトリクスの転送 | OTLP で送信、または Collector でスクレイプや転送 | エンドポイントをスクレイプ。OTLP/HTTP や Remote Write の受信も設定可能 |
| データの識別 | リソース、計装スコープ、信号別のレコード | メトリクス名とラベルの組み合わせで時系列を識別 |
| 保存とクエリ | 対応するバックエンドに転送 | Server に時系列データベースと PromQL を搭載 |
| アラートの評価と通知 | 受信先のバックエンドで設定 | Server でルールを評価。Alertmanager で通知をまとめて振り分ける |
| 複数信号の扱い | トレース、メトリクス、ログをパイプラインで転送 | 保存・クエリの対象はメトリクス |
| 所属する財団 | CNCF | CNCF |
どんな場面で使うか
購入リクエストを依存サービスまで追いたいなら、OpenTelemetry で計装してスパンをトレース用のバックエンドに送ります。購入処理がどのくらいの頻度で遅くなるかは、引き続き Prometheus で確認できます。
インフラ監視で node_exporter と Prometheus のダッシュボードやルールがすでに動いているなら、その構成を活かせます。Collector の hostmetrics receiver でもホストメトリクスを集められますが、既存ルールを使う前に、メトリクス名やラベルの違いを確認します。
バックエンドを分けたまま運用することもできます。Guance 上でメトリクス、トレース、ログをまとめて調べたいなら、信号ごとに対応するインプットへ送り、関連付けに使うフィールドを確認します。
組み合わせ方は三つある
- OpenTelemetry で計装し、Prometheus に保存する。 SDK が対応していれば Prometheus exporter でスクレイプ先を公開できます。Collector の Prometheus exporter で公開する方法や、受信を有効にした Prometheus Server に OTLP/HTTP でメトリクスを送る方法もあります。トレースとログは別に送れます。
- Collector で処理して Guance に送る。 Collector が信号を受け取り、設定した宛先へ転送します。Prometheus receiver は対象をスクレイプします。Prometheus exporter はスクレイプ先を公開します。Prometheus Remote Write exporter は対応する受信先へ Remote Write リクエストを送ります。OTLP とは別のプロトコルです。
- 既存の Prometheus を Guance につなぐ。 DataKit の
promインプットは既存の exporter をスクレイプできます。Prometheus がすでにスクレイプを担っている場合は、DataKit の Prometheus Remote Write インプット(英語)に転送できます。クエリとルールを残すなら Server を維持します。保存・クエリ・アラートを別の仕組みに任せる場合は Agent モードも選択肢です。
OTLP で Prometheus にメトリクスを送る場合
Prometheus の OTLP 受信機能(英語)は既定で無効です。対応する Server を --web.enable-otlp-receiver で起動すると、既定の /api/v1/otlp/v1/metrics で OTLP/HTTP のメトリクスを受け取れます。HTTP API の文書(英語)では、用途を絞った少量の送信に向くと説明しています。大規模な収集には既存のスクレイプを活かせます。下の例は環境変数に対応する SDK と、信頼できるテストネットワークを前提にしています。ホスト名とパスは環境に合わせます。
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=http://prometheus:9090/api/v1/otlp/v1/metrics
OTLP exporter の仕様(英語)に従うと、信号別の設定には完全な URL を指定します。共通の OTEL_EXPORTER_OTLP_ENDPOINT なら、ベースのパスは /api/v1/otlp です。exporter が /v1/metrics を付けます。本番環境では実際の受信先に合わせてアクセス制御と TLS を設定します。
転送経路を変える前にメトリクスを比べる
既知のメトリクスで名前、ラベル、単位、値を照合します。Prometheus の OTLP 受信では otlp.translation_strategy によって名前やラベルが変わります。リソース属性がすべての時系列にそのまま付くわけではありません。対応する属性があれば、service.name、service.namespace、service.instance.id が job と instance の組み立てに使われます。スクレイプ時のアドレスを instance に指定していたクエリは、データが届いても何も返さなくなることがあります。
集計の前提も確認します。カウンターの rate() と increase() は累積値向けです。送信元が差分値を出す場合は、使用バージョンと設定を確認します。Prometheus v3.2 以降は --enable-feature=otlp-deltatocumulative で累積値へ変換できます。差分のまま取り込めるバージョンでは、こちらと併用できない別の実験機能として提供されています。従来型のヒストグラムは通常 le ラベル付きの _bucket 系列を使います。ネイティブヒストグラムではクエリの形が変わります。Prometheus の OTLP 機能フラグ(英語) · ヒストグラムのクエリ(英語)
Guance に送るときは、DataKit の OpenTelemetry インプット(英語)またはPrometheus のスクレイプ用インプット(英語)を使います。二つの経路を並行して比較するときは系列を分け、同じサンプルを誤って重複集計しないようにします。受信できたら、クエリ結果、アラートルール、通知先を順に確かめます。
よくある質問
OpenTelemetry は Prometheus に取って代わりますか? 役割が異なります。OpenTelemetry の計装や Collector を追加しても、メトリクスの保存、PromQL、ルール評価を既存の Prometheus に任せられます。
Prometheus から Guance へ移すとき、何を確認しますか? DataKit は exporter をスクレイプするか、転送されたメトリクスを受け取れます。実際に移す時系列、ダッシュボード、記録ルール、アラート、通知経路を洗い出し、必要な動作を確認します。
Collector と Prometheus Agent モードはどこが重なりますか? どちらもメトリクスをスクレイプして転送できます。Agent モードは Prometheus のスクレイプとサービスディスカバリーを使い、Remote Write で送り、ローカルのクエリやルール評価は行いません。Collector は複数の信号を受け取り処理できます。既存のパイプライン、転送先のプロトコル、必要な加工で選びます。
Guance で PromQL は使えますか? Guance のメトリクス分析などで PromQL を使えます。データソース、メトリクス名、ラベル、対象期間を確認します。DQL に書き換える場合は、その言語でレートや集計を検証します。通知の振り分けはクエリと別に確認します。
関連記事
- 前の記事 OpenTelemetry のメトリクス(英語)
- 次の記事 OpenTelemetry と Prometheus のメトリクス比較(簡体字中国語)
- 関連 OpenTelemetry とは? · Prometheus を OpenTelemetry のバックエンドにする(簡体字中国語) · 技術ガイド一覧
参考資料 OpenTelemetry と Prometheus の互換性(英語) · Prometheus と Alertmanager のアラート処理(英語) · DataKit 文書(英語) · Guance の監視(英語)
