本文說明 Telemetry (OTLP) API，該 API 會實作 OpenTelemetry OTLP 通訊協定。這個 API 適用於使用 OpenTelemetry SDK 檢測的應用程式。
使用 Telemetry API 的好處
OpenTelemetry 是 Google Cloud支援的開放原始碼專案， Google Cloud工程師會確保支援擷取及顯示追蹤記錄資料。
使用 Telemetry API 時，資料會以與 OpenTelemetry OTLP 通訊協定定義的 proto 檔案大致一致的格式儲存。不過，欄位可能會先從 OpenTelemetry 專屬資料類型轉換為 JSON 資料類型，再進行儲存。此外，遙測 API 的限制也適用。 這些限制通常比 Cloud Trace API 的限制寬鬆。最後，您的檢測工具不依賴 Google Cloud專屬的匯出工具。
如要進一步瞭解儲存格式，請參閱追蹤資料的結構定義。
Telemetry API 的使用時機
將應用程式設為將追蹤資料傳送至Google Cloud 專案時，建議您採取下列任一做法：
- 使用將 OTLP 寫入 Collector 的匯出工具，然後將追蹤資料傳送至 Telemetry API。
- 使用 OpenTelemetry 程式庫支援的程序內 OTLP 匯出工具，將遙測資料傳送至 Telemetry API。沒有符合這項設定的收集器。
如要瞭解如何使用 Telemetry API，請參閱「從 Cloud Trace 匯出工具遷移至 OTLP 端點」。
如何查看擷取的資料
透過 Telemetry API 擷取的追蹤資料，可使用「追蹤記錄探索工具」頁面查看。如要瞭解如何查看追蹤記錄資料，請參閱「尋找及探索追蹤記錄」。
驗證
匯出者必須獲得授權，才能將資料傳送至您的 Google Cloud 專案。舉例來說，您可以在應用程式中加入特定語言的 Google Auth 程式庫，藉此使用 Google Cloud 應用程式預設憑證 (ADC) 設定匯出工具。如需詳細資訊和程式碼範例，請參閱「設定驗證」。
VPC Service Controls 支援
服務名稱為 telemetry.googleapis.com 的 Telemetry API 服務支援 VPC Service Controls。您為 Telemetry API 服務建立的任何 VPC Service Controls 限制，只會套用至該服務。這些限制不適用於任何其他服務，包括 cloudtrace.googleapis.com 服務等，這些服務也能擷取追蹤資料。
如要瞭解詳情，請參考下列資源：