OpenTelemetry Demo 實作:追查 Astronomy Shop 的付款失敗

用 Docker Compose 啟動 OpenTelemetry Demo 3.1.0,在 Jaeger 比對正常結帳和付款失敗的追蹤,並透過 Collector 把追蹤另送一份到觀測雲。

最佳實務
查看應用程式遙測資料的插圖

結帳失敗很適合當作 OpenTelemetry Demo 的第一個練習。瀏覽器會顯示訂單未成立,追蹤則能告訴你結帳服務有沒有呼叫付款服務,以及扣款呼叫在哪裡失敗。官方範例 Astronomy Shop 已經加上埋點,可以直接練習查這條路徑。

本文使用 Demo 3.1.0,依該版原始碼核對 Compose 檔、代理路由和付款行為。本次驗證未啟動完整容器堆疊,也未執行外部 DataKit 接入。

連同可觀測性元件啟動 Demo

Astronomy Shop 包含商店前端、商品目錄、購物車、結帳、付款等服務,使用多種程式語言。完整 Compose 部署還會啟動 Kafka,以及會計和詐欺偵測等消費端。Collector、Jaeger、Prometheus、OpenSearch 和 Grafana 可用來查看不同訊號。各服務提供的訊號不同,查資料前可先看產生的遙測文件。 Demo 架構(英文) · 遙測涵蓋範圍(英文)

請使用獨立測試機器,準備 Docker 與 Compose v2。官方列出的完整模式需求為應用程式記憶體 6 GB 和磁碟空間 14 GB。上游 Compose 會掛載主機路徑和 Docker socket,也會對主機開放連接埠,請保持環境隔離並使用範例資料。 Docker 部署條件(英文) · Demo 3.1.0 發行版

git clone --branch 3.1.0 --depth 1 https://github.com/open-telemetry/opentelemetry-demo.git
cd opentelemetry-demo
export DEMO_VERSION=3.1.0
docker compose --env-file .env --env-file .env.override \
  -f compose.yaml -f compose.full.yaml \
  -f compose.observability.yaml -f compose.extras.yaml up -d

直接執行 docker compose up 只會讀取核心設定。上面四個檔案另外加上 Kafka、可觀測性後端與最後套用的自訂設定。等商店與觀測工具所需的服務就緒後,再開啟入口。

本機位址 可確認的內容
http://localhost:8080/ 開啟商店並送出測試訂單。
http://localhost:8080/jaeger/ui/ 查找該訂單的追蹤。
http://localhost:8080/grafana/ 查看已配置的儀表板和資料來源。
http://localhost:8080/loadgen/ 查看 Demo 的合成流量。
http://localhost:8080/feature/ 在本機 flagd 介面變更故障開關。
http://localhost:8080/telemetry/ 查各服務已記錄的遙測項目。

比較正常結帳和付款失敗

先把 paymentFailure 設為 off,用 Demo 預填的付款資料送出測試訂單,記下時間。在 Jaeger 選擇 checkout,查該時間窗的請求,沿追蹤進到 payment,找到 charge span。如果背景流量太多,可縮小查詢時間窗,或在比較期間暫停負載產生器。

到 flagd 介面將 paymentFailure 的預設變體設為 100% 並儲存,再送出一筆範例訂單。固定版本的付款處理函式會把失敗機率設為 1,產生合成錯誤,並將 charge span 標成錯誤。比對兩條追蹤,找出最早出錯的步驟。練習後把開關恢復為 off。 功能開關(英文) · 3.1.0 付款處理原始碼

失敗的 span 可解釋兩筆請求的差異,指標則能看出同一時段的整體流量與錯誤變化。若服務有輸出帶追蹤 ID 的日誌,可用它補充細節。找不到日誌時,先核對服務的輸出範圍和日誌管線。

看資料怎麼通過 Collector

應用程式透過 OTLP 將資料送到 Demo Collector。核心設定定義接收和處理,可觀測性層把追蹤送往 Jaeger、指標送往 Prometheus,日誌送往 OpenSearch。span_metrics 連接器也會從 span 產生指標。若要加一個目的地,可透過最後一層設定完成,應用程式的匯出位址可以沿用。 固定版本核心設定 · 固定版本可觀測性層

也可在完整模式把同一筆訂單追到 Kafka 消費端。確認上下文有沒有傳遞,以及 span 是父子關係還是透過 link 連結。測試取樣時,觀察追蹤政策如何影響保留的資料。要縮小整個實驗的合成流量,應調整負載產生器。追蹤取樣不會一併降低指標和日誌的流量。

把追蹤另送一份到觀測雲

若 Collector 容器能透過私有網路連到 DataKit 接收端,可先轉送追蹤。在 src/otel-collector/otelcol-config-extras.yml 增加 OTLP/HTTP Protobuf 匯出器,並接上原本的 traces 管線。範例位址請換成實際可達的 DataKit 端點。DataKit 文件所列的預設 HTTP 埠為 9529,追蹤路徑為 /otel/v1/traces。請依部署方式設定 TLS 和驗證。 DataKit OpenTelemetry 收集器(簡體中文)

exporters:
  otlp_http/datakit:
    traces_endpoint: https://datakit.example.com/otel/v1/traces
service:
  pipelines:
    traces:
      exporters: [debug, otlp_grpc/jaeger, span_metrics, otlp_http/datakit]

這份清單適用上面的四層啟動方式。Collector 合併設定時會取代陣列,因此要在新清單保留 Jaeger、debug 和 span_metrics。套用後以相同 Compose 層重啟 Collector,重新送出測試請求,在觀測雲核對服務名稱和 span 層級。指標和日誌需各自設定訊號端點與管線,範例保留了這兩條既有路徑。

實驗時的常見問題

完整模式太吃資源怎麼辦? 官方精簡模式保留可觀測性元件,省略 Kafka 及其相依服務。Docker 指南估計應用程式需約 3 GB 記憶體。沿用官方模式可保留相依關係。

埋點可以直接用在正式環境嗎? 可參考相應語言的 SDK 範例,再按實際環境設定資源識別、取樣和敏感資料處理。實驗請使用範例資料,保留原始敏感資料相關開關的停用狀態。

可以用 Kubernetes 部署嗎? 官方 Helm chart 是另一種部署方式。請在測試叢集依文件設定 values、資源和連接埠轉送。 Kubernetes 部署(英文)

延伸閱讀

取得專屬方案

聯絡我們

加入社群

微信扫码
加入官方交流群

立即體驗

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

立即開始

选择观测云版本

代码托管平台