Вибірка

Вибірка — це процес, який обмежує кількість трейсів, що генеруються системою. Ruby SDK пропонує кілька головних механізмів вибірки.

Стандартна поведінка

Стандартно, всі відрізки вибираються, і таким чином, 100% трейсів вибираються. Якщо ви не потребуєте керування обсягом даних, не варто налаштовувати механізм вибірки.

Зокрема, стандартний вибірник є композицією ParentBased та ALWAYS_ON, що гарантує, що кореневий відрізок у трейсі завжди вибирається, і що всі дочірні відрізки поважають прапорець вибірки свого пращура для прийняття рішення про вибірку. Це гарантує, що всі відрізки у трейсі стандартно вибираються.

Вибірник TraceIdRatioBased

Найпоширеніший головний вибірник - це вибірник TraceIdRatioBased. Він детерміновано вибирає відсоток трейсів, який ви передаєте як параметр.

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

Ви можете налаштувати вибірник TraceIdRatioBased за допомогою змінних середовища:

export OTEL_TRACES_SAMPLER="traceidratio"
export OTEL_TRACES_SAMPLER_ARG="0.1"

Це вказує SDK вибирати відрізки таким чином, щоб лише 10% трейсів експортувалися.

Налаштування в коді

Хоча можливо налаштувати вибірник TraceIdRatioBased в коді, це не рекомендується. Це вимагає вручну налаштувати Tracer Provider з усіма правильними опціями конфігурації, що важко зробити правильно порівняно з використанням OpenTelemetry::SDK.configure.