OBIをスタンドアロンプロセスとして実行する

OBIをLinuxのスタンドアロンプロセスとしてセットアップして実行する方法を学びます。

OBIは、他の実行中プロセスを検査できる昇格された権限を持つスタンドアロンのLinux OSプロセスとして実行できます。

ダウンロードとインストール

OBIの実行可能ファイルは、OBIリリースページからダウンロードできます。

OBIのセットアップ

  1. 構成オプションドキュメントに従って構成ファイルを作成します。

  2. OBIを特権プロセスとして実行します。

sudo ./obi --config=<構成ファイルのパス>

構成例

構成ファイルの例(obi-config.yml)を示します。

# 基本設定
discovery:
  services:
    - name: my-service
      open_ports: [8080, 8090]
      exe_path: /usr/local/bin/my-service

# トレース構成
traces:
  # トレース有効化
  enabled: true

  # OpenTelemetryエンドポイント
  otlp_endpoint: http://localhost:4318

  # トレースフォーマット
  format: otlp

# メトリクス構成
metrics:
  # メトリクス有効化
  enabled: true

  # OpenTelemetryエンドポイント
  otlp_endpoint: http://localhost:4318

  # メトリクスフォーマット
  format: otlp

# ログ構成
log_level: info

OBIの実行

構成ファイルを使用してOBIを実行します。

sudo ./obi --config=obi-config.yml

構成オプション

構成オプションの完全なリストについては、構成ドキュメントを参照してください。

権限

OBIが適切に機能するには、昇格された権限が必要です。 具体的に必要なケーパビリティの詳細については、セキュリティドキュメントを参照してください。

例: Dockerの計装

Dockerコンテナの計装するために、ホスト上でOBIを実行できます。

sudo ./obi --config=obi-config.yml

コンテナを対象とする構成です。

discovery:
  services:
    - name: my-container-service
      open_ports: [8080]
      exe_path: /proc/*/root/app/my-app

例: システム全体の計装

システム上のすべてのサービスを計装します。

discovery:
  services:
    - name: all-services
      open_ports: [80, 443, 8080, 8443]

log_level: info

この構成では、指定されたポードでリッスンしているすべてのプロセスが計装されます。


最終更新 September 8, 2025: [ja]Translate content/en/docs/zero-code/setup/standalone.md (#7726) (ee77dbed)