DiagramPreview
Advanced previewLive previewExportDeveloper tool

OpenTelemetry Trace to Sequence

Convert OpenTelemetry spans JSON into a Mermaid sequence diagram for request flow review.

Examples
Detected JSON

This input may work better in the matching tool. Open JSON tool

Rendered previewReady
The preview will appear here.

Continue with a related tool

Move this preview into a nearby workflow for conversion, debugging, or export.

How to use

  1. 1Paste source or load a sample.
  2. 2Review the rendered preview or structured output.
  3. 3Copy code, export images, or download generated files.

Common use cases

AI-generated diagram validationDeveloper docs and README workflowsArchitecture, monitoring, and config review

FAQ

What is OpenTelemetry Trace to Sequence for?

Convert OpenTelemetry spans JSON into a Mermaid sequence diagram for request flow review.

Does it require an account?

No. The tool page can be used directly in the browser.

OpenTelemetry Trace to Sequence is designed for developer documentation, AI-generated diagram validation, and engineering configuration visualization.

It helps convert source text, config, or AI output into a previewable and exportable result.

Demo: convert spans into a request sequence

OpenTelemetry traces already contain timing and parent-child relationships. A sequence preview makes it easier to explain a slow request across gateway, service, database, and queue boundaries.

  • Preserve service.name and span.name as participant and message labels.
  • Use timestamps to order sibling spans when possible.
  • Highlight long spans instead of showing every tiny internal operation.
[{"traceId":"t1","spanId":"1","name":"POST /checkout","service.name":"gateway"},{"spanId":"2","parentSpanId":"1","name":"SELECT inventory","service.name":"inventory"}]

Incident review: traces need context

A trace diagram helps tell the story of one request. For incident work, compare it with logs, metrics, and deployment changes so one slow trace is not over-generalized.

  • Use one normal trace and one slow trace for comparison.
  • Collapse low-value internal spans to keep the sequence readable.
  • Remove sensitive attributes before sharing trace JSON.
normal p95 trace -> 280ms
incident trace -> inventory SELECT 2300ms

Review checklist for OpenTelemetry Trace to Sequence

Use OpenTelemetry Trace to Sequence when you need to inspect source content visually before it becomes documentation, a pull request note, an incident write-up, or a handoff artifact. Convert OpenTelemetry spans JSON into a Mermaid sequence diagram for request flow review.

Before exporting, check that labels are readable, relationships match the source, generated examples do not contain private data, and the preview still makes sense after you edit the input.

Limits and troubleshooting

If the preview fails, reduce the input to the smallest complete example, confirm the format syntax, and then add sections back one at a time. Many rendering failures come from partial files, indentation mistakes, missing diagram headers, or copied snippets that depend on hidden context.

Treat the preview as a review surface rather than a source of truth. Generated diagrams, converted files, dashboards, and rule examples should be checked before they are used in production documentation or operations.

Example inputs to test

  • Checkout: { "spans": [ { "name": "POST /checkout", "serviceName": "api", "parentService": "client" }, { "name": "Reserve inventory", "serviceName": "inventory", "parentService": "api" }, { "...
  • Login: { "spans": [ { "name": "POST /login", "serviceName": "web", "parentService": "client" }, { "name": "Validate token", "serviceName": "auth", "parentService": "web" } ] }
  • Queue: { "spans": [ { "name": "Publish event", "serviceName": "api", "parentService": "client" }, { "name": "Consume event", "serviceName": "worker", "parentService": "api" } ] }

Tool maturity

Advanced preview

Advanced parser

This tool extracts useful structure and relationships from developer input. Complex edge cases should still be checked against the source.

The maturity label is not a quality score. It tells visitors whether the tool is best for stable export, deeper debugging, quick parsing, or AI-assisted generation.