本文說明會實作 OpenTelemetry OTLP 通訊協定的遙測 (OTLP) API。這個 API 專為使用 OpenTelemetry SDK 檢測的應用程式而設計。
為何應使用 Telemetry API
Telemetry API 支援擷取 OTLP 格式的追蹤記錄資料。使用 Telemetry API 時，資料會以 OTLP 格式儲存，不會轉換為專屬格式，且會套用 Telemetry API 的限制。這些限制通常比 Cloud Trace API 的限制更寬鬆。最後，您的檢測功能不會依賴 Google Cloud專屬的匯出程式。
OpenTelemetry 是 Google Cloud支援的開放原始碼專案， Google Cloud工程師會全力支援擷取及視覺化追蹤資料。
Telemetry API 的使用時機
在檢測應用程式以傳送追蹤資料至Google Cloud 專案時，建議您執行下列任一操作：
- 使用匯出工具將 OTLP 寫入收集器，再將追蹤資料傳送至 Telemetry API。
- 使用由 OpenTelemetry 程式庫支援的程序內 OTLP 匯出工具，該程式庫會將遙測資料傳送至 Telemetry API。沒有使用此設定的收集器。
如要瞭解如何使用 Telemetry API，請參閱「從 Cloud Trace 匯出器遷移至 OTLP 端點」一文。
查看攝入資料的位置
您可以使用「Trace 探索工具」頁面查看透過 Telemetry API 擷取的追蹤記錄資料。如要瞭解如何查看追蹤記錄資料，請參閱「尋找及探索追蹤記錄」。
透過 Telemetry API 攝入的追蹤記錄資料無法供舊版 Trace Explorer 頁面使用。詳情請參閱「舊版 Trace Explorer：已知問題」。
VPC Service Controls 支援
Telemetry API 服務 (服務名稱為 telemetry.googleapis.com) 是 VPC Service Controls 支援的服務。您為 Telemetry API 服務建立的任何 VPC Service Controls 限制，只會套用至該服務。這些限制不適用於任何其他服務，包括 cloudtrace.googleapis.com 服務這類也能擷取追蹤資料的服務。
如要瞭解詳情，請參考下列資源：