日志转时序图转换器

把结构化服务日志转换成 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 可用时会优先做摘要压缩,不可用时自动回退到启发式生成

示例结果

1 个示例

把微服务登录日志转成 Mermaid 时序图

从登录失败调用链中提炼服务跳转、延迟和错误节点,输出可直接复用的时序图源码。

Summary
- Title: Service interaction trace

Diagram
```mermaid
sequenceDiagram
participant api
...```
查看输入参数
{ "logInput": "2026-04-06T10:00:01Z api -> auth POST /login | status=401 | latency=82ms | error=invalid token\n2026-04-06T10:00:01Z auth -> user-db SELECT user_by_email | status=200 | latency=14ms\n2026-04-06T10:00:02Z api -> audit POST /events | status=202 | latency=11ms", "logFile": "", "diagramFormat": "mermaid", "includeLatencyNotes": true, "highlightErrors": true, "maxSteps": 12 }

Click to upload file or drag and drop file here

Maximum file size: 20MB Supported formats: application/json, text/plain, text/log, .log, .txt, .jsonl

关键信息

分类
开发与 Web
输入类型
textarea, file, select, checkbox, number
输出类型
text
样本覆盖
4
支持 API
Yes

概览

日志转时序图转换器是一款专为开发者与运维人员设计的实用工具,能够将结构化的微服务日志、JSON Lines 或追踪风格的文本快速转换为直观的 Mermaid 或 PlantUML 时序图。通过自动提取服务间的调用关系,并支持叠加延迟标注与错误高亮,该工具帮助技术团队轻松可视化复杂的跨服务调用链,大幅提升排查故障、分析性能瓶颈以及编写系统架构文档的效率。

适用场景

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

工作原理

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

使用场景

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

用户案例

1. 微服务登录调用链可视化

后端开发工程师
背景原因
线上出现用户登录失败的客诉,开发人员从日志中心导出了该请求的跨服务调用日志。
解决问题
纯文本日志难以直观看出请求在 api、auth 和 user-db 之间的流转顺序及具体的报错位置。
如何使用
将导出的箭头风格日志粘贴到“日志输入”框,选择 Mermaid 格式,并勾选“包含延迟标注”和“高亮错误”。
示例配置
图格式: Mermaid | 包含延迟标注: 开启 | 高亮错误: 开启 | 最大步骤数: 12
效果
成功生成包含调用摘要的 Mermaid 源码,图表中清晰展示了 api -> auth 的 401 错误及 82ms 的延迟,方便直接粘贴到缺陷报告中。

2. 订单链路性能瓶颈分析

SRE 运维工程师
背景原因
大促期间订单接口响应缓慢,运维收集了包含耗时字段的 JSON Lines 格式 Trace 日志。
解决问题
需要快速找出调用链中耗时最长的微服务节点,以便进行针对性的扩容或限流。
如何使用
上传 order_trace.jsonl 文件,选择 PlantUML 格式,勾选“包含延迟标注”,将最大步骤数设为 20。
效果
工具解析 JSON 中的 latencyMs 字段,生成 PlantUML 时序图源码,直观暴露出 order-service -> inventory-db 节点耗时异常,加速了故障定位。

用 Samples 测试

json, text, file

相关专题

常见问题

支持哪些格式的日志输入?

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

可以上传本地日志文件吗?

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

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

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

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

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

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

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

API 文档

请求端点

POST /zh/api/tools/log-sequence-diagram-converter

请求参数

参数名 类型 必填 描述
logInput textarea -
logFile file (需要先上传) -
diagramFormat select -
includeLatencyNotes checkbox -
highlightErrors checkbox -
maxSteps number -

文件类型参数需要先通过 POST /upload/log-sequence-diagram-converter 上传获取 filePath,然后将 filePath 传递给对应的文件字段。

响应格式

{
  "result": "Processed text content",
  "error": "Error message (optional)",
  "message": "Notification message (optional)",
  "metadata": {
    "key": "value"
  }
}
文本: 文本

AI MCP 文档

将此工具添加到您的 MCP 服务器配置中:

{
  "mcpServers": {
    "elysiatools-log-sequence-diagram-converter": {
      "name": "log-sequence-diagram-converter",
      "description": "把结构化服务日志转换成 Mermaid 或 PlantUML 时序图,并可叠加延迟和错误标注",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=log-sequence-diagram-converter",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

你可以串联多个工具,比如:`https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`,最多20个。

支持 URL 文件链接或 Base64 编码作为文件参数。

如果遇见问题,请联系我们:[email protected]