# Configure OBI

> Learn how to configure OBI.

---

LLMS index: [llms.txt](/llms.txt)

---

You can configure OBI by setting [export modes](export-modes/), global
properties, and component options.

For information on the metrics OBI exports, refer to the
[exported metrics](../metrics/) documentation.

Refer to the [routes decorator](routes-decorator/) documentation to configure
the low cardinality routes decorator. It's very important for optimal results.

## Configuration versions

Use Config v2 with OBI v0.11.0 and later. It works with standalone OBI and the
OBI Collector receiver, uses the OpenTelemetry declarative configuration
structure for common settings, and places OBI-specific settings under
`extensions.obi`.

- To write a new configuration, start with the
  [Config v2 reference](config-v2/).
- To convert an existing Config v1 file, follow the
  [Config v1 to v2 migration guide](migrate-to-config-v2/).

Unless otherwise noted, the other pages in this section describe Config v1. Each
page links to the corresponding Config v2 guidance.

---

Section pages:

- [Configure OBI export modes](/ro/docs/zero-code/obi/configure/export-modes/): Configure OBI to export data directly to an OTLP endpoint
- [OBI global configuration properties](/ro/docs/zero-code/obi/configure/options/): Configure global configuration properties that apply to OBI core.
- [OBI Config v2 reference](/ro/docs/zero-code/obi/configure/config-v2/): Learn how to configure standalone OBI or the OBI Collector receiver with Config v2.
- [Migrate from OBI Config v1 to Config v2](/ro/docs/zero-code/obi/configure/migrate-to-config-v2/): Learn how to safely migrate an OBI Config v1 file to Config v2.
- [Configure OBI Prometheus and OpenTelemetry data export](/ro/docs/zero-code/obi/configure/export-data/): Configure the OBI components to export Prometheus and OpenTelemetry metrics and OpenTelemetry traces
- [Configure OBI service discovery](/ro/docs/zero-code/obi/configure/service-discovery/): Configure how the OBI service discovery component searches for processes to instrument.
- [Configure OBI metrics and traces attributes](/ro/docs/zero-code/obi/configure/metrics-traces-attributes/): Configure the metrics and traces attributes component that controls the attributes reported, including instance ID decoration and metadata of instrumented Kubernetes pods.
- [Filter metrics and traces by attribute values](/ro/docs/zero-code/obi/configure/filter-metrics-traces/): Configure OBI to filter metrics and traces by attribute values.
- [Configure OBI routes decorator](/ro/docs/zero-code/obi/configure/routes-decorator/): Configure the routes decorator component before OBI sends data to the next stage of the pipeline.
- [Configure OBI Prometheus and OpenTelemetry metrics histograms](/ro/docs/zero-code/obi/configure/metrics-histograms/): Configure metrics histograms for Prometheus and OpenTelemetry, and whether to use native histograms and exponential histograms.
- [Configure OBI OpenTelemetry trace sampling](/ro/docs/zero-code/obi/configure/sample-traces/): Configure how to sample OpenTelemetry traces.
- [OBI as OpenTelemetry Collector receiver](/ro/docs/zero-code/obi/configure/collector-receiver/): Learn how to use OBI as a receiver component in the OpenTelemetry Collector for centralized telemetry processing.
- [Configure the OBI internal metrics reporter](/ro/docs/zero-code/obi/configure/internal-metrics-reporter/): Configure how the optional internal metrics reporter component reports metrics on the internal behavior of the auto-instrumentation tool in Prometheus format.
- [Configure OBI performance](/ro/docs/zero-code/obi/configure/tune-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.
- [OBI Config v1 YAML example](/ro/docs/zero-code/obi/configure/example/): Example Config v1 YAML file for OBI.