Лог записан в logfmt или уже представляет собой структурированный JSON?
Преобразуйте logfmt, если кавычки или повторяющиеся ключи скрывают поля; готовый типизированный JSON анализируйте напрямую.
Elysia Tools
Навигация
Руководство по рабочему процессу
Соберите список старых атрибутов, перенесите семантические соглашения, проверьте передачу контекста и реальную трассу перед выпуском изменений.
Впервые проходите этот процесс? Следуйте шагам по порядку, начиная с первого инструмента ниже. Уже знаете, что нужно? Переходите сразу к подходящему шагу: все инструменты этого процесса собраны в сравнительной таблице.
Первый инструмент: Анализатор структурированных логов
Темы
| Инструмент | Что делает | Категория |
|---|---|---|
| Анализатор структурированных логов | Определяет распространенные форматы логов, извлекает ключевые поля и выводит JSON, CSV или SQL. | Обработка данных |
| Мост logfmt ↔ JSON для структурированных логов | Конвертирует logfmt (ключ=значение) в JSON и обратно, с экранированием кавычек, преобразованием чисел/булевых и обработкой дубль-ключей. | Преобразование форматов |
| Инструмент миграции атрибутов Semantic-Convention v1.20 → v1.27 OpenTelemetry | Переписывает имена атрибутов спанов/логов между версиями семантических конвенций OpenTelemetry: http.method → http.request.method, http.status_code → http.response.status_code, http.url → url.full, db.system → db.system.name, messaging.destination → messaging.destination.name и ещё 25+ — по вставленному коду JS/TS/Python/Go/Java/.NET, YAML коллектора или JSON дашбордов Grafana, с картой переименований для collector, предупреждениями об удалении/ручном разбиении, статистикой по атрибутам и отчётом о непокрытых. |
Темы
| Разработка |
| Валидатор распространения OpenTelemetry W3C traceparent / tracestate / baggage и заголовков OTLP | Проверяет traceparent по ABNF W3C Trace Context (версия / 16-байтовый trace-id / 8-байтовый parent-id / 1-байтовый trace-flags; нули и версия ff отклоняются, верхний регистр предупреждает), tracestate (≤32 членов, простые и tenant@system ключи, предупреждение о дублях) и baggage (процентно-кодированные значения с непрозрачными свойствами); проверяет Content-Type экспорта OTLP и 25-байтовый двоичный контекст grpc-trace-context-bin; коррелирует два traceparent в симулированном round-trip (стабильность trace-id и коллизия случайного дочернего span-id) и выдаёт нормализованные заголовки. | Разработка |
| Декодер распределенных трассировок и waterfall | Разбирает JSON Jaeger, Zipkin или OpenTelemetry и показывает spans, время и ошибки в waterfall-отчете | Разработка |
| Планировщик бюджета задержки API | Планируйте и визуализируйте бюджет задержки API. Введите цель P99 (напр. ≤ 300мс) и распределение по этапам (DNS, TCP, TLS, TTFB, Processing, Network), чтобы увидеть живой водопад, использование бюджета и предупреждения о превышении. Можно вставить trace OpenTelemetry или Datadog для получения измеренной оценки. | Разработка |
Этот порядок действий рассчитан на владельца сервиса, который планово обновляет семантические соглашения OpenTelemetry, а не на расследование текущего инцидента. Сохраните лог до изменения, конфигурацию инструментации или Collector и запрос, проходящий хотя бы через два сервиса. Удалите персональные данные и секреты до передачи примеров. structured-log-analyzer показывает уже используемые атрибуты. Для logfmt примените logfmt-to-json-structured-log-bridge, чтобы увидеть значения в кавычках, приведение типов и повторяющиеся ключи. Готовый структурированный JSON преобразовывать незачем. Для отдельной проверки раскрытия чувствительных данных предназначен pii-log-redaction.
Запустите otel-semantic-convention-migration-tool на копии кода, конфигурации Collector или запросов панели мониторинга. Зафиксируйте исходную и целевую версии, предлагаемые переименования, удалённые и не сопоставленные поля. Результат инструмента является проектом, а не автоматическим развёртыванием. http.target, например, может потребовать осознанного разделения пути и строки запроса вместо буквальной замены имени. Согласуйте такие случаи с владельцами сервиса. После выпуска проверьте и запросы панелей: количество переименований не показывает, где осталось старое имя. Миграция подставляет известный текст, не анализируя смысл приложения. Проверяйте контекст; смена строки не доказывает корректную миграцию инструментирования или панелей.
Передайте примеры traceparent, tracestate, baggage и OTLP-заголовков в opentelemetry-w3c-traceparent-tracestate-baggage-and-otlp-protobuf-headers-propagation-validator. На следующем сервисе идентификатор трассы должен сохраниться, а идентификатор спана измениться. Правильные заголовки не доказывают, что спаны были экспортированы. Разберите экспорт после обновления через distributed-trace-decoder-waterfall-visualizer, сравните порядок сервисов, родительские связи, ошибки и длительности с ожидаемым запросом. Отсутствующие спаны отмечайте явно, не восстанавливайте их по косвенным признакам. Проверяются переданные заголовки; дочерние спаны могут быть смоделированы. Синтетическая корреляция не доказывает реальную передачу. Сверьте обезличенные заголовки двух переходов и отдельно проверьте связанный экспорт трассы.
Если установлена цель по задержке, сравните наблюдаемые времена этапов с согласованными лимитами в api-latency-budget-planner. Одна трасса помогает найти медленный этап, но не даёт статистически обоснованный P99. Для приёмки сохраните версии, сравнение атрибутов, проверку заголовков, экспорт и открытые отклонения. Если задача состоит в расследовании аварии или повторном воспроизведении API-запроса, переходите к observability-debugging или api-request-replay-and-debugging соответственно.
Руководство по рабочему процессу
Разберите очищенный лог до изменения. Преобразуйте logfmt в JSON только при необходимости увидеть значения в кавычках и повторные ключи.
Перепишите поддерживаемые атрибуты пути от v1.20, изучите различия и отдельно решите судьбу удалённых или не сопоставленных полей.
Проверяются переданные заголовки; дочерние спаны могут быть смоделированы. Синтетическая корреляция не доказывает реальную передачу. Сверьте обезличенные заголовки двух переходов и отдельно проверьте связанный экспорт трассы.
Разберите JSON-экспорт OTel, Jaeger или Zipkin после изменения и сравните сервисы, связи, ошибки и длительности с ожидаемым маршрутом.
Преобразуйте logfmt, если кавычки или повторяющиеся ключи скрывают поля; готовый типизированный JSON анализируйте напрямую.
Перед выпуском правил Collector вручную разберите удалённые и не сопоставленные атрибуты, например http.target.
Проверяйте заголовки для непрерывности контекста, экспорт для реально связанных спанов, а бюджет только при наличии цели.
Если цель установлена, сравните длительности спанов с согласованными лимитами этапов и запишите превышения.