Загальна конфігурація SDK

OTEL_SERVICE_NAME

Встановлює значення атрибута ресурсу service.name.

Стандартне значення: unknown_service

Якщо service.name також вказано в OTEL_RESOURCE_ATTRIBUTES, то OTEL_SERVICE_NAME має пріоритет.

Приклад:

export OTEL_SERVICE_NAME="your-service-name"

OTEL_RESOURCE_ATTRIBUTES

Пари ключ-значення, які використовуються як атрибути ресурсу.

Стандартне значення: порожньо

Приклад:

export OTEL_RESOURCE_ATTRIBUTES="key1=value1,key2=value2"

Посилання:

• Resource SDK
• Resource semantic conventions для загальних семантичних домовленостей щодо типів ресурсів

OTEL_TRACES_SAMPLER

Вказує Семплер, який використовується SDK для вибірки трейсів.

Стандартне значення: parentbased_always_on

Приклад:

export OTEL_TRACES_SAMPLER="traceidratio"

Прийняті значення для OTEL_TRACES_SAMPLER:

• always_on: AlwaysOnSampler
• always_off: AlwaysOffSampler
• traceidratio: TraceIdRatioBased
• parentbased_always_on: ParentBased(root=AlwaysOnSampler)
• parentbased_always_off: ParentBased(root=AlwaysOffSampler)
• parentbased_traceidratio: ParentBased(root=TraceIdRatioBased)
• parentbased_jaeger_remote: ParentBased(root=JaegerRemoteSampler)
• jaeger_remote: JaegerRemoteSampler
• xray: AWS X-Ray Centralized Sampling (сторонній)

OTEL_TRACES_SAMPLER_ARG

Вказує аргументи, якщо це застосовується, до семплера, визначеного в OTEL_TRACES_SAMPLER. Вказане значення буде використано лише якщо OTEL_TRACES_SAMPLER встановлено. Кожен тип Семплера визначає свій власний очікуваний вхід, якщо такий є. Неправильний або невпізнаний вхід реєструється як помилка.

Стандартне значення: порожньо

Приклад:

export OTEL_TRACES_SAMPLER="traceidratio"
export OTEL_TRACES_SAMPLER_ARG="0.5"

Залежно від значення OTEL_TRACES_SAMPLER, OTEL_TRACES_SAMPLER_ARG може бути встановлено наступним чином:

• Для семплерів traceidratio та parentbased_traceidratio: Ймовірність вибірки, число в діапазоні [0..1], наприклад “0.25”. Стандартно 1.0, якщо не встановлено.
• Для jaeger_remote та parentbased_jaeger_remote: Значення є розділений комою список:
  • Приклад: endpoint=http://localhost:14250,pollingIntervalMs=5000,initialSamplingRate=0.25
  • endpoint: кінцева точка у формі scheme://host:port gRPC сервера, який обслуговує стратегію вибірки для сервісу (sampling.proto).
  • pollingIntervalMs: у мілісекундах, що вказує, як часто семплер буде опитувати бекенд для оновлень стратегії вибірки.
  • initialSamplingRate: у діапазоні [0..1], який використовується як ймовірність вибірки, коли бекенд не може бути досягнутий для отримання стратегії вибірки. Це значення перестає мати ефект, як тільки стратегія вибірки успішно отримана, оскільки віддалена стратегія буде використовуватися до отримання нового оновлення.

OTEL_PROPAGATORS

Вказує Поширювачі, які використовуються у списку, розділеному комами.

Стандартне значення: tracecontext,baggage

Приклад:

export OTEL_PROPAGATORS="b3"

Прийняті значення для OTEL_PROPAGATORS:

• tracecontext: W3C Trace Context
• baggage: W3C Baggage
• b3: B3 Single
• b3multi: B3 Multi
• jaeger: Jaeger
• xray: AWS X-Ray (сторонній)
• ottrace: OT Trace (сторонній)
• none: Немає автоматично налаштованого поширювача.

OTEL_TRACES_EXPORTER

Вказує, який експортер використовується для трейсів. Залежно від реалізації це може бути список, розділений комами.

Стандартне значення: otlp

Приклад:

export OTEL_TRACES_EXPORTER="jaeger"

Прийняті значення для:

• otlp: OTLP
• jaeger: експорт у модель даних Jaeger
• zipkin: Zipkin
• console: Стандартний вивід
• none: Немає автоматично налаштованого експортера для трейсів.

OTEL_METRICS_EXPORTER

Вказує, який експортер використовується для метрик. Залежно від реалізації це може бути список, розділений комами.

Стандартне значення: otlp

Приклад:

export OTEL_METRICS_EXPORTER="prometheus"

Прийняті значення для OTEL_METRICS_EXPORTER:

• otlp: OTLP
• prometheus: Prometheus
• console: Стандартний вивід
• none: Немає автоматично налаштованого експортера для метрик.

OTEL_LOGS_EXPORTER

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

Стандартне значення: otlp

Приклад:

export OTEL_LOGS_EXPORTER="otlp"

Прийняті значення для OTEL_LOGS_EXPORTER:

• otlp: OTLP
• console: Стандартний вивід
• none: Немає автоматично налаштованого експортера для логів.