Monium Traces
Monium Traces — система распределенной трассировки в платформе Monium. Она позволяет отслеживать путь выполнения запросов через сервисы и компоненты вашей инфраструктуры: находить причины ошибок, выявлять узкие места и анализировать производительность.
Monium Traces принимает данные по протоколу OpenTelemetry (OTLP). Для отправки трейсов подходит любой совместимый инструмент: OpenTelemetry Collector, SDK и другие агенты.
Какие задачи решает трейсинг
В микросервисной архитектуре трейсинг помогает:
- Локализовать ошибки — определить, какой из множества сервисов вызвал сбой.
- Анализировать производительность — найти сервис или компонент, который замедляет выполнение запроса.
- Отслеживать путь запроса — увидеть, через какие сервисы и базы данных прошел запрос.
- Разбирать редкие события — понять, что происходит в момент аномального поведения системы.
В монолитной архитектуре трейсинг позволяет:
- Анализировать внутреннюю структуру запросов — отследить выполнение через слои логики (контроллеры, бизнес-логика, репозитории) и найти узкие места.
- Диагностировать периодические сбои — выявить причину нестабильного поведения, которое сложно воспроизвести.
Настройка подключения
Для отправки трейсов в Monium Traces используйте любой инструмент, совместимый с протоколом OpenTelemetry (OTLP). Например, OpenTelemetry Collector или OpenTelemetry SDK.
Если вы уже знакомы с OpenTelemetry и работаете с облаком Yandex Cloud, для подключения достаточно параметров ниже.
Если вы только начинаете работу с трейсингом, воспользуйтесь руководством по настройке поставки данных — там описана установка агента, конфигурация и примеры для отправки телеметрии в Monium.
Параметры подключения
-
Формат поставки данных в Monium — OpenTelemetry (OTLP).
-
Эндпоинт:
ingest.monium.yandex.cloud:443. -
Авторизация: сервисный аккаунт с ролью
monium.traces.writerи API-ключ с областью действияyc.monium.traces.write. -
Заголовок проекта:
x-monium-project=folder__<идентификатор_каталога>. -
Атрибуты ресурса:
service.name(имя приложения) иcluster(окружение, по умолчаниюdefault).
Просмотр трейсов
-
На главной странице Monium слева выберите Обзор → Трейсы.
-
Вверху укажите промежуток поиска с помощью временной шкалы, предустановленного промежутка или введите нужное значение времени.
-
Выберите режим: Поиск по трейсам или Поиск по спанам.
-
Введите запрос для поиска данных.
По умолчанию поиск выполняется в текущем проекте —
folder__<идентификатор_каталога>, вы можете выбрать другой. -
Нажмите Выполнить.
-
Чтобы открыть отдельную трассировку, вверху справа в поле Введите trace.id укажите ее идентификатор.
Дополнительные возможности поиска и просмотра трейсов описаны в разделе Поиск трейсов и спанов.