Configure OBI performance

Configure how the eBPF tracer component instruments HTTP and GRPC services of external processes and creates traces to forward to the next stage of the pipeline.

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.

You can use the eBPF tracer to fine-tune OBI performance.

You can configure the component under the ebpf section of your YAML configuration or with environment variables.

YAML
environment variable
DescriptionTypeDefault
wakeup_len

OTEL_EBPF_BPF_WAKEUP_LEN

Sets how many messages OBI accumulates in the eBPF ring buffer before sending a wake-up request to user space. Refer to wake up length.string(unset)
traffic_control_backend

OTEL_EBPF_BPF_TC_BACKEND

Selects the backend for attaching traffic control probes. Refer to the traffic control backend section for details.stringauto
http_request_timeout

OTEL_EBPF_BPF_HTTP_REQUEST_TIMEOUT

Sets the time interval after which OBI considers an HTTP request a timeout. Refer to the HTTP request timeout section for details.string(0ms)
high_request_volume

OTEL_EBPF_BPF_HIGH_REQUEST_VOLUME

Sends telemetry events as soon as OBI detects a response. Refer to the high request volume section for details.boolean(false)

Wake up length

OBI accumulates messages in the eBPF ringbuffer and sends a wake-up request to user space when it reaches this value.

For high-load services, set this option higher to reduce CPU overhead.

For low-load services, high values can delay when OBI submits metrics and when they become visible.

Traffic control backend

This option selects the backend for attaching traffic control probes. Linux 6.6 adds support for TCX, a file-descriptor based traffic control attachment. TCX is more robust, doesn’t require explicit qdisc management, and chains probes deterministically. We recommend the tcx backend for kernels >= 6.6. When set to auto, OBI chooses the best backend for your kernel.

Accepted backends: tc, tcx, and auto. If you leave this value empty or unset, OBI uses auto.

HTTP request timeout

This option sets how long OBI waits before considering an HTTP request a timeout. OBI can report HTTP transactions that time out and never return. Set this option to a non-zero value to enable automatic HTTP request timeouts. When a request times out, OBI reports HTTP status code 408. Disconnects can look like timeouts, so setting this value may increase your request averages.

High request volume

This option makes OBI send telemetry events as soon as it detects a response. It reduces timing accuracy for requests with large responses, but in high-volume scenarios, it helps reduce dropped trace events.


Última modificación July 24, 2025: integrate grafana/beyla#2085 (7467f09f)