Decoder fuer Distributed Traces und Waterfall-Ansicht

Analysiert Jaeger-, Zipkin- oder OpenTelemetry-Trace-JSON und visualisiert Spans, Laufzeiten und Fehler

Geeignet fuer Backend, SRE und DevOps bei Performance- und Fehleranalysen in verteilten Systemen.

Beispielergebnisse

1 Beispiele

Checkout-Trace als Waterfall darstellen

Dekodiert eine Jaeger-Trace und markiert langsame oder fehlerhafte Spans

Trace waterfall renders span timing cards, service summaries, and error highlighting.
Eingabeparameter anzeigen
{ "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 }

Wichtige Fakten

Kategorie
Entwicklung & Web
Eingabetypen
textarea, select, checkbox
Ausgabetyp
html
Sample-Abdeckung
4
API verfügbar
Yes

Überblick

Dieses Tool analysiert JSON-Daten von verteilten Tracing-Systemen wie Jaeger, Zipkin oder OpenTelemetry und visualisiert sie als übersichtliches Waterfall-Diagramm. Es hilft Backend-Entwicklern, SREs und DevOps-Teams dabei, Spans, Laufzeiten und Fehler in komplexen Microservice-Architekturen schnell zu identifizieren und Performance-Engpässe zu beheben.

Wann verwenden

  • Bei der Analyse von Performance-Engpässen und hohen Latenzen in verteilten Microservice-Architekturen.
  • Zur schnellen Fehlersuche (Debugging), wenn bestimmte API-Anfragen oder Backend-Prozesse fehlschlagen.
  • Um rohe Trace-JSON-Exporte aus Jaeger, Zipkin oder OpenTelemetry ohne lokales Setup visuell aufzubereiten.

So funktioniert es

  • Fügen Sie den rohen Trace-JSON-Code aus Ihrem Tracing-System in das Eingabefeld ein.
  • Wählen Sie das entsprechende Trace-Format (Jaeger, Zipkin, OpenTelemetry) oder nutzen Sie die automatische Erkennung.
  • Passen Sie die Anzeigeeinheit (Mikrosekunden, Millisekunden, Sekunden) an und filtern Sie bei Bedarf nach Fehler-Spans.
  • Das Tool generiert sofort ein interaktives Waterfall-Diagramm, das die Hierarchie, Dauer und Fehler der einzelnen Spans darstellt.

Anwendungsfälle

Visualisierung eines langsamen Checkout-Prozesses zur Identifizierung des blockierenden Microservices.
Isolierung von Datenbank-Timeouts durch das Filtern nach Fehler-Spans in einem umfangreichen OpenTelemetry-Trace.
Überprüfung der parallelen Ausführung von API-Aufrufen anhand der überlappenden Spans im Waterfall-Diagramm.

Beispiele

1. Checkout-Trace als Waterfall darstellen

Backend-Entwickler
Hintergrund
Ein API-Gateway meldet hohe Latenzen beim Checkout-Prozess. Der Entwickler hat den Jaeger-Trace als JSON exportiert.
Problem
Die rohe JSON-Datei ist zu komplex, um den genauen Service zu finden, der die Verzögerung verursacht.
Verwendung
Fügen Sie das Jaeger-JSON ein, setzen Sie das Format auf 'Jaeger JSON' und die Einheit auf 'ms'.
Beispielkonfiguration
traceFormat: jaeger, displayUnit: ms, onlyErrors: false
Ergebnis
Das Tool generiert ein Waterfall-Diagramm, das zeigt, dass der 'payment-service' 180ms der gesamten 320ms beansprucht und einen Fehler wirft.

2. Fehleranalyse in einem Zipkin-Trace

SRE (Site Reliability Engineer)
Hintergrund
In der Produktion treten sporadisch Fehler in einer verteilten Transaktion auf. Ein Zipkin-Trace mit über 500 Spans liegt vor.
Problem
Das manuelle Durchsuchen des JSON-Dokuments nach dem fehlschlagenden Span ist ineffizient und fehleranfällig.
Verwendung
Fügen Sie das Zipkin-JSON ein und aktivieren Sie die Checkbox 'Nur Fehler-Spans anzeigen'.
Beispielkonfiguration
traceFormat: zipkin, onlyErrors: true
Ergebnis
Das Diagramm blendet alle erfolgreichen Operationen aus und hebt ausschließlich die fehlerhaften Spans inklusive ihrer Dauer hervor.

Mit Samples testen

json

Verwandte Hubs

FAQ

Welche Tracing-Formate werden unterstützt?

Das Tool unterstützt JSON-Exporte von Jaeger, Zipkin und OpenTelemetry. Es bietet zudem eine automatische Formaterkennung.

Benötige ich ein lokales Tracing-Backend, um das Tool zu nutzen?

Nein, das Tool wandelt das rohe JSON direkt in eine visuelle HTML-Darstellung um, ohne dass ein Tracing-Server installiert sein muss.

Kann ich mir nur fehlerhafte Spans anzeigen lassen?

Ja, durch Aktivieren der Option 'Nur Fehler-Spans anzeigen' wird das Waterfall-Diagramm auf Spans reduziert, die Fehler-Tags enthalten.

Wie kann ich die Zeiteinheiten im Diagramm anpassen?

Sie können über das Dropdown-Menü 'Anzeigeeinheit' zwischen Mikrosekunden (us), Millisekunden (ms) und Sekunden (s) wählen.

Was zeigt die Waterfall-Ansicht genau an?

Die Waterfall-Ansicht stellt die zeitliche Abfolge und Verschachtelung (Parent/Child-Beziehungen) von Spans grafisch dar, um Latenzen und Abhängigkeiten sichtbar zu machen.

API-Dokumentation

Request-Endpunkt

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

Request-Parameter

Parameter-Name Typ Erforderlich Beschreibung
traceJson textarea Nein -
traceFormat select Nein -
displayUnit select Nein -
onlyErrors checkbox Nein -

Antwortformat

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

MCP-Dokumentation

Fügen Sie dieses Tool zu Ihrer MCP-Server-Konfiguration hinzu:

{
  "mcpServers": {
    "elysiatools-distributed-trace-decoder-waterfall-visualizer": {
      "name": "distributed-trace-decoder-waterfall-visualizer",
      "description": "Analysiert Jaeger-, Zipkin- oder OpenTelemetry-Trace-JSON und visualisiert Spans, Laufzeiten und Fehler",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=distributed-trace-decoder-waterfall-visualizer",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Sie können mehrere Tools verketten, z.B.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, maximal 20 Tools.

Wenn Sie auf Probleme stoßen, kontaktieren Sie uns bitte bei [email protected]