eBPFによるオブザーバビリティ:収集の仕組みと実践

LinuxのeBPFフック、検証器、権限とカーネル要件を解説。DataKitによるネットワーク観測とOpenTelemetryの計装を組み合わせる方法も紹介します。

ベストプラクティス
システムイベントと実行経路の図

APIが遅くなっても、アプリケーションログに異常が出るとは限りません。TCPの再送、接続失敗、往復時間を見ると、調べる範囲を絞れます。リクエスト処理のどこに時間がかかったかを知るには、アプリケーション側のSpanも役に立ちます。

LinuxのeBPFでは、カーネルの検証を通ったプログラムを選んだフックで実行できます。アプリケーションのコードやバイナリを変更せずに観測できる場合があります。eBPFの起源は、パケットフィルターである従来のBPF(Berkeley Packet Filter)です。この記事ではプローブの選び方と、得られた信号をアプリケーションのテレメトリーと組み合わせる方法を見ていきます。LinuxのBPFシステムコール(英語)

最初に押さえるポイント

  • 選んだフックが発火するとeBPFプログラムが実行されます。ロード前にカーネルの検証器が制御フローやメモリーアクセスの制約を確認します。
  • システムやネットワークの共通信号は、複数のアプリケーション言語にまたがって取得できます。ユーザー空間のプローブは対象バイナリ、実行環境、フックに依存し、収集にはリソースも必要です。
  • 操作名や業務情報はアプリケーション側の計装で補えます。OpenTelemetryにはeBPFを利用する自動計装ツールOBIもあります。

eBPFがLinuxのイベントを取得する仕組み

Linuxには既存のトレースポイントなど、実行中のイベントを公開する機能があります。eBPFを使うと、その場でフィルタリング、集計、出力をプログラムできます。検証器はプログラムの経路、レジスターの使用、メモリーアクセスを確認します。有界ループに対応したカーネルでは、終了を証明できるループを受け入れます。JITの利用はカーネル設定とアーキテクチャによります。カーネル検証器(英語) · 有界ループを導入した変更(英語) · Linux BPF(英語)

フックには、システムコールの開始と終了、カーネル関数のkprobe、ユーザー空間の関数のuprobe、静的トレースポイント、ネットワーク経路上のXDPやTCがあります。取得できる情報はフックによって変わります。コンテナではノードのLinuxカーネルを使い、アタッチできる範囲は権限とセキュリティポリシーの影響を受けます。libbpfの概要(英語) · kprobe(英語) · uprobe(英語)

カーネルの情報が役に立つ場面

  1. アプリケーションの変更を抑える。 ビルドし直せないサービスでも、必要な情報がシステムやネットワークのフックにあれば収集できます。
  2. 言語をまたいで共通の信号を見る。 Java、Go、C++、Rustのサービスも同じカーネルインターフェースを利用します。ユーザー空間の関数やプロトコルを扱うときは、実行環境、シンボル、プロトコルに合わせます。
  3. 出力前に集計する。 たとえば接続ごとのバイト数をBPFマップで数え、ユーザー空間から一定間隔で読み取ります。フックの頻度、処理内容、出力量が負荷を左右します。
  4. リクエスト処理の外側を調べる。 対応するプローブでTCP再送やファイルI/Oが見えます。TLS暗号化後のデータしか見えない位置でも、接続の挙動は観測できます。HTTPメソッドやパスを得るには、対応するアプリケーション層のデータが必要です。

まずプローブを一つ試す

  1. ツールと権限を確認する。 許可を得たLinuxテスト環境を使います。bpftool feature probe kernelはプログラムやマップの型、ヘルパーの対応状況を表示します。BCCにはプローブ開発用のPythonインターフェースがあります。ロードやアタッチに必要なトレース、ネットワークなどの権限は、プログラムと環境によって変わります。bpftoolの機能確認(英語)
  2. BCCのkprobe例を読む。 チュートリアルのhello_fields.pyはget_syscall_fnname("clone")でアーキテクチャに合うシステムコールのシンボルを取得し、kprobeをアタッチします。シンボルを確認して、制御されたテストの出力を観察します。記録はその入口を通ったことを示します。プロセスの作成成功数を数えるには、スレッド、失敗、別の作成経路を考慮してイベントを選びます。BCC Pythonチュートリアル(英語)
  3. マップでカウンターを持つ。 カーネルプログラムとユーザー空間はそれぞれのインターフェースでBPFマップにアクセスできます。まず接続単位の通信量を定期的に読み、観測範囲を広げる前にマップ容量とイベント欠落を確認します。

例は公開資料に基づきます。さらに試す場合はBCC(英語)、libbpf-bootstrap(英語)、Go向けのcilium/ebpf(英語)を参照できます。

Guanceでは、DataKitのebpf-netでTCP接続統計、RTT、再送を確認し、必要に応じてUDPやプロトコルの収集を追加します。Linuxノードのアーキテクチャ、DataKitのバージョン、eBPF・kprobe・perfの対応状況、文書に記載されたroot権限を確認します。Kubernetesでは対応するデプロイマニフェストでホストのマウントと権限も確認します。ネットワーク統計とトレースは別の設定です。実験的なebpf-traceは別途有効にし、eBPF Spanをebpftrace受信側が有効なDataKitまたはDataKit ELinkerへ送ります。ノードをまたぐSpanを組み立てる場合は、対象ノードのSpanを同じ受信先に集めます。対象プロトコルと取得範囲はプラグインと環境によります。DataKit eBPF(英語) · eBPFトレース(英語) · DataKitのデプロイと権限(英語)

OpenTelemetryと組み合わせる

eBPFはイベントを取得・処理する仕組みです。OpenTelemetryは計装、テレメトリーの規約、転送の仕組みを提供します。両者が重なる例がOpenTelemetry OBI(英語)です。eBPFを使って、対応するLinuxワークロードからアプリケーションの信号を取得します。

観点 eBPFによる収集 OpenTelemetryによるアプリケーション計装
導入 アプリケーションのコードをそのまま使える場合が多い。Linuxのフックと権限が必要。 言語とツールに応じてSDKでの計装やゼロコード方式を選ぶ。
信号 システムやネットワークの挙動。対応範囲でプロトコル解析も可能。 計装や設定に応じたフレームワークの操作、独自の業務属性。
言語 カーネル信号は言語をまたげる。ユーザー空間のプローブは実行環境やシンボルに依存する場合がある。 SDKや自動計装ごとに対応言語・フレームワークがある。
用途 接続統計、ネットワーク診断、ランタイムセキュリティ。 リクエストトレース、業務コンテキスト、カスタムメトリクス。

OpenTelemetryで操作名と業務コンテキストを記録し、同じ時間帯のRTT、再送、接続失敗をeBPFで調べます。時間の重なりは原因を絞る手がかりです。リクエスト単位で対応付けるには、伝播するトレースコンテキストか別の確かな識別子が要ります。OpenTelemetryのゼロコード計装(英語) · コンテキスト伝播(英語)

よくある質問

どのカーネルバージョンが必要ですか? コレクターが使うプログラム型、ヘルパー、フックを、実際のカーネルとディストリビューションのバックポートに照らして確認します。BTFは型のメタデータです。CO-REは対象カーネルの型情報を使ってレイアウト差に対応します。プログラムに必要な機能は対象環境でも利用できる必要があります。BTF(英語) · libbpfとCO-RE(英語)

負荷はどれくらい増えますか? フックの頻度、処理内容、出力量によって変わります。高頻度のイベントは必要に応じて絞り込みや集計をします。代表的な負荷で、収集側のCPU、メモリー、イベント欠落、アプリケーションの遅延を確認します。

APMのプローブを置き換えられますか? 対応するプロトコルや実行環境でアプリケーションのSpanを作れるツールがあります。業務属性、メソッド単位の時間、サービス間のコンテキストが足りなければ、SDKやAgentなどの計装で補います。

セキュリティ監視にも使えますか? TetragonはeBPFを使って実行時の観測とポリシー適用を行います。FalcoはモダンeBPFプローブからカーネルイベントを取得でき、カーネルモジュールドライバーにも対応します。導入条件はツールとドライバーによります。Tetragon(英語) · Falcoのカーネルイベント(英語)

関連記事

資料確認日 2026年11月6日。

最適なプランを相談する

お問い合わせ

コミュニティに参加

WeChatでスキャンして
コミュニティに参加

Guanceを試す

オンラインですぐに始めて、使った分だけお支払いください。

利用を開始

Guanceのプランを選択

コードリポジトリ