Связь трейсов с логами

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

Большинство библиотек инструментирования OpenTelemetry автоматически добавляют идентификаторы трассировки в записи логов:

• trace_id — идентификатор трейса.
• span_id — идентификатор спана.

Пример записи лога в формате JSON с контекстом трассировки:

{
  "level": "INFO",
  "time": "2026-02-18T13:58:22.200Z",
  "project": "folder__b1g86q4m5vej********",
  "cluster": "default",
  "service": "frontend-proxy",
  "host": "frontend-proxy-f55dc9f55-ktxwv",
  "message": "Request successfuly served",
  "span_id": "a4df8085ed748a6b",
  "trace_id": "7d069c8223d982cd72e549860de9d210",
  "labels": {
    "k8s.deployment.name": "frontend-proxy",
    "k8s.namespace.name": "default",
    "k8s.node.name": "cl1c63baqn6458a167ec-omor"
  }
}

Имена полей в логах могут отличаться (например, trace.id и span.id вместо trace_id и span_id) в зависимости от формата поставки. Для перехода к трейсу используется значение идентификатора.

Поиск трейса по логамПоиск трейса по логам

Чтобы по логу открыть трейс или спан и увидеть полный контекст выполнения запроса:

1. Откройте страницу с логами и найдите нужную запись. Подробнее о просмотре логов см. в разделе Посмотреть логи.
2. В записи найдите поле с идентификатором трейса (trace_id или trace.id) или спана (span_id или span.id) и нажмите на значение.

Откроется страница просмотра трейса с выбранным спаном или корневым спаном трейса.

Поиск логов по трейсуПоиск логов по трейсу

Чтобы найти все логи, относящиеся к трейсу или к конкретному спану:

1. Откройте нужный трейс в поиске трейсов и выберите спан на странице просмотра трейса.
2. На панели справа с деталями спана нажмите Перейти в логи и выберите Логи трейса или Логи спана.

Откроется Посмотреть логи с уже подставленным фильтром по trace_id или по trace_id и span_id.