Сбор телеметрии

В Monium автоматически поступают данные телеметрии от ресурсов Yandex Cloud. Также вы можете передавать в Monium данные телеметрии в формате OpenTelemetry из любых источников: других облаков, собственной инфраструктуры или приложений.

В этом разделе описано, как настроить передачу метрик, логов и трейсов в Monium. Вы можете отправлять данные напрямую из приложения с помощью OpenTelemetry SDK или использовать агент-коллектор для централизованного сбора и маршрутизации телеметрии.

Настройка подключенияНастройка подключения

Чтобы передавать телеметрию в Monium:

1. Настройте сбор телеметрии из вашего приложения в формате OpenTelemetry.

   Телеметрию можно передавать напрямую из приложения или через агент.

2. Создайте сервисный аккаунт.

3. Создайте API-ключ для сервисного аккаунта. Выберите область действия в зависимости от типа передаваемых данных:

   • yc.monium.telemetry.write — запись всех видов телеметрии;
   • yc.monium.metrics.write — запись метрик;
   • yc.monium.logs.write — запись логов;
   • yc.monium.traces.write — запись трейсов.

4. Укажите параметры подключения:

   • Эндпоинт — ingest.monium.yacloudkz.tech:443.
   • Протокол — gRPC, HTTP.

5. Настройте распределение данных по шардам.

   Телеметрия в Monium организована по иерархии «проект → кластер → сервис». Данные хранятся в шардах по парам «сервис-кластер».

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

   • Проект — передается в заголовке x-monium-project.

     По умолчанию при создании облака и каталога создаются два проекта: cloud__<идентификатор_облака> и folder__<идентификатор_каталога>. Также вы можете создать свои проекты для сбора телеметрии.

   • Кластер (опционально) — передается в атрибутах ресурса OTEL_RESOURCE_ATTRIBUTES с ключом cluster или deployment.name. По умолчанию — default.

   • Сервис — передается в атрибутах ресурса OTEL_RESOURCE_ATTRIBUTES с ключом service или service.name.

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

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

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

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

   заголовок	собственный атрибут ресурса	стандартный атрибут ресурса	значение по умолчанию
   x-monium-project	—	—	—
   x-monium-cluster	cluster	deployment.name	default
   x-monium-service	service	service.name, k8s.deployment.name, k8s.namespace.name	default

АгентыАгенты

Monium принимает телеметрию из ресурсов Yandex Cloud, других облаков и приложений в вашей инфраструктуре.

Для ресурсов Yandex Cloud передача данных настраивается при создании или изменении ресурса.

Для приложений доступны два способа сбора телеметрии:

• OpenTelemetry SDK — подключите SDK к приложению и настройте OTLP-экспорт.
• Автоинструментация — используйте агент или библиотеки, которые автоматически собирают телеметрию из популярных фреймворков без изменения кода.

Данные можно отправлять напрямую из SDK или через агент, который поддерживает OTLP.

Агент устанавливается рядом с приложением — на сервере, виртуальной машине или в контейнере. Он принимает телеметрию и передает ее в Monium. Если приложение отправляет данные не в формате OTLP, агент выполняет преобразование.

Подробнее о настройке:

• Unified Agent — агент от Яндекса.
• OTel Collector — агент экосистемы OpenTelemetry.
• Fluent Bit — легковесный агент для обработки логов и форвардированию других видов телеметрии.