Google Cloudの新しいトレースエンドポイントTelemetry APIについて調べてみた

Google Cloudの新しいトレースエンドポイント Telemetry APIについて調べてみた

自己紹介髙橋和真 (Takahashi Kazuma) クラウドエース株式会社 DevSecOps事業部 Specialist Work Google
Cloudを中心としたシステムの開発、運用を担当 Tech SRE O11y Serverless Award Google Cloud Partner Top Engineer 2025 SNS X：@kazzuvi Github：@kazuvi

話すこと最近（4月頭ぐらい）リリースされたTelemetry API について、Cloud Trace APIとの比較や注目点について話します

OTLP とは OTLP (OpenTelemetry Protocol) は、テレメトリ（ログ、メトリクス、トレース）を転送するための標準化されたプロトコル特徴 • OpenTelemetryの標準プロトコルで、ログ、メトリクス、
トレースを統一的に扱う • ベンダーや言語に依存せず、多様な監視・分析ツールとの連携を容易にする • O11yパイプラインにおけるデータ収集・転送の相互運用性を高める

Telemetry API とは Google Cloud Observabilityの新しいテレメトリーデータ受付エンドポイント OTLP形式のトレースデータをCloud Traceに取り込む •
OTLP/HTTP & gRPCプロトコルをネイティブサポート従来のCloud Trace APIとの違い • 標準準拠: OTLP形式のまま保存 • 制限緩和: 従来のCloud Trace APIより制限が緩和されている

標準準拠 Google Cloud専用のエクスポーター・変換が不要に！

制限緩和リッチなコンテキスト情報を欠落させずに Cloud Traceへ送信可能に！項目 Telemetry API Cloud Trace API
緩和状況スパンあたりの属性数 1024個 32個 32倍スパンあたりのイベント数 256個 128個 2倍属性値の最大サイズ 64KiB 256Bytes 大幅緩和スパン名の最大長 1024Bytes 128Bytes 8倍 ...

使い方（アプリから直接送っている場合の移行方法） 1. Google Cloud Exporterの使用をOTLP Exporterに置き換える 2. 認証情報を設定する 3.
Exporterのエンドポイントを https://telemetry.googleapis.comに変更する

使い方（コレクターから送る場合）ブログに書いています（宣伝、時間ないので割愛） Telemetry API がリリースされたので OTLP で Google Cloud にスパンを送ってみた

注意点 Telemetry APIは現時点でトレースデータのみ対応しているメトリクスやログも送信する場合は、 Cloud Trace API / 専用Exporterを使う必要がある

まとめ • 標準準拠 ◦ OTLP形式のまま送れる、ベンダー非依存性を向上 • 制限緩和 ◦ Cloud Trace
APIと比較して、リッチなデータを送信可能 • 現状トレースのみ → Telemetry APIは、Google Cloudで　 O11yを実現する上で重要な選択肢になります！

最後に Google CloudとOpenTelemetryエコシステムの連携が深まっていくことに期待します

Google Cloudの新しいトレースエンドポイントTelemetry APIについて調べてみた

Google Cloudの新しいトレースエンドポイントTelemetry APIについて調べてみた

kazz

More Decks by kazz

Other Decks in Technology

Featured

Transcript