Налаштування внутрішнього репортера метрик OBI

Налаштуйте те, як опціональний репортер внутрішніх метрик звітує про метрики щодо внутрішньої поведінки інструмента автоматичного інструментування у форматі Prometheus.

Секція YAML: internal_metrics

Цей компонент звітує про внутрішні метрики поведінки інструмента автоматичного інструментування. Ви можете експортувати ці метрики за допомогою Prometheus або OpenTelemetry.

Щоб експортувати метрики за допомогою Prometheus, встановіть exporter на prometheus у секції internal_metrics. Потім встановіть port у підсекції prometheus.

Щоб експортувати метрики за допомогою OpenTelemetry, встановіть exporter на otel у секції internal_metrics. Потім встановіть кінцеву точку в otel_metrics_export.

Приклад:

internal_metrics:
  exporter: prometheus
  prometheus:
    port: 6060
    path: /internal/metrics

Підсумок конфігурації

YAMLЗмінна середовищаТипСтандартноПідсумок
exporterOTEL_EBPF_INTERNAL_METRICS_EXPORTERstringdisabledОбирає репортера внутрішніх метрик.
prometheus.portOTEL_EBPF_INTERNAL_METRICS_PROMETHEUS_PORTint(unset)HTTP порт для точки доступу Prometheus scrape.
prometheus.pathOTEL_EBPF_INTERNAL_METRICS_PROMETHEUS_PATHstring/internal/metricsШлях HTTP-запиту для метрик Prometheus.
avoided_services.disabledOTEL_EBPF_INTERNAL_METRICS_AVOIDED_SERVICES_DISABLEDbooleanfalseВимикає метрику сервісів, яких слід уникати.
avoided_services.limitOTEL_EBPF_INTERNAL_METRICS_AVOIDED_SERVICES_LIMITint2000Обмежує серії сервісів, яких слід уникати, включаючи серію переповнення.

Експортер внутрішніх метрик

Встановіть експортер внутрішніх метрик. Ви можете використовувати disabled, prometheus або otel.


Порт Prometheus

Встановіть HTTP-порт для точки доступу Prometheus scrape. Якщо ви залишите його не встановленим або встановите в 0, OBI не відкриває точку доступу Prometheus і не звітує про метрики.

Ви можете використовувати те саме значення, що й prometheus_export.port (обидва сімейства метрик ділять один і той же HTTP-сервер, але використовують різні шляхи), або використовувати інше значення (OBI відкриває два HTTP-сервери для різних сімейств метрик).


Шлях Prometheus

Встановіть HTTP-шлях запиту для отримання метрик Prometheus.

Якщо prometheus_export.port і internal_metrics.prometheus.port використовують те саме значення, ви можете встановити internal_metrics.prometheus.path на інше значення, ніж prometheus_export.path, щоб зберегти сімейства метрик окремими, або використовувати те саме значення, щоб перерахувати обидва сімейства метрик в одній точці доступу.

Кардинальність сервісів, яких слід уникати

Метрика OTLP obi.avoided.services (obi_avoided_services у Prometheus) повідомляє про сервіси, для яких OBI уникав дублювання телеметрії після виявлення, що сервіс експортує дані OpenTelemetry безпосередньо. Серії включають імʼя сервісу, простір імен сервісу та сигнал, якого слід уникати (metrics або traces), але не висококардинальний ідентифікатор екземпляра сервісу.

avoided_services.limit обмежує кількість серій. Додаткові сервіси обʼєднуються в серію з otel.metric.overflow=true (Prometheus: otel_metric_overflow="true"). Встановіть ліміт на 0, щоб використовувати стандартний ліміт кардинальності метрик OpenTelemetry SDK, або встановіть disabled: true, щоб пропустити цю метрику.


Востаннє змінено July 12, 2026: [uk] Ukrainian documentation for OpenTelemetry (83a19542)