Run OBI as a standalone process

Learn how to setup and run OBI as a standalone Linux process.

Ви переглядаєте англійську версію сторінки, тому що її ще не було повністю перекладеною українською. Бажаєте допомогти? Дивіться як взяти Участь.

PS. Неофіційний український переклад (не перевірений і не ухвалений OpenTelemetry) доступний на сайті члена спільноти, створеному на основі PR #5891. Ми надаємо це посилання як тимчасовий захід підтримки українських читачів та потенційних учасників, доки не буде готовий офіційний переклад.

OBI can run as a standalone Linux OS process with elevated privileges that can inspect other running processes.

Download and install

You can get OBI by extracting the necessary files from the container image.

IMAGE=otel/ebpf-instrument:main
docker pull $IMAGE
ID=$(docker create $IMAGE)
docker cp $ID:ebpf-instrument .
docker cp $ID:obi-java-agent.jar .
docker rm -v $ID

It is important that both ebpf-instrument and obi-java-agent.jar are located in the same directory.

Set up OBI

  1. Create a configuration file following the configuration options documentation. You can start with the OBI configuration YAML example.

  2. Run OBI as a privileged process:

sudo ./ebpf-instrument --config=<path to config file>

Permissions

OBI requires elevated privileges to function properly. For more information about the specific capabilities required, see the security documentation.


Востаннє змінено January 31, 2026: Fix Run OBI as a standalone process doc (#9077) (06662af2)