OpenTelemetry 最佳實務:從自動埋點到取樣

沿著一筆請求檢查埋點與上下文傳播,設定資源屬性、選擇 Collector 部署方式,並找出適合做追蹤取樣的階段。

最佳實務
系統連線與遙測資料流示意圖

結帳的追蹤裡有 HTTP 伺服器 Span,也看得到資料庫呼叫,卻還是無法判斷訂單為何遭拒。調低取樣率後,想查的失敗追蹤甚至找不到了。前一個問題在於應用程式記了什麼,後一個在於管線留下了什麼。

這篇 OpenTelemetry 實務指南沿著一筆請求,從埋點走到儲存。過程中可以看出哪裡需要補上業務資訊、Collector 應該放在哪裡,以及什麼時候適合決定是否保留追蹤。

從執行環境支援的埋點開始

Java Agent 可以在執行時替支援的函式庫加上埋點。Python 零程式碼埋點與 Node.js 埋點套件各有支援的函式庫與訊號範圍。先核對應用程式裡的版本,再查看後端實際收到什麼。HTTP Span 能顯示請求出錯,但要分辨付款遭拒或庫存保留逾時,仍需要應用程式記錄業務結果。

在現有資料解釋不了的處理環節補上自訂 Span。結果值可限定為 accepted、declined、timeout 等少數選項。如果已有合適的 Span,就在函式庫支援時補上屬性。打算自行初始化 Provider 前,先確認使用中的埋點套件或發行版是否已經處理。OpenTelemetry 零程式碼埋點(英文)

保持服務名稱穩定,讓上下文跨過服務邊界

資源屬性描述遙測資料的來源。service.name 記錄邏輯服務名稱,service.version 記錄服務版本。環境則使用現行語義規範中的 deployment.environment.name。副本替換或版本更新時,服務名稱仍應一致。若執行環境支援標準 SDK 環境變數,可用以下方式設定測試環境:

export OTEL_SERVICE_NAME=checkout
export OTEL_RESOURCE_ATTRIBUTES=service.version=1.8.0,deployment.environment.name=staging

接著確認後端實際儲存的欄位。單次作業的資訊可記在 Span 上,請求 ID 等高基數值則避免當成指標維度。在服務邊界確認傳送方會注入追蹤上下文、接收方能擷取。Baggage 會另外傳遞,預設不會變成 Span 屬性。當中應避免放入憑證或個人資料。部署環境資源規範(英文) · OpenTelemetry Baggage(英文) · 上下文傳播

依需求決定 Collector 的位置

後端若支援 SDK 使用的訊號、協定與驗證方式,可以直接傳送。需要收集主機本機資料,或希望接收端靠近工作負載時,可以用代理型 Collector。需要統一處理多個服務的資料、設定路由或出口時,閘道型 Collector 較合適。兩者可以搭配,但每一段都要有清楚的責任,並納入遙測管線的監控。Collector 部署模式(英文)

批次處理可以合併匯出請求。傳送佇列與重試能否吸收短暫中斷,取決於匯出器、佇列容量與重試設定。只放在記憶體中的待送資料,會隨處理程序結束而消失。若採用持久化佇列,重新啟動後仍須能存取原本的儲存空間。監看佇列用量、接收拒絕與匯出失敗。資料跨越信任邊界前先去除敏感欄位,再檢查實際送出的內容。Collector 韌性(英文) · 監控 Collector

在資訊足夠的階段做取樣

頭部取樣在請求的早期決定。以父 Span 為依據的取樣器可以沿用傳入的決定,並對新的根 Span 套用機率規則。尾部取樣則先接收 Span,再根據錯誤或延遲等條件判斷。SDK 已捨棄的 Span,即使之後發現錯誤也無法補回。

多個 Collector 做尾部取樣時,要把相同 Trace ID 的 Span 路由到同一個取樣實例。普通的請求負載平衡可能把一筆追蹤分到不同副本。拉長判斷時間前,先看 Span 的到達延遲、佇列容量與記憶體用量。應用程式的請求量和錯誤量可用獨立的指標路徑彙總。若指標由 Span 產生,則需確認彙總前經過哪些取樣與篩選。OpenTelemetry 取樣(英文) · 依 Trace ID 進行 Collector 路由(英文)

用一筆已知請求核對整條路徑

依照 DataKit OpenTelemetry 接收設定(簡體中文)讓匯出器與接收端使用相同的 OTLP 傳輸方式。使用 HTTP 時,也要核對各訊號的接收路徑。從入口服務送出一筆測試請求,在觀測雲追蹤詳情(簡體中文)確認同步呼叫的 Trace ID、父子 Span 關係,以及服務名稱、環境與版本。

某一段 Span 不見時,依序檢查埋點範圍、上下文傳遞、取樣與匯出。更換接收端或後端時,另外驗證既有的處理與取樣規則。若要估算自動埋點的開銷,在相同工作負載下比較啟用前後的啟動時間、延遲與資源使用量。

延伸閱讀 · 什麼是 OpenTelemetry? · 用 Collector 處理敏感資料

取得專屬方案

聯絡我們

加入社群

微信扫码
加入官方交流群

立即體驗

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

立即開始

选择观测云版本

代码托管平台