OBI の構成
OBI の構成方法を学びます。
OpenTelemetry ライブラリは、一般的なプログラミング言語やフレームワーク向けのテレメトリー収集機能を提供します。 しかし、分散トレーシングの導入は複雑になる場合があります。 Go や Rust などの一部のコンパイル型言語では、コードにトレースポイントを手動で追加する必要があります。
OpenTelemetry eBPF 計装(OBI)は、アプリケーションのオブザーバビリティを簡単に開始するための自動計装ツールです。 OBI は eBPF を使用して、アプリケーションの実行可能ファイルと OS ネットワーク層を自動的に検査し、サポートされた Linux ワークロードのトレーススパン、Rate Errors Duration(RED)指標、ランタイム指標、アプリケーションおよびネットワークの関係をキャプチャします。 すべてのデータキャプチャは、アプリケーションのコードや構成を変更することなく行われます。
OBI は以下の機能を提供します。
OBI v1.0.0 は最初の安定リリースです。 以下の互換性を保証します。
go.opentelemetry.io/obi のパブリック Go API。stable に分類されたテレメトリー。これらの保証を破る変更には新しいメジャーバージョンが必要です。 マイナーリリースは互換性のある機能を追加でき、パッチリリースは互換性を維持します。 リリースノートとバージョニングポリシーを参照してください。
コレクターレシーバーは v0 リリースラインで個別にバージョン管理されています。
stable とマークされていないテレメトリーと属性は引き続き変更される可能性があり、セマンティック規約の整合が進められている間はネットワークフロー属性名も同様です。
テレメトリーの安定性を参照してください。
v0.15.2 のままです。
コアの v1.0.0 は個別に選択してください。
コレクターレシーバーのセットアップを参照してください。0.15.2 から 1.0.0 に変更されます。
スキーマは以前の変換を保持し、新しいリネームは追加されません。
スキーマの制限についてはテレメトリーの安定性を参照してください。v1.0.0-rc.1 または v0.15.2 より前のリリースからアップグレードする場合は、v0.15.2 リリースノートでスパン名、デフォルトのメトリクス属性、Prometheus ラベル、および Go 設定 API の変更を確認してください。 v0.14.0 より前のリリースからアップグレードする場合は、v0.14.0 リリースノートも確認してください。 ロールアウト中は既知の運用上の制限事項を確認してください。
上流のサンプルを確認するには、 NGINX ウォークスルーと Apache ウォークスルーを参照してください。
以下の図は、OBI の高レベルアーキテクチャと、eBPF 計装がテレメトリーパイプラインにどのように適合するかを示しています。
OBI は、以下の要件を満たす Linux 環境をサポートしています。
| 要件 | サポート対象 |
|---|---|
| CPU アーキテクチャ | amd64、arm64 |
| Linux カーネル | 5.8+、または必要な eBPF バックポートが適用された RHEL ファミリーのカーネルバージョン 4.18+ の Linux |
| カーネル機能 | BTF |
| 権限 | Root、または有効化された OBI 機能に必要な Linux ケーパビリティ |
OBI は以下のサポートされたリリース成果物を公開しています。
| 成果物 | サポートされるプラットフォーム |
|---|---|
obi バイナリアーカイブ | Linux amd64, Linux arm64 |
otel/ebpf-instrument コンテナイメージ | Linux amd64, Linux arm64 |
otel/opentelemetry-ebpf-k8s-cache コンテナイメージ | Linux amd64, Linux arm64 |
OBI は、要件を満たす環境であれば、スタンドアロン Linux ホスト、コンテナ、および Kubernetes にデプロイできます。
サポートマトリクスで、サポートされた環境と機能固有の要件を定義しています。
OBI は、Linux 以外のオペレーティングシステム、amd64 および arm64 以外の Linux アーキテクチャ、BTF のない Linux 環境、またはドキュメントに示されている 4.18+ の RHEL ファミリーという例外を除き、Linux 5.8 より古いカーネルバージョンをサポートしていません。
機能固有のサポートの詳細については、以下のガイドに記載されています。
OBI は、コード変更なしにアプリケーションとプロトコルのオブザーバビリティを提供しますが、すべてのシナリオで言語レベルの計装を置き換えるものではありません。 カスタムスパン、アプリケーション固有の属性、ビジネスイベント、または eBPF ベースの計装が自動的に取得できないその他のインプロセステレメトリーが必要な場合は、言語エージェントまたは手動による計装を使用してください。
OBI はネットワークとプロトコルのアクティビティを自動的にキャプチャできますが、eBPF 観測ポイントから見えないアプリケーション固有の詳細を常に復元できるわけではありません。
一部の機能には、コアプラットフォーム要件よりも追加の注意事項やサポート範囲の制限があります。 詳細については、分散トレースとエクスポートされた計装の機能固有のドキュメントを参照してください。
既知の制限事項と未解決の報告には以下が含まれます。
outgoing の宛先が表示されたり、同じサービスに対して Kubernetes 名と OpenTelemetry 名が別々に表示されたりすることがあります。
サービスグラフの制限事項を参照してください。OBI が必要とするケーパビリティの包括的なリストについては、セキュリティ、権限、およびケーパビリティを参照してください。
OBI の構成方法を学びます。
OBI をポイントツーポイントのネットワークメトリクスの観察用に設定する
OBIのセットアップと実行方法を学びます。
OBI がエクスポートできる HTTP/gRPC メトリクスについて学びます。
OBI が必要とする権限とケーパビリティ
OBI の一般的な問題やエラーのトラブルシューティング
クライアント側から見たリクエスト全体の時間を計測する方法
OBI の分散トレースサポートについて学びます。
OBI を Cilium と並行して実行する際の互換性に関する注意事項
分散トレースのために、OBI が送信リクエストを受信した親リクエストにどのように関連付けるかを学びます。
計装される環境のサイズと複雑さを考慮した、デフォルトの OBI インストールで生成されるメトリクスのカーディナリティの算出方法の概要。
より迅速なデバッグとトラブルシューティングのために、OBI がアプリケーションログを分散トレースとどのように相関付けるかを学びます。
このページは役に立ちましたか?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!