Run OBI as a standalone process
Vous consultez la version anglaise de cette page car elle n’a pas encore été entièrement traduite. Vous souhaitez contribuer ? Voir Contribuer.
OBI can run as a standalone Linux OS process with elevated privileges that can inspect other running processes.
Download and verify
OBI provides pre-built binaries for Linux (amd64 and arm64). Download the latest release from the releases page. Each release includes:
obi-v<version>-linux-amd64.tar.gz- Linux AMD64/x86_64 archiveobi-v<version>-linux-arm64.tar.gz- Linux ARM64 archiveSHA256SUMS- Checksums for verification
Set your desired version and architecture:
# Set your desired version (find latest at
# https://github.com/open-telemetry/opentelemetry-ebpf-instrumentation/releases)
VERSION=0.6.0
# Determine your architecture
# For Intel/AMD 64-bit: amd64
# For ARM 64-bit: arm64
ARCH=amd64
# Download the archive for your architecture
wget https://github.com/open-telemetry/opentelemetry-ebpf-instrumentation/releases/download/v${VERSION}/obi-v${VERSION}-linux-${ARCH}.tar.gz
# Download checksums
wget https://github.com/open-telemetry/opentelemetry-ebpf-instrumentation/releases/download/v${VERSION}/SHA256SUMS
# Verify the archive
sha256sum -c SHA256SUMS --ignore-missing
# Extract the archive
tar -xzf obi-v${VERSION}-linux-${ARCH}.tar.gz
The archive contains:
obi- Main OBI binaryk8s-cache- Kubernetes cache binaryLICENSE- Project licenseNOTICE- Legal noticesNOTICES/- Third-party licenses and attributions
Starting in OBI v0.6.0, the Java agent is embedded in the obi binary. No
separate obi-java-agent.jar file is required. At runtime, OBI extracts and
caches the embedded Java agent under $XDG_CACHE_HOME/obi/java (or
~/.cache/obi/java).
The cache directory is determined by the user account running obi. When you
use sudo, the cache will typically be created under the root user’s cache
directory (for example /root/.cache/obi/java) unless you override it. For
system or service deployments, set XDG_CACHE_HOME to a suitable location
(for example XDG_CACHE_HOME=/var/cache/obi sudo -E obi ...) or configure an
explicit cache path according to your environment.
Install to system
After extracting the archive, you can install the binaries to a location in your PATH so they can be used from any directory.
The following example installs to /usr/local/bin, which is a standard location
on most Linux distributions. You can install to any other directory in your
PATH:
# Move binaries to a directory in your PATH
sudo cp obi /usr/local/bin/
# Verify installation
obi --version
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 obi --config=<path to config file>If you did not install OBI to your PATH, you can run it from the extracted directory:
sudo ./obi --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
Cette page est-elle utile?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!