Особенности OTLP в Monium

Monium поддерживает прием метрик по протоколу OTLP (OpenTelemetry Protocol), что позволяет напрямую отправлять телеметрию из приложений с OpenTelemetry SDK или через OpenTelemetry Collector.

ЭндпоинтыЭндпоинты

Monium предоставляет следующие эндпоинты для приема метрик в формате OTLP:

Эндпоинты gRPC и HTTP полностью совместимы со спецификацией OTLP.

АвторизацияАвторизация

Для авторизации запросов используется API-ключ, передаваемый в заголовке Authorization:

Authorization: Api-Key <API_ключ>

API-ключ создается для сервисного аккаунта с ролью monium.telemetry.writer. Ключ должен иметь область действия yc.monium.telemetry.write для записи любого вида телеметрии, либо одну или несколько из yc.monium.metrics.write, yc.monium.logs.write, yc.monium.traces.write для гранулированного доступа. Подробнее о создании API-ключа.

ЗаголовкиЗаголовки

Обязательные заголовкиОбязательные заголовки

Опциональные заголовкиОпциональные заголовки

Распределение по шардамРаспределение по шардам

Все метрики, логи, трейсы в Monium имеют обязательные метки project, cluster и service. Эти метки формируют ключ шарда.

При поставке телеметрии в формате OpenTelemetry значения ключевых атрибутов определяются следующим образом:

1. Приоритетнее — значения, заданные через HTTP или gRPC заголовки.
2. Затем — значения, заданные в ресурсных атрибутах тела запроса с ключами cluster, service.
3. Затем — значения, заданные в ресурсных атрибутах, рекомендуемые семантической конвенцией OpenTelemetry.
4. Иначе проставляется значение по умолчанию.

Имя проекта проставляется только из заголовка. Алгоритм определения ключа шарда представлен в таблице ниже.

Подробнее о параметрах шардирования см. в разделе Основные понятия.

Компрессия данныхКомпрессия данных

Monium поддерживает следующие методы компрессии:

Сопоставление типов метрикСопоставление типов метрик

В разделе приведено отображение типов данных в OpenTelemetry в типы Monium.

Типы метрик OTLPТипы метрик OTLP

OpenTelemetry использует следующие типы метрик:

Сопоставление типов MoniumСопоставление типов Monium

Monium преобразует типы OTLP в свои внутренние типы метрик в зависимости от темпоральности (temporality):

Temporality = Delta (дельта)Temporality = Delta (дельта)

Temporality = Cumulative (кумулятивная)Temporality = Cumulative (кумулятивная)

Примеры обработки суммПримеры обработки сумм

Кумулятивная сумма (Cumulative Sum)Кумулятивная сумма (Cumulative Sum)

Монотонная дельта сумма (Delta Sum, Monotonic)Монотонная дельта сумма (Delta Sum, Monotonic)

Немонотонные дельта‑суммы в OpenTelemetry, как правило, не используются.

Обработка ресурсных атрибутовОбработка ресурсных атрибутов

Monium обрабатывает ресурсные атрибуты OTLP следующим образом:

Сохраняемые атрибутыСохраняемые атрибуты

Следующие ресурсные атрибуты сохраняются как метки метрик:

Атрибуты хоста (приоритет от высшего к низшему):

• host
• host.name
• hostname

Эти атрибуты сохраняются в метку host.

Атрибуты окружения (приоритет от высшего к низшему):

• env
• deployment.environment.name
• deployment.environment

Эти атрибуты сохраняются в метку env.

Атрибуты Kubernetes и Cloud (сохраняются без изменения имени):

• cloud.availability_zone
• cloud.region
• container.name
• k8s.cluster.name
• k8s.container.name
• k8s.cronjob.name
• k8s.daemonset.name
• k8s.deployment.name
• k8s.job.name
• k8s.namespace.name
• k8s.pod.name
• k8s.replicaset.name
• k8s.statefulset.name

Зарезервированные меткиЗарезервированные метки

Если в атрибутах точек данных (data point attributes) используются зарезервированные имена меток, они автоматически переименовываются:

Остальные атрибутыОстальные атрибуты

Ресурсные атрибуты, не входящие в вышеперечисленные списки, отбрасываются.
Все атрибуты точек данных сохраняются как метки метрик Monium.

Формат данныхФормат данных

Monium поддерживает формат OTLP Protobuf для всех видов телеметрии. Формат OTLP JSON в настоящее время поддерживается для логов и трейсов.

См. такжеСм. также

• SDK для передачи данных в формате OpenTelemetry
• Передача данных через OpenTelemetry Collector
• Спецификация OTLP
• OpenTelemetry Metrics