OpenTelemetryとは? テレメトリーの収集と転送の仕組み
OpenTelemetry の API、SDK、Collector、OTLP がトレース、メトリクス、ログをどう扱うかを解説。各コンポーネントの成熟度と Guance への連携方法も紹介します。
リクエストの応答時間が伸びたことは、メトリクスで分かります。処理のどこで時間を使ったかはトレースで追えます。その処理で何が起きたかは、ログに手がかりがあるかもしれません。複数の言語で動くサービスから、これらのデータを同じ分析基盤に届けるには、収集と転送の仕組みが必要です。
OpenTelemetry(OTel)は、テレメトリーの生成、収集、エクスポートを担う CNCF のオープンソースフレームワークです。 OpenTracing と OpenCensus の統合から生まれました。API、SDK、Collector、OTLP を使うことで、計装を活かしながら、対応するバックエンドへデータを送れます。
OpenTelemetry の要点
- OTel はデータの生成、収集、転送を扱います。長期保存、クエリ、分析はバックエンドが担います。
- 主な構成要素は、仕様とセマンティック規約、各言語の API と SDK、Collector、OTLP です。
- OTLP のトレース、メトリクス、ログの転送仕様は安定版です。SDK、自動計装ライブラリ、Collector の各コンポーネントには、それぞれの成熟度があります。
- まず一つのサービスから一種類のデータを送ると、構成を広げる前に経路を確認しやすくなります。
テレメトリーとは
テレメトリーは、システムが稼働中に出すデータです。ログは個々の出来事を記録し、メトリクスは計測値の推移を示し、トレースはリクエストに伴う処理をたどります。詳しくはログ・メトリクス・トレースの違いと使い分けをご覧ください。プロファイルを使うと、CPU 時間などのリソースがどのコードに使われているかを調べられます。収集形式や転送方式が特定のバックエンドに依存していると、移行時に計装や収集設定の変更が必要になることがあります。
OpenTelemetry で解決できること
- バックエンドへの依存を減らす。 移行先が同じ信号を受け取れるなら、既存の計装を活かせます。移行前にはエクスポート設定、フィールドの変換、受け入れ可能な信号を確認します。ダッシュボードやアラートルールはバックエンド側の設定です。
- 異なる言語のデータをそろえる。 Java、Go、Python、Node.js などで共通のデータモデルを使えます。実際に出るフィールドは、計装方法や採用しているセマンティック規約のバージョンによって変わります。
- 計装の重複を減らす。 対応するフレームワークやライブラリの一般的な処理は自動計装で収集できます。対象外の業務処理には API でスパンを追加できます。
- サービスをまたいでリクエストを追う。 サービス間でコンテキストを伝播させると、関連するスパンが一つのトレースにつながります。どこまで検索できるかは、サンプリング、エクスポート、保存状況にも左右されます。
OpenTelemetry を構成する四つの要素
仕様とセマンティック規約
仕様はデータモデルや API の振る舞いを定めます。セマンティック規約(英語)は、HTTP スパンの http.request.method やサービスのリソース属性 service.name のように、名前と意味をそろえるための取り決めです。複数のサービスでクエリを共用する前に、実際に出力される属性を確認してください。
API と SDK
ライブラリは API を使ってスパンを作成したり、計測値を記録したりできます。そのデータを処理して外部へ送る SDK(英語) は、アプリケーション側で設定します。トレースのサンプリング、メトリクスの集約、リソース情報の付加も SDK の役割です。アプリケーションのログを取り込む場合は、対応するログブリッジなどを別途設定します。
Collector
OpenTelemetry Collector(英語) は、特定のベンダーに依存しない転送パイプラインです。receiver で受け取り、必要に応じて processor でフィルタリングや属性の変更を行い、exporter で設定した宛先へ送ります。扱える形式やキュー、再試行の有無は、選んだコンポーネントと設定によって決まります。宛先に障害が続けば、キューが満杯になったり、再試行の期限を超えたりして、データが失われることがあります。
OTLP
OTLP はテレメトリーのエンコードと転送を定めるプロトコルです。gRPC では Protobuf を使い、HTTP でもバイナリの Protobuf を使えます。JSON で送るには送受信側の両方が対応している必要があります。標準のデフォルトポートは gRPC が 4317、HTTP が 4318 です。HTTP は /v1/traces のように信号ごとのパスを使います。設定には実際の受信先のポートとパスを指定します。詳しくは OTLP の解説(簡体字中国語)をご覧ください。
どこまで安定しているか
OTLP 仕様(英語)では、トレース、メトリクス、ログの転送は Stable、Profiles は Development です。これはプロトコルの成熟度です。言語 SDK、自動計装ライブラリ、Collector の receiver や exporter の対応状況は個別に確認してください。言語別 API・SDK のステータス一覧(英語)と、使用する Collector コンポーネントの文書が確認先です。
導入時につまずきやすい点
- 構成要素が多い。 Collector の細かい設定から始めると、何が原因でデータが届かないのか切り分けづらくなります。対応する自動計装を使い、一つのサービスのトレースを確認してから対象を広げます。
- 対応状況に差がある。 言語や信号によって成熟度が異なります。実際に導入するバージョンとコンポーネントで、必要な機能が使えるかを確認します。
- 分析基盤は別途選ぶ。 OTel で収集と転送のインターフェースを共通化できます。データの保存、検索、アラートは Guance などのバックエンドで行います。
テレメトリーを分析基盤へ送る
Guance で分析する場合は、アプリケーションや Collector から DataKit の OpenTelemetry インプット(英語)へ OTLP で送れます。インプットと必要な信号のエクスポートを有効にし、送信元から実際の待ち受けアドレスに到達できるかを確認します。gRPC の設定例にある 127.0.0.1:4317 に接続できるのは、同じネットワーク名前空間内からです。
HTTP では http/protobuf を指定します。DataKit のデフォルトポートは 9529 で、既定のパスは /otel/v1/traces、/otel/v1/metrics、/otel/v1/logs です。信号ごとのエンドポイントには完全な URL を指定します。仕様に従う HTTP エクスポーターで共通の OTEL_EXPORTER_OTLP_ENDPOINT を使う場合、既定のパスに合わせてベース URL を /otel で終わらせます。信号ごとのパスはエクスポーターが付けます。
識別できるリクエストでサービス名とスパンの親子関係を確認します。メトリクスは既知の変化を与え、値と単位、累積値か差分値かを見ます。ログではイベント時刻、重大度、関連付けに使う ID を確認します。意図したデータを検索できたら、ダッシュボードや検知ルールに組み込みます。
よくある質問
OpenTelemetry と Prometheus はどう使い分けますか? Prometheus は主にメトリクスの取得と保存、PromQL によるクエリ、アラートルールの評価に使われます。OTel は複数の信号を生成、転送するための仕組みです。Collector の Prometheus receiver や exporter を使ってメトリクスを連携できます。変換後の指標やラベルも確認してください。OpenTelemetry と Prometheus の比較(簡体字中国語)で詳しく解説しています。
OTel を導入しても監視プラットフォームは必要ですか? 保存、検索、可視化、通知、権限管理が必要なら、それらを担うバックエンドが必要です。Guance は DataKit 経由で対応する OTLP 信号を受け取れます。
古いアプリケーションにも使えますか? ランタイムとライブラリが対応していれば使えます。たとえば Java Agent は、対応ライブラリをソースコードの変更なしで計装できます。起動時の設定とエクスポート先の指定を行い、デプロイ方法に合わせてアプリケーションを再起動します。自動計装で見えない処理はスパンを手動で追加できます。
OpenTelemetry のログ機能で ELK を置き換えられますか? OTel はログの収集や転送の一部を担えます。インデックス作成、検索、分析にはバックエンドが必要です。OTLP ログを DataKit で受け取ったあと、ログに対応する Trace ID などがあり、トレースが検索できる状態なら関連付けられます。
関連記事
- 前の記事:eBPF によるオブザーバビリティ
- 次の記事:OpenTelemetry Collector(英語)
- 関連:OTLP(簡体字中国語) · OpenTelemetry SDK(英語) · 技術ガイド一覧
参考資料:OpenTelemetry 公式文書(英語) · OTLP 仕様(英語) · Guance の OpenTelemetry 連携(英語) · Guance APM · DataKit 文書(英語)
