将 OBI 作为独立进程运行

了解如何将 OBI 设置为独立的 Linux 进程并运行。

OBI 可以作为具有更高权限的独立 Linux OS 进程运行,该进程可以检查其他正在运行的进程。

下载和安装

您可以从 OBI releases 页面 下载 OBI 可执行文件。

设置 OBI

  1. 按照 配置选项 文档创建一个配置文件。

  2. 以特权进程运行 OBI

sudo ./obi --config=<path to config file>

示例配置

这是一个示例配置文件 (obi-config.yml)

# Basic configuration
discovery:
  services:
    - name: my-service
      open_ports: [8080, 8090]
      exe_path: /usr/local/bin/my-service

# Traces configuration
traces:
  # Enable tracing
  enabled: true

  # OpenTelemetry endpoint
  otlp_endpoint: https://:4318

  # Trace format
  format: otlp

# Metrics configuration
metrics:
  # Enable metrics
  enabled: true

  # OpenTelemetry endpoint
  otlp_endpoint: https://:4318

  # Metrics format
  format: otlp

# Logging configuration
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

此配置将仪表化正在侦听指定端口的所有进程。


最后修改于 2025 年 8 月 11 日:迁移 beyla 文档以支持 OBI (#7399) (c6df1ca9)