# 日志转时序图转换器

把结构化服务日志转换成 Mermaid 或 PlantUML 时序图，并可叠加延迟和错误标注

> 标准页面: https://elysiatools.com/zh/tools/log-sequence-diagram-converter

- **分类:** Development

- **关键词:** 日志, 时序图, mermaid, plantuml, 调用链

## 概述

可粘贴 JSON Lines 或追踪风格的文本日志，也可以上传日志文件。工具会先识别服务间交互事件，如 serviceA -> serviceB，或带 source / target / action 字段的结构化 JSON，然后生成 Mermaid 或 PlantUML 时序图。

使用方式：
- 日志输入 / 日志文件：提供包含跨服务调用线索的日志
- 图格式：选择 Mermaid 或 PlantUML
- 包含延迟标注：在步骤旁显示延迟
- 高亮错误：对失败步骤补充错误注释
- 最大步骤数：压缩时序图，避免过长难读

支持模式：
- JSON Lines：包含 source、target、action、status、latencyMs、error 等字段
- 箭头日志：如 api -> auth POST /login | status=401 | latency=82ms
- trace 风格：如 [api] GET /users -> [db] 200 14ms

输出内容：
- 调用摘要
- Mermaid / PlantUML 时序图源码
- AI 可用时会优先做摘要压缩，不可用时自动回退到启发式生成

## 输入项

- **日志输入** (textarea): 2026-04-06T10:00:01Z api -> auth POST /login | status=401 | latency=82ms | error=invalid token
- **日志文件** (file)
- **图格式** (select)
- **包含延迟标注** (checkbox)
- **高亮错误** (checkbox)
- **最大步骤数** (number)

## 适用场景

- 在微服务架构中排查跨服务调用故障，需要快速理清请求流转路径与报错节点时。
- 分析系统性能瓶颈，需要直观查看各服务节点的响应延迟与耗时分布时。
- 编写技术文档或复盘报告，需要将枯燥的文本日志转化为标准、易读的时序图源码时。

## 工作原理

- 粘贴包含调用线索的文本日志（如 JSON Lines 或箭头风格日志），或直接上传 .log、.jsonl 等格式的日志文件。
- 选择目标图表格式（Mermaid 或 PlantUML），并根据排查需求勾选是否包含延迟标注和高亮错误节点。
- 设置最大步骤数以压缩过长的调用链，确保生成的图表清晰易读，避免信息过载。
- 工具会自动解析日志中的源、目标、动作及状态字段，生成调用摘要及可直接复制的时序图源码。

## 使用案例

- 微服务故障排查：将线上报错的 Trace 日志转换为时序图，快速定位是哪个底层服务返回了异常状态码。
- API 性能优化：通过提取日志中的 latency 字段并在图表中展示，直观发现调用链中的耗时瓶颈节点。
- 架构文档自动化：无需手动绘制，直接将测试环境的真实请求日志转换为 PlantUML 源码，补充到系统设计文档中。

## 常见问题

### 支持哪些格式的日志输入？

支持包含 source、target、action 等字段的结构化 JSON Lines，以及类似 'api -> auth POST /login' 的箭头风格或 Trace 风格文本日志。

### 可以上传本地日志文件吗？

可以，支持上传最大 20MB 的 .log、.txt、.json 或 .jsonl 格式的日志文件进行解析。

### 生成的时序图支持哪些渲染格式？

目前支持生成 Mermaid 和 PlantUML 两种主流的纯文本图表源码，您可以将其直接嵌入 Markdown、Notion 或其他技术文档中渲染。

### 如何处理非常长的调用链日志？

您可以通过调整“最大步骤数”参数（支持 3-40 步），工具会自动压缩和提取核心调用链路，避免生成的图表过长难读。

### 工具能自动识别日志中的错误并标注吗？

可以，只要勾选“高亮错误”选项，工具会解析日志中的 status 或 error 字段，并在时序图中对失败的调用步骤进行特殊注释和高亮。

## 相关工具

- [Data URI 生成器](https://elysiatools.com/zh/tools/data-uri-generator): 将文件转换为 Data URI（Base64 或百分号编码），用于直接在 HTML、CSS 或 Markdown 中内联图片、字体等资源
- [加密 PDF 转换器](https://elysiatools.com/zh/tools/encrypted-pdf-converter): 输入正确密码后解析受保护 PDF，并导出为 Markdown、JSON 或文本
- [健身训练 PDF 生成器](https://elysiatools.com/zh/tools/fitness-workout-pdf-generator): 从 JSON 或 CSV 训练计划数据生成可打印 PDF，包含动作表格、进度格子和可选的视频二维码
- [CSV 生成 JSON-LD](https://elysiatools.com/zh/tools/json-ld-generator-from-csv): 把 CSV 或 Excel 行数据转换为适用于 Article、Product、Event 的 Schema.org JSON-LD，方便 SEO 团队直接验证
- [训练/测试集分层切分器](https://elysiatools.com/zh/tools/train-test-split-with-stratification): 读取 CSV/JSON 数据集,按目标列做分层抽样的 train/validation/test 切分(默认 70/15/15,随机种子可复现),或分层 k 折交叉验证;输出每折类别分布报告与偏差条、重复行泄漏检查、SMOTE 过采样预览(仅在训练折上做最近邻插值),并可导出各折 CSV 为 ZIP。
- [ICS 日历重复规则展开器](https://elysiatools.com/zh/tools/ics-calendar-recurrence-rule-expander): 将带 RRULE 的 VEVENT 展开为具体 occurrence，并导出为 JSON 或展开后的 ICS 日历
- [播客章节标记生成器（ID3 / Podcasting 2.0）](https://elysiatools.com/zh/tools/podcast-chapter-marker-builder): 粘贴时间码章节列表，一次生成全部交付格式：Podcasting 2.0 章节 JSON（v1.2.0）与 RSS podcast:chapters 标签、可选把 ID3v2.4 CHAP+CTOC 章节帧直接烧入上传的 MP3（毫秒为普通大端 uint32、偏移 0xFFFFFFFF、每章嵌 TIT2 子帧、保留原有标签帧）、Vorbis CHAPTER001 注释对（OGG/Opus）、mp4chaps 文本、YouTube 说明栏时间戳块与 SRT 副车文件，并附各播放器真实支持情况（Apple 自 2025 起支持 RSS JSON；Pocket Casts/Overcast 仅读内嵌 ID3；Spotify 两者都不读）。
- [富文本JSON转PDF](https://elysiatools.com/zh/tools/richtext-json-to-pdf): 将TipTap/Quill/Slate导出的JSON转换为PDF

## 示例

- [分布式追踪示例](https://elysiatools.com/zh/samples/distributed-tracing-samples): 使用 Jaeger、OpenTelemetry 和其他现代可观测性工具的综合分布式追踪示例，适用于微服务架构
- [十六进制/Unicode转换样本](https://elysiatools.com/zh/samples/text-hex-unicode-formats): 十六进制和Unicode转义序列转换的测试样本
- [JWT 示例](https://elysiatools.com/zh/samples/jwt-samples): 从基础令牌结构到高级安全实现的全面JWT示例
- [PDF示例](https://elysiatools.com/zh/samples/pdf-samples): 2026-02-01 到 2026-02-10 工具生成的PDF示例

## 相关内容

- [可观测性、日志分析与 Trace 排障工具](https://elysiatools.com/zh/hubs/observability-debugging): 在一个专题里完成日志解析、Trace 检查、API 载荷漂移对比，以及把原始观测数据整理成时间线、时序图和结构化排障证据。
- [结构与逻辑图生成器](https://elysiatools.com/zh/hubs/structural-and-logic-diagram-generators): 从文本、JSON 或日志生成流程图、思维导图、组织架构图、树状图、韦恩图、ASCII 目录树与时序图——用于规划、文档与工程评审。
- [JSON 交换与格式翻译工具](https://elysiatools.com/zh/hubs/json-convert): 在一个专题里比较 JSON 与 CSV、YAML、TOML、GraphQL、XML、Markdown、Excel、BSON、EDN 等结构化格式之间的转换工具。
- [文本大小写、编码与规范化转换工具](https://elysiatools.com/zh/hubs/text-convert): 在一个专题中比较文本大小写转换、全半角转换、编码转换、Quoted-Printable 处理和行内文本规范化工具。