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 接收器也能收集主機指標,採用前要核對名稱與標籤是否符合原有規則。
各種訊號可以各自使用後端。若希望在觀測雲一起查看指標、追蹤和日誌,可將各訊號送到支援的接收器,再檢查用來關聯資料的欄位。
三種搭配方式
- 以 OpenTelemetry 埋點,用 Prometheus 儲存指標。 SDK 有 Prometheus 匯出器時可公開擷取端點。也能讓 Collector 的 Prometheus 匯出器公開端點,或透過 OTLP/HTTP 將指標推送到已啟用接收功能的 Prometheus Server。追蹤和日誌可另外匯出。
- 用 Collector 處理並送往觀測雲。 Collector 可依訊號接收資料,再轉送到各自的目的地。Prometheus 接收器負責擷取,Prometheus 匯出器負責公開可擷取的端點,Prometheus Remote Write 匯出器則將請求推送到相容接收端。Remote Write 與 OTLP 是不同協定。
- 沿用 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 指標(英文)
- 下一篇 OpenTelemetry 與 Prometheus 的指標模型比較(簡體中文)
- 相關文章 什麼是 OpenTelemetry? · 用 Prometheus 作為 OpenTelemetry 後端(簡體中文) · 可觀測性技術指南
參考資料 OpenTelemetry 與 Prometheus 相容性(英文) · Prometheus 告警與 Alertmanager(英文) · DataKit 文件(簡體中文) · 觀測雲監控(簡體中文)
