OBI Quickstart guides
Learn how to set up and run OBI to instrument multiple languages.
Estás viendo la versión en inglés de está página porque aún no ha sido traducida. ¿Te interesa ayudar? Mira en Contribuir.
OpenTelemetry libraries provide telemetry collection for popular programming languages and frameworks. However, getting started with distributed tracing can be complex. In some compiled languages like Go or Rust, you must manually add tracepoints to the code.
OpenTelemetry eBPF Instrumentation is an auto-instrumentation tool to easily get started with Application Observability. OBI uses eBPF to automatically inspect application executables and the OS networking layer, and capture trace spans related to web transactions and Rate Errors Duration (RED) metrics for Linux HTTP/S and gRPC services. All data capture occurs without any modifications to application code or configuration.
OBI offers the following features:
OBI requires the following to run:
OBI is tested with the following Linux distributions:
OBI also supports RedHat-based distributions: RHEL8, CentOS 8, Rocky8, AlmaLinux8, and others, which ship a Kernel 4.18 that backports eBPF-related patches.
For instrumenting Go programs, compile with at least Go 1.17. OBI support Go applications built with a major Go version no earlier than 3 versions behind the current stable major release.
Administrative access rights to execute OBI.
OBI has its limitations too. It only provides generic metrics and transaction level trace span information. Language agents and manual instrumentation is still recommended, so that you can specify the custom attributes and events you want to capture.
While most eBPF programs require elevated privileges, OBI allow you to specify
finer grained permissions to run with minimum required permissions, such as:
CAP_DAC_READ_SEARCH
, CAP_SYS_PTRACE
, CAP_PERFMON
, CAP_BPF
,
CAP_CHECKPOINT_RESTORE
, and others.
Some OBI functionality requires further permissions, for example using the
network observability probes with Linux Traffic Control requires
CAP_NET_ADMIN
, but it’s a feature you have to optionally enable.
For a comprehensive list of capabilities required by OBI, refer to Security, permissions and capabilities.
Learn how to set up and run OBI to instrument multiple languages.
Learn how to configure Beyla.
Configuring OBI to observe point-to-point network metrics.
Learn how to set up and run OBI.
Learn how to use the OBI RED metrics dashboard.
Learn about the HTTP/gRPC metrics Beyla can export.
Learn about Beyla’s distributed traces support.
How to measure total request times from the point of view of the client
Privileges and capabilities required by OBI
Compatibility notes when running OBI alongside Cilium
Beyla runs alongside your applications and has a minimal impact on performance. Find out about the methodology we used to measure the performance overhead.
Overview of how to calculate the cardinality of metrics produced by a default OBI installation, considering the size and complexity of the instrumented environment.
¿Fue útil esta página?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!