Request Tracing für Fehlersuche nutzen

Wann Request Tracing nutzen?

Request Tracing hilft dir wenn:

• Eine Route 502 oder andere Fehler zurückgibt
• Du eine Redirect-Schleife vermutest
• Requests nicht beim Backend ankommen
• Du prüfen willst welche Headers/IPs ankommen

So aktivierst du Tracing

1. Öffne die betroffene Route (Edit-Modal)
2. Wechsle zum Debug-Tab
3. Aktiviere den Request Tracing Toggle
4. Speichere die Route

Trace-Einträge lesen

Im Debug-Tab siehst du eine Live-Tabelle mit allen Requests:

• Grün (2xx) — Request erfolgreich
• Gelb (4xx) — Client-Fehler (404 Not Found, 403 Forbidden, etc.)
• Rot (5xx) — Server-Fehler (502 Bad Gateway, 503 Service Unavailable, etc.)

Die Tabelle aktualisiert sich automatisch alle 3 Sekunden.

Typische Fehlerbilder

502 Bad Gateway

Das Backend ist nicht erreichbar. Prüfe ob der Peer online ist und der richtige Port konfiguriert ist.

Endlose 302-Redirects

Wenn du mehrere 302-Einträge hintereinander siehst, gibt es eine Redirect-Schleife. Prüfe die Authentifizierungs-Einstellungen der Route.

Keine Einträge

Wenn trotz Requests keine Einträge erscheinen, erreicht der Traffic die Route gar nicht. Prüfe DNS-Einstellungen und die Caddy-Konfiguration.

Wichtig

• Tracing nur temporär aktivieren — es erzeugt zusätzliche Log-Einträge
• Funktioniert nur bei HTTP-Routen (nicht L4/TCP)
• In der Routen-Liste erscheint ein oranges Debug-Badge wenn Tracing aktiv ist