v1.traces 總覽

本文說明為何建議您使用 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」(記錄檔分析) 頁面查看追蹤記錄資料。詳情請參閱下列文章: