返回首頁

GitHub Repo

Dify 提出 OTLP/HTTP 追蹤整合,讓代理執行紀錄接入通用觀測管線

Dify 社群於 11 月 5 日提出 OpenTelemetry 追蹤提供者,讓應用與代理可向相容的收集器匯出執行紀錄。提案支援 HTTP/protobuf,但尚未合併,完整 CI 與端到端驗證仍待完成。

The original uploader was Ggia at Greek Wikipedia. · CC BY-SA 2.5 · Image source
zh-Hant

Dify 社群於 2026 年 11 月 5 日提交 PR #45659,提議加入通用 OpenTelemetry 追蹤提供者,讓應用與代理透過 OTLP/HTTP 匯出執行紀錄,不必先選擇特定觀測廠商的整合。截至查核時,提案仍處於開放審查階段,不能視為正式版本已提供的功能。提案與狀態

這項設計的重點是保留追蹤結構。依作者說明,匯出內容包含 trace 與 span 識別碼、父子關係、時間、狀態、結構化輸入輸出,以及可取得的模型與 token 屬性;傳送則沿用既有管線,不另建匯出執行緒,也不設定程序全域的 OpenTelemetry 狀態。對已有收集器的團隊而言,其潛在價值是將代理執行資料接入既有觀測系統,但跨服務串接效果仍須實測。設計說明

協定與端點設定是部署時的關鍵。OpenTelemetry 規範將 HTTP 與 gRPC 列為不同傳輸方式;HTTP 追蹤通常送往 /v1/traces,使用通用基底端點與追蹤專用端點時,路徑組合規則也不同。因此,工程師不能只核對主機與連接埠,還須確認接收端的協定、編碼及完整路徑。OTLP 匯出設定規範

提案目前支援 HTTP/protobuf,設定欄位包含端點、標頭、服務名稱與資源屬性。作者也將標頭憑證設計為加密且僅供寫入,變更匯出目的地時須重新輸入或明確清除;這使目的地修改同時成為憑證處理的一部分。設定與憑證設計

後續應關注維護者審查及完整驗證。作者公布了局部回歸測試結果,但明確表示尚未完成目標分支完整 CI,也未宣稱通過完整節點端到端或長時間負載驗證。準備試用的團隊仍需確認追蹤完整性、接收端相容性與失敗時的交付行為,再評估正式部署。驗證限制

來源

  1. feat(trace): add OpenTelemetry OTLP HTTP provider — Dify PR #45659
  2. OpenTelemetry Protocol Exporter