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 上でメトリクス、トレース、ログをまとめて調べたいなら、信号ごとに対応するインプットへ送り、関連付けに使うフィールドを確認します。

組み合わせ方は三つある

  1. OpenTelemetry で計装し、Prometheus に保存する。 SDK が対応していれば Prometheus exporter でスクレイプ先を公開できます。Collector の Prometheus exporter で公開する方法や、受信を有効にした Prometheus Server に OTLP/HTTP でメトリクスを送る方法もあります。トレースとログは別に送れます。
  2. Collector で処理して Guance に送る。 Collector が信号を受け取り、設定した宛先へ転送します。Prometheus receiver は対象をスクレイプします。Prometheus exporter はスクレイプ先を公開します。Prometheus Remote Write exporter は対応する受信先へ Remote Write リクエストを送ります。OTLP とは別のプロトコルです。
  3. 既存の 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 と Prometheus の互換性(英語) · Prometheus と Alertmanager のアラート処理(英語) · DataKit 文書(英語) · Guance の監視(英語)

最適なプランを相談する

お問い合わせ

コミュニティに参加

WeChatでスキャンして
コミュニティに参加

Guanceを試す

オンラインですぐに始めて、使った分だけお支払いください。

利用を開始

Guanceのプランを選択

コードリポジトリ