Decodificador de trace distribuido e waterfall

Analisa JSON de Jaeger, Zipkin ou OpenTelemetry e mostra spans, duracao e erros em waterfall

Bom para backend, SRE e DevOps ao investigar latencia, dependencias e falhas em traces distribuídos.

Exemplos de resultados

1 Exemplos

Renderizar waterfall de trace de checkout

Decodifica trace do Jaeger e destaca spans lentos e com erro

Trace waterfall renders span timing cards, service summaries, and error highlighting.
Ver parâmetros de entrada
{ "traceJson": "{\n \"data\": [\n {\n \"processes\": {\n \"p1\": {\n \"serviceName\": \"api-gateway\"\n },\n \"p2\": {\n \"serviceName\": \"payment-service\"\n }\n },\n \"spans\": [\n {\n \"traceID\": \"trace-1\",\n \"spanID\": \"1\",\n \"processID\": \"p1\",\n \"operationName\": \"POST /checkout\",\n \"startTime\": 1000000,\n \"duration\": 320000,\n \"references\": [],\n \"tags\": []\n },\n {\n \"traceID\": \"trace-1\",\n \"spanID\": \"2\",\n \"processID\": \"p2\",\n \"operationName\": \"charge-card\",\n \"startTime\": 1080000,\n \"duration\": 180000,\n \"references\": [\n {\n \"refType\": \"CHILD_OF\",\n \"spanID\": \"1\"\n }\n ],\n \"tags\": [\n {\n \"key\": \"error\",\n \"value\": true\n }\n ]\n }\n ]\n }\n ]\n}", "traceFormat": "jaeger", "displayUnit": "ms", "onlyErrors": false }

Fatos principais

Categoria
Desenvolvimento e Web
Tipos de entrada
textarea, select, checkbox
Tipo de saída
html
Cobertura de amostras
4
API disponível
Yes

Visão geral

O Decodificador de Trace Distribuído e Waterfall é uma ferramenta essencial para desenvolvedores backend, SREs e DevOps que precisam analisar a latência e o fluxo de requisições em arquiteturas de microsserviços. Ele converte arquivos JSON exportados do Jaeger, Zipkin ou OpenTelemetry em uma visualização interativa de cascata (waterfall), permitindo identificar rapidamente gargalos de desempenho, dependências lentas e falhas em spans específicos.

Quando usar

  • •Quando precisar investigar gargalos de latência em chamadas de microsserviços.
  • •Para visualizar a hierarquia e a duração de spans exportados de sistemas de telemetria.
  • •Ao depurar falhas em requisições complexas, filtrando rapidamente os spans que retornaram erro.

Como funciona

  • •Cole o JSON do trace gerado pelo Jaeger, Zipkin ou OpenTelemetry no campo de texto principal.
  • •Selecione o formato do trace ou deixe em 'Auto Detect' para que a ferramenta identifique automaticamente.
  • •Ajuste a unidade de tempo (microssegundos, milissegundos ou segundos) e marque a opção de exibir apenas erros, se necessário.
  • •Visualize o gráfico de waterfall renderizado, detalhando a linha do tempo, a duração de cada serviço e os pontos de falha.

Casos de uso

Análise de performance de uma API de checkout que está demorando mais do que o esperado para responder.
Auditoria de dependências em uma arquitetura de microsserviços para entender qual serviço está causando lentidão em cadeia.
Isolamento de falhas em produção filtrando apenas os spans que registraram exceções ou timeouts.

Exemplos

1. Análise de lentidão no fluxo de checkout

Engenheiro de Backend
Contexto
O endpoint de checkout está apresentando picos de latência, mas envolve chamadas para o gateway de API, serviço de pagamento e inventário.
Problema
Identificar qual microsserviço exato está causando a lentidão na requisição.
Como usar
Cole o JSON do Jaeger contendo o trace do checkout, selecione 'Jaeger JSON' e defina a unidade como 'Milliseconds'.
Configuração de exemplo
Formato: Jaeger JSON | Unidade: ms | Mostrar apenas erros: false
Resultado
O gráfico waterfall revela que o serviço de pagamento consumiu 180ms dos 320ms totais, indicando o gargalo exato.

2. Depuração de falhas em requisições distribuídas

Engenheiro de Confiabilidade (SRE)
Contexto
Um alerta de erro 500 foi disparado em um serviço de busca que consulta múltiplos bancos de dados em paralelo.
Problema
Encontrar rapidamente qual das consultas paralelas falhou em um trace com mais de 50 spans.
Como usar
Insira o JSON do OpenTelemetry, ative a opção 'Mostrar apenas spans com erro' e gere a visualização.
Configuração de exemplo
Formato: OpenTelemetry JSON | Mostrar apenas erros: true
Resultado
A interface oculta todos os spans de sucesso e exibe apenas a chamada ao banco de dados de catálogo que retornou timeout, facilitando a resolução.

Testar com amostras

json
Exemplos de Rastreamento Distribuído
Exemplos completos de rastreamento distribuído usando Jaeger, OpenTelemetry e ferramentas modernas de observabilidade
title token distributed
json
Exemplos de Análise de Logs ELK Stack
Exemplos completos de ELK Stack para agregação, processamento e visualização de logs em sistemas distribuídos
preferred input family json
json
Exemplos Apache Pulsar
Exemplos Apache Pulsar incluindo pub/sub, readers, consumers com diferentes tipos de subscrição, gerenciamento de schema e armazenamento tiered para mensageria empresarial
preferred input family json
json
Amostras de Conversor Hex/Unicode
Amostras de teste para conversão de sequências de escape hex e unicode
preferred input family json
json

Hubs relacionados

Ferramentas de Json para Convert
Explore 100 ferramentas de json para fluxos de convert e encontre utilitários próximos com rapidez.
Ferramentas de Json
Explore 44 ferramentas de json para fluxos de utility e encontre utilitários próximos com rapidez.
Ferramentas de Json para Generate
Explore 33 ferramentas de json para fluxos de generate e encontre utilitários próximos com rapidez.
Ferramentas de Json para Format
Explore 9 ferramentas de json para fluxos de format e encontre utilitários próximos com rapidez.

FAQ

Quais formatos de trace são suportados?

A ferramenta suporta arquivos JSON exportados nativamente do Jaeger, Zipkin e OpenTelemetry.

Posso visualizar o tempo em segundos em vez de milissegundos?

Sim, você pode alterar a unidade de exibição para microssegundos, milissegundos ou segundos nas configurações.

Como encontro os erros mais rapidamente em um trace muito grande?

Basta marcar a opção 'Mostrar apenas spans com erro' para ocultar os spans bem-sucedidos e focar exclusivamente nas falhas.

A ferramenta envia meus dados de trace para algum servidor?

Não, todo o processamento e a renderização do gráfico waterfall ocorrem localmente no seu navegador.

O que é um gráfico waterfall de trace?

É uma representação visual em cascata que mostra a ordem cronológica, a duração e a relação pai-filho de cada operação (span) em uma requisição distribuída.

Documentação da API

Ponto final da solicitação

POST /pt/api/tools/distributed-trace-decoder-waterfall-visualizer

Parâmetros da solicitação

Nome do parâmetro Tipo Requerido Descrição
traceJson textarea Não -
traceFormat select Não -
displayUnit select Não -
onlyErrors checkbox Não -

Formato de resposta

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

Documentação de MCP

Adicione este ferramenta à sua configuração de servidor MCP: 

{
  "mcpServers": {
    "elysiatools-distributed-trace-decoder-waterfall-visualizer": {
      "name": "distributed-trace-decoder-waterfall-visualizer",
      "description": "Analisa JSON de Jaeger, Zipkin ou OpenTelemetry e mostra spans, duracao e erros em waterfall",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=distributed-trace-decoder-waterfall-visualizer",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Você pode encadear várias ferramentas, ex: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máx 20 ferramentas.

Se você encontrar algum problema, por favor, entre em contato conosco em [email protected]