OpenTelemetry 與 Prometheus 的差異與搭配方式

比較埋點、收集、儲存與告警各由誰負責,並說明 OTLP 接收設定,以及更換路徑時如何核對標籤與彙總口徑。

最佳實務
指標收集、儲存與視覺化示意

假設結帳請求一變慢,Prometheus 原有的告警就會響。加上 OpenTelemetry 的 Span 之後,你能看出時間花在哪段,原有告警也可以繼續跑。要是連指標的傳送路徑都改成 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 埋點,把 Span 匯出到追蹤後端。原本的 Prometheus 仍能回答結帳變慢的頻率。

若基礎設施已使用 node_exporter,而且儀表板和告警依賴 Prometheus,可以沿用這條路徑。Collector 的 hostmetrics 接收器也能收集主機指標,採用前要核對名稱與標籤是否符合原有規則。

各種訊號可以各自使用後端。若希望在觀測雲一起查看指標、追蹤和日誌,可將各訊號送到支援的接收器,再檢查用來關聯資料的欄位。

三種搭配方式

  1. 以 OpenTelemetry 埋點,用 Prometheus 儲存指標。 SDK 有 Prometheus 匯出器時可公開擷取端點。也能讓 Collector 的 Prometheus 匯出器公開端點,或透過 OTLP/HTTP 將指標推送到已啟用接收功能的 Prometheus Server。追蹤和日誌可另外匯出。
  2. 用 Collector 處理並送往觀測雲。 Collector 可依訊號接收資料,再轉送到各自的目的地。Prometheus 接收器負責擷取,Prometheus 匯出器負責公開可擷取的端點,Prometheus Remote Write 匯出器則將請求推送到相容接收端。Remote Write 與 OTLP 是不同協定。
  3. 沿用 Prometheus,再接到觀測雲。 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 匯出器規範(英文),個別訊號的變數要填完整 URL。若使用通用 OTEL_EXPORTER_OTLP_ENDPOINT,基礎路徑填 /api/v1/otlp,再由匯出器附加 /v1/metrics。正式環境應按實際接收入口設定存取控制與 TLS。

換傳送路徑前,核對指標的含義

先挑一個已知指標,核對名稱、標籤、單位和數值。在 Prometheus 的 OTLP 接收端,otlp.translation_strategy 會影響名稱和標籤。資源屬性也不會全數附到每條時間序列。若有對應屬性,service.name、service.namespace 和 service.instance.id 會用來組成 job 與 instance。原本以擷取位址篩選 instance 的查詢,切到 OTLP 後可能找不到資料。

也要確認彙總口徑。計數器的 rate() 與 increase() 以累積值為前提。若收到的是增量,要核對部署版本和設定。Prometheus 自 v3.2 起可用 --enable-feature=otlp-deltatocumulative 轉成累積值。支援原生增量寫入的版本另有實驗旗標,兩種模式只能擇一。傳統直方圖通常查帶有 le 標籤的 _bucket 序列,原生直方圖的查詢寫法不同。Prometheus OTLP 功能旗標(英文) · 直方圖查詢(英文)

接入觀測雲時,依 DataKit OpenTelemetry 收集器(簡體中文)或 Prometheus 擷取收集器(簡體中文)的文件設定。要平行比較兩條路徑時,先將對照序列分開,避免把同一批樣本算兩次。確認資料送達後,再驗證查詢、規則行為與通知路由。

常見問題

OpenTelemetry 會取代 Prometheus 嗎? 兩者負責不同的工作。加入 OpenTelemetry 埋點和 Collector 後,既有 Prometheus 仍能儲存指標、執行 PromQL 及評估規則。

從 Prometheus 搬到觀測雲,要核對什麼? DataKit 可擷取 exporter 或接收轉送的指標。先盤點要保留的序列、儀表板、記錄規則、告警與通知路由。搬遷工作量取決於需要維持的行為。

Collector 和 Prometheus Agent 模式有何重疊? 兩者都能擷取和轉送指標。Prometheus Agent 沿用抓取與服務探索,透過 Remote Write 送出資料,本機不提供查詢與規則評估。Collector 可接收並處理多種訊號,選擇時要看既有管線、目的地的協定和需要的處理。

觀測雲可以用 PromQL 嗎? 觀測雲的指標分析等入口支援 PromQL(簡體中文)。先確認資料來源、指標名稱、標籤和時間範圍。若改用 DQL,要重新驗證速率和彙總結果。通知路由則需單獨核對。

延伸閱讀

參考資料 OpenTelemetry 與 Prometheus 相容性(英文) · Prometheus 告警與 Alertmanager(英文) · DataKit 文件(簡體中文) · 觀測雲監控(簡體中文)

取得專屬方案

聯絡我們

加入社群

微信扫码
加入官方交流群

立即體驗

在线开通,按量计费,真正的云服务!

立即開始

选择观测云版本

代码托管平台