Наблюдаемость и SRE · проверено по источникам

Запись журнала

Запись журнала — описание отдельного события с временем, содержимым, уровнем важности, ресурсом и при необходимости контекстом трассировки.

Также ищут: Log record · application log entry · структурированный лог · system log entry

Практический смысл

Почему это важно

Строку «тайм-аут» без времени, узла, операции и идентификатора запроса почти невозможно связать с проблемой. Структурированные поля позволяют находить и сопоставлять события с трассировкой.

Доказательная часть

Что подтверждено

  1. Модель LogRecord в OpenTelemetry включает время события, уровень важности, содержимое, ресурс, атрибуты и необязательные TraceId и SpanId.

    Граница применимости: Стабильная модель журналов OpenTelemetry; способ хранения и кодирования может отличаться.

  2. Записи журнала можно сопоставлять с трассировками и метриками по времени, контексту трассировки и атрибутам ресурса.

    Граница применимости: Сигналы с согласованными часами, атрибутами ресурса и переданным контекстом.

Граница терминов

Не путать

Метрика

Запись журнала сохраняет контекст отдельного события, а метрика компактно сводит числовое поведение множества событий.

Перед спецификацией

Что проверить

  1. Храните отдельно время события и время его получения.
  2. Добавляйте ресурс, операцию и уровень важности.
  3. Передавайте TraceId и SpanId для связи с запросом.
Открытые основания

Первоисточники

  • Первичная спецификация

    OpenTelemetry Logs Data Model

    OpenTelemetry · Stable data model, проверено 29 августа 2026 года

    Определяет Timestamp, severity, body, resource, attributes, TraceId и SpanId LogRecord.

    Открыть первоисточник
  • Первичная спецификация

    OpenTelemetry Logging and Correlation

    OpenTelemetry · OpenTelemetry Specification 1.60.0

    Описывает correlation logs, traces и metrics по time, trace context и resource context.

    Открыть первоисточник
  • Первичная спецификация

    OpenTelemetry Specification Overview

    OpenTelemetry · OpenTelemetry Specification 1.60.0

    Описывает signals, raw measurements, aggregation, resources и context propagation.

    Открыть первоисточник
Сообщить об ошибке

Опишите проблему — постараемся исправить как можно скорее.

Спасибо!

Получили ваше сообщение.
Подтвердите действие