Decodificador de trazas distribuidas y waterfall

Analiza JSON de Jaeger, Zipkin u OpenTelemetry y muestra spans, tiempos y errores en un waterfall

Util para backend, SRE y DevOps al revisar latencia, dependencia y fallos en trazas distribuidas.

Resultados de ejemplo

1 Ejemplos

Renderizar una cascada de trazas de checkout

Decodifica una traza de Jaeger y resalta spans lentos y errores

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 }

Datos clave

Categoría
Desarrollo y Web
Tipos de entrada
textarea, select, checkbox
Tipo de salida
html
Cobertura de muestras
4
API disponible
Yes

Resumen

Un decodificador y visualizador de trazas distribuidas que analiza archivos JSON de Jaeger, Zipkin u OpenTelemetry para generar un diagrama de cascada (waterfall) interactivo. Esta herramienta permite a los equipos de backend, SRE y DevOps inspeccionar la latencia, identificar cuellos de botella y detectar errores en arquitecturas de microservicios de forma rápida y visual.

Cuándo usarlo

  • Cuando necesitas investigar picos de latencia en llamadas a microservicios.
  • Para identificar qué servicio específico está fallando dentro de una cadena de peticiones compleja.
  • Al migrar o depurar instrumentación de OpenTelemetry, Jaeger o Zipkin y validar la jerarquía de spans.

Cómo funciona

  • Pega el JSON de tu traza en el campo de texto principal.
  • Selecciona el formato de la traza (Jaeger, Zipkin, OpenTelemetry o detección automática) y la unidad de tiempo deseada (microsegundos, milisegundos o segundos).
  • Activa la opción de mostrar solo errores si deseas filtrar los spans exitosos y enfocarte en los fallos.
  • La herramienta procesa los datos y renderiza un diagrama de cascada que muestra la duración, jerarquía y estado de cada span.

Casos de uso

Análisis de rendimiento en procesos de pago (checkout) para descubrir qué dependencia externa está ralentizando la transacción.
Depuración de errores 500 en un API Gateway rastreando la petición hasta el microservicio de base de datos que originó el fallo.
Validación de la correcta propagación del contexto (TraceID y SpanID) durante la implementación inicial de OpenTelemetry.

Ejemplos

1. Análisis de latencia en un flujo de pago

Ingeniero Backend
Contexto
Los usuarios reportan lentitud al finalizar compras. El sistema está compuesto por un API Gateway, un servicio de pagos y un servicio de inventario.
Problema
Identificar cuál de los microservicios está causando el retraso en la petición de checkout.
Cómo usarlo
Pega el JSON exportado de Jaeger en la herramienta, selecciona 'Jaeger JSON' y ajusta la unidad a 'ms'.
Configuración de ejemplo
Formato: Jaeger JSON, Unidad: ms, Mostrar solo errores: false
Resultado
El diagrama de cascada revela que el servicio de pagos consume el 80% del tiempo total de la petición, permitiendo enfocar la optimización en ese componente.

2. Aislamiento rápido de fallos en microservicios

Ingeniero SRE
Contexto
Una alerta de monitoreo indica una alta tasa de errores en una traza compleja con más de 50 spans.
Problema
Encontrar rápidamente el span exacto que originó la excepción sin tener que leer todo el JSON manualmente.
Cómo usarlo
Pega el JSON de OpenTelemetry y activa la opción 'Mostrar solo spans con error'.
Configuración de ejemplo
Formato: OpenTelemetry JSON, Mostrar solo errores: true
Resultado
La vista filtra los spans exitosos y muestra únicamente la consulta a la base de datos que falló por un timeout, acelerando la resolución del incidente.

Probar con muestras

json

Hubs relacionados

Preguntas frecuentes

¿Qué formatos de traza soporta la herramienta?

Soporta de forma nativa archivos JSON exportados desde Jaeger, Zipkin y OpenTelemetry. También cuenta con una opción de detección automática.

¿Puedo cambiar la unidad de tiempo mostrada en el diagrama?

Sí, puedes alternar entre microsegundos (us), milisegundos (ms) y segundos (s) según la precisión que necesites para tu análisis.

¿Cómo encuentro rápidamente los errores en una traza muy grande?

Puedes marcar la casilla 'Mostrar solo spans con error' para ocultar las operaciones exitosas y visualizar únicamente los nodos que fallaron.

¿Los datos de mi traza se envían a algún servidor?

No, el procesamiento y la visualización del JSON se realizan localmente en tu navegador, garantizando la privacidad de tus datos.

¿Qué información muestra el diagrama de cascada?

Muestra la jerarquía de llamadas (padre-hijo), el nombre del servicio, la operación, la duración exacta y resalta visualmente los spans que contienen etiquetas de error.

Documentación de la API

Punto final de la solicitud

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

Parámetros de la solicitud

Nombre del parámetro Tipo Requerido Descripción
traceJson textarea No -
traceFormat select No -
displayUnit select No -
onlyErrors checkbox No -

Formato de respuesta

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

Documentación de MCP

Agregue este herramienta a su configuración de servidor MCP:

{
  "mcpServers": {
    "elysiatools-distributed-trace-decoder-waterfall-visualizer": {
      "name": "distributed-trace-decoder-waterfall-visualizer",
      "description": "Analiza JSON de Jaeger, Zipkin u OpenTelemetry y muestra spans, tiempos y errores en un waterfall",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=distributed-trace-decoder-waterfall-visualizer",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Puede encadenar múltiples herramientas, por ejemplo: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máximo 20 herramientas.

Si encuentra algún problema, por favor, póngase en contacto con nosotros en [email protected]