Налаштування вибірки трейсів OBI OpenTelemetry

Налаштуйте, як вибирати трейси OpenTelemetry.

OBI приймає стандартні змінні середовища OpenTelemetry для налаштування коефіцієнта вибірки трейсів.

Секція YAML: otel_traces_export.sampler

Ви можете налаштувати компонент у секції otel_traces_export.sampler вашої YAML конфігурації або за допомогою змінних середовища.

otel_traces_export:
  sampler:
    name: 'traceidratio'
    arg: '0.1'
YAML

змінна середовища

ОписТипСтандартно
name

OTEL_TRACES_SAMPLER

Визначає назву вибірки. Приймає стандартні назви вибірки з специфікації OpenTelemetry. Див. назва вибірки для деталей.stringparentbased_always_on
arg

OTEL_TRACES_SAMPLER_ARG

Визначає аргумент для вибраної вибірки. Тільки traceidratio і parentbased_traceidratio вимагають аргумент. Див. аргумент вибірки для деталей.string(unset)

Назва вибірки

Властивість name приймає такі стандартні назви вибірки:

  • always_on: вибирає кожен трейс. Будьте обережні, використовуючи цю вибірку у застосунку зі значним трафіком: новий трейс буде запущений і експортований для кожного запиту
  • always_off: не вибирає жоден трейс
  • traceidratio: вибирає певну частку трейсів (вказану властивістю arg). Частка повинна бути дійсним значенням між 0 і 1. Наприклад, значення "0.5" вибирає 50% трейсів. Частки >= 1 завжди вибираються. Частки < 0 розглядаються як нульові. Щоб врахувати конфігурацію вибірки батьківського трейс, використовуйте вибірку parentbased_traceidratio.
  • parentbased_always_on (стандартно): версія вибірки always_on на основі батьків
  • parentbased_always_off: версія вибірки always_off на основі батьків
  • parentbased_traceidratio: версія вибірки traceidratio на основі батьків

Вибірки на основі батьків є складними вибірками, які поводяться по-різному в залежності від батька відрізку трейса. Якщо у відрізка немає батька, використовується кореневий вибірник для прийняття рішення про вибірку. Якщо у відрізка є батько, конфігурація вибірки залежить від вибірки батька.

Аргумент вибірки

Властивість arg визначає аргумент для вибраної вибірки. Тільки traceidratio і parentbased_traceidratio вимагають аргумент.

В YAML, ви повинні надати це значення як рядок. Навіть якщо значення є числовим, переконайтеся, що ви обгортаєте його в лапки у файлі YAML (наприклад, arg: "0.25").


Востаннє змінено December 26, 2024: [uk] Ukrainian documentation for OpenTelemetry (2a3c5648)