Ejecutar OBI como un proceso independiente

OBI puede ejecutarse como un proceso independiente del sistema operativo Linux con privilegios elevados que pueden inspeccionar otros procesos en ejecución.

Descargar e instalar

Puedes descargar el ejecutable de OBI desde la página de versiones de OBI.

Configurar OBI

1. Crea un archivo de configuración siguiendo la documentación de opciones de configuración.

2. Ejecuta OBI como un proceso con privilegios:

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

Ejemplo de configuración

A continuación se muestra un ejemplo de archivo de configuración (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: http://localhost:4318

  # Trace format
  format: otlp

# Metrics configuration
metrics:
  # Enable metrics
  enabled: true

  # OpenTelemetry endpoint
  otlp_endpoint: http://localhost:4318

  # Metrics format
  format: otlp

# Logging configuration
log_level: info

Ejecutar OBI

Ejecuta OBI con el archivo de configuración:

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

Opciones de configuración

Para obtener una lista completa de las opciones de configuración, consulta la documentación de configuración.

Permisos

OBI requiere privilegios elevados para funcionar correctamente. Para obtener más información sobre las capacidades específicas necesarias, consulta la documentación de seguridad.

Ejemplo: Instrumentación de Docker

Para instrumentar un contenedor Docker, puedes ejecutar OBI en el host:

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

Con una configuración dirigida al contenedor:

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

Ejemplo: Instrumentación en todo el sistema

Para instrumentar todos los servicios de un sistema:

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

log_level: info

Esta configuración instrumentará todos los procesos que escuchen en los puertos especificados.