OpenTelemetry eBPF 計装

OpenTelemetry ライブラリは、一般的なプログラミング言語やフレームワーク向けのテレメトリー収集機能を提供します。 しかし、分散トレーシングの導入は複雑になる場合があります。 Go や Rust などの一部のコンパイル型言語では、コードにトレースポイントを手動で追加する必要があります。

OpenTelemetry eBPF 計装（OBI）は、アプリケーションのオブザーバビリティを簡単に開始するための自動計装ツールです。 OBI は eBPF を使用して、アプリケーションの実行可能ファイルと OS ネットワーク層を自動的に検査し、Web トランザクションや Linux HTTP/S および gRPC サービスの Rate Errors Duration（RED）指標に関連するトレーススパンをキャプチャします。 すべてのデータキャプチャは、アプリケーションのコードや構成を変更することなく行われます。

OBI は以下の機能を提供します。

• 幅広い言語サポート: Java（JDK 8+）、.NET、Go、Python、Ruby、Node.js、C、C++、および Rust
• 軽量: コード変更不要、ライブラリインストール不要、再起動不要
• 効率的な計装: トレースとメトリクスは、最小限のオーバーヘッドで eBPF プローブによってキャプチャ
• 分散トレーシング: 分散トレーススパンがキャプチャされ、Collector に送信される
• ログエンリッチメント: JSON ログをトレースコンテキストでエンリッチしてトレースと相関させる
• Kubernetes ネイティブ: Kubernetes アプリケーションに構成不要の自動計装を提供
• 暗号化された通信の可視性: TLS/SSL 経由のトランザクションを復号化せずにキャプチャ
• コンテキスト伝搬: サービス間でトレースコンテキストを自動的に伝搬
• プロトコルサポート: HTTP/S、gRPC、gRPC-Web、JSON-RPC、MQTT、Memcached など
• データベース計装: PostgreSQL（pgx ドライバーを含む）、MySQL、MongoDB、Redis、Couchbase（N1QL/SQL++ および KV プロトコル）
• 生成AI 計装: OpenAI、Anthropic Claude、Google AI Studio（Gemini）、および AWS Bedrock API 呼び出しのトレースとメトリクス（ペイロードの自動抽出を含む）
• 低カーディナリティメトリクス: コスト削減のための低カーディナリティの Prometheus 互換メトリクス
• ネットワークのオブザーバビリティ: ホストレベルの TCP RTT 統計とともにサービス間のネットワークフローをキャプチャ
• 強化されたサービスディスカバリー: DNS 解決によるサービス名の検索の改善
• Collector との統合: OBI を OpenTelemetry Collector レシーバーコンポーネントとして実行

最近のハイライト（v0.8.0）

OBI v0.8.0 は、プロトコルカバレッジ、ペイロード抽出、およびデプロイメントドキュメントを拡張しました。

• 汎用 Go トレーシングの改善: 汎用リクエストのコンテキスト伝搬を含む、汎用 Go プロトコルサポートを追加
• プロトコルカバレッジの拡大: すべての言語で JSON-RPC サポートを追加
• より深い HTTP ペイロード抽出: 完全な HTTP ボディ抽出を追加し、レスポンスボディの制限付き解凍をサポート
• より広い生成 AI カバレッジ: Google AI Studio（Gemini）と AWS Bedrock のペイロード抽出を追加し、Vertex AI Gemini サポートを修正
• 名前付き CIDR ラベル: ネットワークメトリクスで設定された CIDR 範囲に人間が読みやすい名前をラベル付けできるようになりました
• 新しいサンプルシナリオ: 既存の NGINX ウォークスルーに加えて、Apache HTTP Server のサンプルを追加
• サポートドキュメント: リリース成果物とサポートされる環境のプロジェクトサポートマトリクスを追加

完全な変更リストとアップグレードノートについては、 リリースノートを参照してください。

上流のサンプルを確認するには、 NGINX ウォークスルーと Apache ウォークスルーを参照してください。

OBI の仕組み

以下の図は、OBI の高レベルアーキテクチャと、eBPF 計装がテレメトリーパイプラインにどのように適合するかを示しています。

互換性

OBI は、以下の要件を満たす Linux 環境をサポートしています。

OBI は以下のサポートされたリリース成果物を公開しています。

OBI は、要件を満たす環境であれば、スタンドアロン Linux ホスト、コンテナ、および Kubernetes にデプロイできます。

OBI は、Linux 以外のオペレーティングシステム、amd64 および arm64 以外の Linux アーキテクチャ、BTF のない Linux 環境、またはドキュメントに示されている 4.18+ の RHEL ファミリーという例外を除き、Linux 5.8 より古いカーネルバージョンをサポートしていません。

機能固有のサポートの詳細については、以下のガイドに記載されています。

• 分散トレース: コンテキスト伝搬のサポート、ランタイム固有の要件、および分散トレーシングの制限
• データのエクスポート: プロトコル、データベース、メッセージング、生成AI、GPU、および Go ライブラリ計装のサポート

制限事項

OBI は、コード変更なしにアプリケーションとプロトコルのオブザーバビリティを提供しますが、すべてのシナリオで言語レベルの計装を置き換えるものではありません。 カスタムスパン、アプリケーション固有の属性、ビジネスイベント、または eBPF ベースの計装が自動的に取得できないその他のインプロセステレメトリーが必要な場合は、言語エージェントまたは手動による計装を使用してください。

OBI はネットワークとプロトコルのアクティビティを自動的にキャプチャできますが、eBPF 観測ポイントから見えないアプリケーション固有の詳細を常に復元できるわけではありません。

一部の機能には、コアプラットフォーム要件よりも追加の注意事項やサポート範囲の制限があります。 詳細については、分散トレースとエクスポートされた計装の機能固有のドキュメントを参照してください。

OBI が必要とするケーパビリティの包括的なリストについては、セキュリティ、権限、およびケーパビリティを参照してください。

OBI を使い始める

• Docker または Kubernetes で OBI を使い始めるには、セットアップドキュメントに従ってください。
• トレースとログの相関について学び、トレースとアプリケーションログを接続し、JSON ログをトレースコンテキストでエンリッチします。
• 集中テレメトリー処理のために OBI を Collector レシーバーとして実行する方法を確認します。

トラブルシューティング

• 一般的な問題のヘルプについては、トラブルシューティングガイドを参照してください。