OpenTelemetry 是 Google Cloud支援的開放原始碼專案, Google Cloud有專責工程師確保支援遙測資料的擷取和視覺化。
如要進一步瞭解這項 API,請參閱下列參考文件:
最佳做法
監測應用程式以將追蹤記錄資料傳送至Google Cloud 專案時,建議您使用匯出工具,將 OTLP 格式的資料寫入 Collector,然後將追蹤記錄資料傳送至 Telemetry API。在收集器中,只指定根網址:
exporters:
otlphttp:
encoding: proto
endpoint: https://telemetry.googleapis.com
OpenTelemetry 會偵測資料類型,並視情況自動附加 /v1/traces、/v1/metrics 或 /v1/logs。詳情請參閱「OTLP/HTTP 要求」。
如需將追蹤或指標資料匯出至 Telemetry API 的範例,請參閱下列文件:
如果無法使用收集器,可以改用含有程序內 OTLP 匯出器的 OpenTelemetry 程式庫,將遙測資料傳送至 Telemetry API。如要瞭解如何直接匯出追蹤資料,請參閱「Cloud Trace exporter to the OTLP endpoint」。
驗證
您必須使用必要憑證設定匯出工具,才能將資料傳送至 Google Cloud 專案。舉例來說,使用收集器時,通常也會使用 googleclientauth 擴充功能,透過 Google 憑證進行驗證。
如需使用直接匯出追蹤資料時的驗證範例,請參閱「設定驗證」。這個範例說明如何使用 Google Cloud 應用程式預設憑證 (ADC) 設定匯出工具,以及如何將特定語言的 Google Auth 程式庫新增至應用程式。
VPC Service Controls 支援
服務名稱為 telemetry.googleapis.com 的 Telemetry API 服務支援 VPC Service Controls。您為 Telemetry API 服務建立的任何 VPC Service Controls 限制,只會套用至該服務。這些限制不適用於任何其他服務,包括 cloudtrace.googleapis.com 服務等,這些服務也能擷取追蹤資料。
如要瞭解詳情,請參考下列資源: