Configure Beyla Prometheus and OpenTelemetry metrics histograms
Configure Beyla Prometheus and OpenTelemetry metrics histograms
You can configure Beyla Prometheus and OpenTelemetry metrics histograms. You can also choose to use native histograms and exponential histograms.
Override histogram buckets
You can override the histogram bucket boundaries for OpenTelemetry and
Prometheus metrics exporters by setting the buckets
YAML configuration option:
YAML | Type |
---|---|
duration_histogram | []float64 |
Set the bucket boundaries for metrics related to request duration. Specifically:
http.server.request.duration
(OTEL) /http_server_request_duration_seconds
(Prometheus)http.client.request.duration
(OTEL) /http_client_request_duration_seconds
(Prometheus)rpc.server.duration
(OTEL) /rpc_server_duration_seconds
(Prometheus)rpc.client.duration
(OTEL) /rpc_client_duration_seconds
(Prometheus)
If you leave the value unset, Beyla uses the default bucket boundaries from the OpenTelemetry semantic conventions:
0, 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10
YAML | Type |
---|---|
request_size_histogram | []float64 |
response_size_histogram | []float64 |
Set the bucket boundaries for metrics related to request and response sizes:
http.server.request.body.size
(OTEL) /http_server_request_body_size_bytes
(Prometheus)http.client.request.body.size
(OTEL) /http_client_request_body_size_bytes
(Prometheus)http.server.response.body.size
(OTEL) /http_server_response_body_size_bytes
(Prometheus)http.client.response.body.size
(OTEL) /http_client_response_body_size_bytes
(Prometheus)
If you leave the value unset, Beyla uses these default bucket boundaries:
0, 32, 64, 128, 256, 512, 1024, 2048, 4096, 8192
These default values are UNSTABLE and may change if Prometheus or OpenTelemetry semantic conventions recommend different bucket boundaries.
Use native histograms and exponential histograms
For Prometheus, you enable
native histograms
by
enabling the native-histograms
feature in your Prometheus collector.
For OpenTelemetry, you can use
exponential histograms
for the predefined histograms instead of defining the buckets manually. Set the
standard
OTEL_EXPORTER_OTLP_METRICS_DEFAULT_HISTOGRAM_AGGREGATION
environment variable. See the histogram_aggregation
section in the
OTEL metrics exporter section for more information.
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!