本文說明為何建議您使用 Telemetry (OTLP) API 將追蹤記錄資料傳送至Google Cloud 專案,因為該 API 會實作 OpenTelemetry OTLP 通訊協定。此外,這項服務也提供應用程式檢測指引,以及查看追蹤資料的位置。使用 OpenTelemetry SDK 檢測應用程式時,或使用 OpenTelemetry Collector 時,都可以使用 Telemetry API。
建議使用 Telemetry API 的原因如下:
這個 API 可與開放原始碼 OpenTelemetry 生態系統相容,而且限制通常比 Cloud Trace API 更寬鬆,後者是專有 Google Cloud API
追蹤資料的儲存格式通常與 OpenTelemetry OTLP 通訊協定定義的 proto 檔案一致。某些欄位可能會先從 OpenTelemetry 專屬資料類型轉換為 JSON 資料類型,再進行儲存。如要進一步瞭解儲存格式,請參閱追蹤資料的結構定義。
您的檢測不依賴 Google Cloud專屬的匯出工具。
部分功能 (例如應用程式監控) 只能在您將追蹤資料傳送至 Telemetry API 時使用。
OpenTelemetry 是 Google Cloud支援的開放原始碼專案, Google Cloud有專責工程師確保支援擷取及顯示遙測資料。
最佳做法
將應用程式設為將追蹤資料傳送至Google Cloud 專案時,建議您採取下列其中一種做法:
- 使用將 OTLP 寫入 Collector 的匯出工具,然後將追蹤記錄資料傳送至 Telemetry API。
- 使用 OpenTelemetry 程式庫支援的程序內 OTLP 匯出器,將遙測資料傳送至 Telemetry API。沒有符合這項設定的收集器。
如要瞭解如何使用 Telemetry API,請參閱「從 Cloud Trace 匯出工具遷移至 OTLP 端點」。
驗證
您必須使用必要憑證設定匯出工具,才能將追蹤資料傳送至 Google Cloud 專案。舉例來說,如要使用Google Cloud 應用程式預設憑證 (ADC) 設定匯出工具,請在應用程式中加入特定語言的 Google Auth 程式庫。如需更多資訊和程式碼範例,請參閱「設定驗證」。
Cloud Trace 和資料落地
如果您因為有資料駐留或影響層級 4 (IL4) 的需求而使用 Assured Workloads,請勿使用 Telemetry API 將追蹤範圍傳送至專案。
查看擷取資料的位置
您可以使用「Trace Explorer」(追蹤記錄探索工具) 和「Log Analytics」(記錄檔分析) 頁面查看追蹤記錄資料。詳情請參閱下列文章: