OBI のエクスポートモードを構成する

OTLP エンドポイントへ直接データをエクスポートするように OBI を構成する

Direct モードでは、OBI は OpenTelemetry protocol(OTLP)を使用して、メトリクスとトレースをリモートエンドポイントへ直接プッシュします。

OBI は、たとえば プル モードでスクレイプできるように、Prometheus HTTP エンドポイントを公開することもできます。

Direct モードを使用するには、認証情報を含む構成が必要です。 OTLP エンドポイントの認証情報は、次の環境変数で設定します。

  • OTEL_EXPORTER_OTLP_ENDPOINT
  • OTEL_EXPORTER_OTLP_HEADERS

Prometheus のスクレイプエンドポイントを使用して Direct モードで実行する方法については、構成ドキュメントを参照してください。

OBI の構成と実行

このチュートリアルでは、OBI と OTel Collector が同じホスト上でネイティブに実行されていることを前提としています。 そのため、トラフィックを保護したり、OTel Collector の OTLP レシーバーで認証を提供したりする必要はありません。

OpenTelemetry eBPF Instrumentation をインストールし、サンプルの構成ファイルをダウンロードしてください。

まず、計装する実行ファイルを指定します。 ポート 443 で実行されているサービスの実行ファイルの場合は、YAML ドキュメントに open_port プロパティを追加します。

discovery:
  instrument:
    - open_ports: 443

次に、トレースとメトリクスの送信先を指定します。 OTel collector がローカルホストで実行されている場合は、ポート 4318 を使用します。

otel_metrics_export:
  endpoint: http://localhost:4318
otel_traces_export:
  endpoint: http://localhost:4318

メトリクス、トレース、またはその両方をエクスポートするには、otel_metrics_exportotel_traces_export プロパティの組み合わせを指定できます。

名前付きの構成ファイルを指定して OBI を実行します。

obi -config instrument-config.yml

あるいは次のように実行します。

OTEL_EBPF_CONFIG_PATH=instrument-config.yml obi