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.yacloudkz.tech:443.

• Авторизация: сервисный аккаунт с ролью monium.traces.writer и API-ключ с областью действия yc.monium.traces.write.

• Заголовок проекта: x-monium-project=folder__<идентификатор_каталога>.

• Атрибуты ресурса: service.name (имя приложения) и cluster (окружение, по умолчанию default).

Просмотр трейсовПросмотр трейсов

1. На главной странице Monium слева выберите Трейсы.

2. Вверху укажите промежуток поиска с помощью временной шкалы, предустановленного промежутка или введите нужное значение времени.

3. Выберите режим: Поиск по трейсам или Поиск по спанам.

4. Введите запрос для поиска данных.

   По умолчанию поиск выполняется в текущем проекте — folder__<идентификатор_каталога>, вы можете выбрать другой.

5. Нажмите Выполнить.

6. Чтобы открыть отдельную трассировку, вверху справа в поле Введите trace.id укажите ее идентификатор.

Дополнительные возможности поиска и просмотра трейсов см. в разделе Поиск трейсов и спанов.