Налаштування гістограм метрик OBI для Prometheus та OpenTelemetry

Ви можете налаштувати гістограми метрик OBI для Prometheus та OpenTelemetry. Ви також можете вибрати, чи використовувати нативні гістограми та експоненціальні гістограми.

Перевизначення сегментів гістограм

Ви можете перевизначити межі сегментів гістограм для експортерів метрик OpenTelemetry та Prometheus, встановивши параметр конфігурації YAML buckets:

Секція YAML: otel_metrics_export.buckets

Наприклад:

otel_metrics_export:
  buckets:
    duration_histogram: [0, 1, 2]

Встановіть межі сегментів для метрик, повʼязаних із тривалістю запитів. Зокрема:

• http.server.request.duration (OTel) / http_server_request_duration_seconds (Prometheus)
• http.client.request.duration (OTel) / http_client_request_duration_seconds (Prometheus)
• rpc.server.call.duration (OTel) / rpc_server_call_duration_seconds (Prometheus)
• rpc.client.call.duration (OTel) / rpc_client_call_duration_seconds (Prometheus)

Якщо ви залишите значення не встановленим, OBI використовує стандартні межі сегментів з семантичних домовленостей OpenTelemetry:

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: prometheus_export.buckets

prometheus_export:
  buckets:
    request_size_histogram: [0, 10, 20, 22]
    response_size_histogram: [0, 10, 20, 22]

Встановіть межі сегментів для метрик, повʼязаних із розмірами запитів та відповідей:

• 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)

Якщо ви залишите значення не встановленим, OBI використовує стандартні межі сегментів:

0, 32, 64, 128, 256, 512, 1024, 2048, 4096, 8192

Ці стандартні значення нестабільні і можуть змінитися, якщо семантичні домовленості Prometheus або OpenTelemetry рекомендують інші межі сегментів.

Гістограма RTT TCP

Використовуйте stat_tcp_rtt_histogram у розділі buckets будь-якого експортера, щоб встановити явні межі для obi.stat.tcp.rtt / obi_stat_tcp_rtt_seconds:

otel_metrics_export:
  buckets:
    stat_tcp_rtt_histogram: [0.001, 0.005, 0.01, 0.05, 0.1, 0.5, 1]

Стандартні межі, в секундах:

0.0005, 0.001, 0.002, 0.005, 0.010, 0.025, 0.050, 0.100, 0.250, 0.500, 1.0

Експортер OpenTelemetry ігнорує явні межі, коли histogram_aggregation має значення base2_exponential_bucket_histogram.

Використання нативних гістограм та експоненціальних гістограм

Для Prometheus ви можете увімкнути нативні гістограми, увімкнувши функцію native-histograms у вашому колекторі Prometheus.

Для OpenTelemetry ви можете використовувати експоненціальні гістограми для попередньо визначених гістограм замість того, щоб визначати сегменти вручну. Встановіть стандартну змінну середовища OTEL_EXPORTER_OTLP_METRICS_DEFAULT_HISTOGRAM_AGGREGATION. Дивіться розділ histogram_aggregation у розділі OTel metrics exporter для отримання додаткової інформації.