# 分布式追踪解码与瀑布图可视化

解析 Jaeger、Zipkin 或 OpenTelemetry 的 trace JSON，并以瀑布图展示 span 时序与异常节点

> 标准页面: https://elysiatools.com/zh/tools/distributed-trace-decoder-waterfall-visualizer

- **分类:** Development

- **关键词:** trace, jaeger, zipkin, opentelemetry, 瀑布图, span, 链路追踪

## 概述

适合后端、SRE 和 DevOps 排查调用链性能问题，快速查看服务耗时、嵌套深度和错误热点。

## 输入项

- **Trace JSON** (textarea): { "data": \[ ... \] }
- **Trace 格式** (select)
- **显示单位** (select)
- **仅显示异常 Span** (checkbox)

## 适用场景

- 微服务架构下出现接口响应超时，需要排查具体是哪个底层服务导致延迟时。
- 系统报警提示调用链中存在大量错误，需要快速过滤并定位异常 Span 节点时。
- 分析和优化复杂业务链路（如电商结账、订单处理）的性能瓶颈与依赖关系时。

## 工作原理

- 将导出的 Trace JSON 数据粘贴到输入框中。
- 选择对应的追踪数据格式（支持 Jaeger、Zipkin、OpenTelemetry 或自动检测），并设置合适的时间显示单位（微秒、毫秒或秒）。
- 勾选「仅显示异常 Span」可过滤掉正常节点，专注于错误排查。
- 工具将解析 JSON 结构，渲染出包含服务摘要、耗时条和错误高亮的交互式瀑布图。

## 使用案例

- 排查 API 网关到多个下游微服务的请求延迟分布。
- 可视化展示数据库查询、缓存读取及第三方 API 调用的时序与并发情况。
- 在故障复盘时，通过仅查看异常 Span 快速还原错误发生时的调用上下文。

## 常见问题

### 支持哪些分布式追踪系统的 JSON 格式？

目前支持 Jaeger、Zipkin 和 OpenTelemetry 导出的标准 JSON 格式，您也可以选择“自动检测”让工具自行识别。

### 数据处理是在本地进行还是会上传到服务器？

所有 Trace JSON 数据的解析和瀑布图渲染均在您的浏览器本地完成，不会上传任何敏感的调用链数据。

### 如何快速找到调用链中的报错节点？

您可以在配置中勾选“仅显示异常 Span”选项，瀑布图将自动过滤掉正常的调用节点，只展示带有错误标记的 Span。

### 瀑布图的时间单位可以调整吗？

可以。工具支持将时间显示单位切换为微秒（us）、毫秒（ms）或秒（s），以适应不同耗时级别的链路分析。

### 为什么粘贴 JSON 后没有渲染出瀑布图？

请检查粘贴的 JSON 格式是否完整且合法，并确认其属于受支持的 Jaeger、Zipkin 或 OpenTelemetry 格式。

## 相关工具

- [Snowflake / Discord ID 位字段解码器](https://elysiatools.com/zh/tools/snowflake-discord-id-bit-decoder): 使用无损 64 位解析 Snowflake 风格 ID，提取时间戳、worker、process、sequence 或平台特有字段，并可推断 Discord shard。
- [Terraform Plan 可视化器](https://elysiatools.com/zh/tools/terraform-plan-visualizer): 解析 Terraform plan 的 JSON 或文本输出，对资源变化分类，并在 apply 前展示依赖导向的摘要报告
- [WebAuthn Passkey Assertion 解码与 Challenge 调试器](https://elysiatools.com/zh/tools/webauthn-passkey-assertion-decoder-challenge-debugger): 解析 clientDataJSON、authenticatorData、flags、rpIdHash 和 signCount；提供公钥时验证 ES256、RS256 或 Ed25519 签名。
- [JWT 解析与签名验证器](https://elysiatools.com/zh/tools/jwt-inspector-verifier): 解析 JWT 的 header/payload 并高亮显示，诊断 exp/nbf/iat/iss/aud/sub/jti 等 claim，使用 HS*/RS*/PS*/ES*/EdDSA 密钥验签，并提供篡改 payload 的伪造教学演示
- [BSON转换器](https://elysiatools.com/zh/tools/bson-converter): 将数据编码/解码为BSON（Binary JSON）格式
- [JWT 解码器](https://elysiatools.com/zh/tools/jwt-decoder): 解码 JWT 令牌
- [Smile转换器](https://elysiatools.com/zh/tools/smile-converter): 将数据编码/解码为Smile（二进制JSON）格式
- [UBJSON转换器](https://elysiatools.com/zh/tools/ubjson-converter): 将数据编码/解码为UBJSON（通用二进制JSON）格式

## 示例

- [分布式追踪示例](https://elysiatools.com/zh/samples/distributed-tracing-samples): 使用 Jaeger、OpenTelemetry 和其他现代可观测性工具的综合分布式追踪示例，适用于微服务架构
- [AWS EventBridge 示例](https://elysiatools.com/zh/samples/eventbridge-samples): AWS EventBridge 示例，包括事件总线、规则、目标、模式注册表、自定义事件和跨账户事件路由，适用于无服务器事件驱动架构
- [JWT 示例](https://elysiatools.com/zh/samples/jwt-samples): 从基础令牌结构到高级安全实现的全面JWT示例
- [PDF示例](https://elysiatools.com/zh/samples/pdf-samples): 2026-02-01 到 2026-02-10 工具生成的PDF示例

## 相关内容

- [用日志、链路、Webhook 和 JSON 载荷做可观测性调试](https://elysiatools.com/zh/hubs/observability-debugging): 解析日志，解码调用链，检查 Webhook/API 证据，探索 JSON 载荷，并提取重复模式，形成可用于事故复盘的调试结论。