Ключевые факты
- Категория
- Разработка и Web
- Типы входных данных
- textarea, file, select, checkbox, number
- Тип результата
- text
- Покрытие примерами
- 4
- API доступен
- Yes
Обзор
Конвертер логов в sequence diagram — это инструмент для автоматического преобразования структурированных сервисных логов и трейсов в наглядные диаграммы последовательности форматов Mermaid или PlantUML. Он распознает межсервисные взаимодействия, извлекает данные о задержках и ошибках, а затем генерирует готовый код диаграммы, упрощая анализ архитектуры и отладку микросервисов.
Когда использовать
- •При отладке сложных микросервисных взаимодействий для визуализации цепочки вызовов.
- •Для документирования текущей архитектуры системы на основе реальных логов.
- •При расследовании инцидентов, чтобы быстро выявить узкие места (задержки) и точки отказа (ошибки).
Как это работает
- •Вставьте текстовые логи в формате JSON Lines или trace-подобном синтаксисе (например, api -> auth), либо загрузите файл с логами.
- •Выберите желаемый формат вывода (Mermaid или PlantUML) и настройте параметры отображения задержек и ошибок.
- •Укажите максимальное количество шагов для сжатия длинных цепочек вызовов в читаемую диаграмму.
- •Инструмент проанализирует логи и сгенерирует краткую сводку вместе с готовым кодом диаграммы.
Сценарии использования
Примеры
1. Визуализация цепочки авторизации с ошибкой
Backend-разработчик- Контекст
- Разработчик расследует жалобы пользователей на ошибки при входе в систему.
- Проблема
- Нужно быстро понять, на каком этапе авторизации происходит сбой и сколько времени занимает запрос.
- Как использовать
- Вставить фрагмент логов со стрелками в поле ввода, выбрать формат Mermaid, включить подсветку ошибок и задержек.
- Пример конфигурации
-
Формат: Mermaid, Добавить задержки: Да, Подсветить ошибки: Да, Макс шагов: 12 - Результат
- Сгенерирован код Mermaid, где четко видно успешное обращение к базе данных и последующий ответ с ошибкой 401 (invalid token) и задержкой 82ms.
2. Анализ микросервисного трейса из JSON Lines
DevOps-инженер- Контекст
- Инженер анализирует производительность системы обработки заказов, выгрузив логи из ELK.
- Проблема
- Необходимо преобразовать сырые JSON-логи в PlantUML-диаграмму для презентации команде.
- Как использовать
- Загрузить файл trace.jsonl, выбрать формат PlantUML и установить лимит в 20 шагов.
- Пример конфигурации
-
Файл: trace.jsonl, Формат: PlantUML, Макс шагов: 20 - Результат
- Получен готовый код PlantUML, описывающий последовательность вызовов между сервисами заказов, оплаты и доставки с указанием времени выполнения.
Проверить на примерах
json, text, fileСвязанные хабы
FAQ
Какие форматы логов поддерживаются?
Поддерживаются JSON Lines с полями source, target, action, а также текстовые логи со стрелками (например, serviceA -> serviceB).
Можно ли загрузить файл с логами?
Да, вы можете загрузить файлы форматов .log, .txt, .json или .jsonl размером до 20 МБ.
Что делает параметр «Макс шагов»?
Он ограничивает количество отображаемых взаимодействий (от 3 до 40), чтобы диаграмма оставалась компактной и читаемой.
Как отображаются ошибки на диаграмме?
Если включена опция «Подсветить ошибки», инструмент добавляет специальные текстовые пометки к шагам, завершившимся сбоем.
В какие форматы экспортируется диаграмма?
Инструмент генерирует текстовый код для рендеринга в форматах Mermaid или PlantUML.