Run OBI as a standalone process
You are viewing the English version of this page because it has not yet been fully translated. Interested in helping out? See Contributing.
OBI can run as a standalone Linux OS process with elevated privileges that can inspect other running processes.
Download and install
We are working on providing a standalone binary distribution. To track planned updates, see open-telemetry/opentelemetry-ebpf-instrumentation#13.
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
Create a configuration file following the configuration options documentation. You can start with the OBI configuration YAML example.
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.
Feedback
Was this page helpful?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!