Retry on Error konfigurieren

Einrichtung

Über die UI

Der Toggle sitzt im Route-Wizard in Step 5 — Reliability (zusammen mit Circuit Breaker und Request Mirroring).

1. Route erstellen oder bearbeiten
2. In Step 5 Retry on Error Toggle aktivieren
3. Retry Count einstellen (1-10, Standard: 3)
4. Speichern

Über die API

# Retry aktivieren mit 5 Versuchen
curl -X PUT https://gatecontrol.example.com/api/v1/routes/1 \
  -H "Authorization: Bearer gc_..." \
  -H "Content-Type: application/json" \
  -d '{
    "retry_enabled": true,
    "retry_count": 5
  }'

Wichtige Hinweise

• POST/PUT/DELETE werden ebenfalls wiederholt. GateControl führt keine automatische Idempotenz-Prüfung durch — der Admin muss selbst wissen, ob das Backend wiederholbare Schreiboperationen unterstützt. Beispiel: Ein Retry auf POST /api/orders könnte eine doppelte Bestellung auslösen. Retry nur aktivieren wenn das Backend idempotente Operationen unterstützt oder nur GET-Anfragen verarbeitet.
• Retry ist nur für HTTP-Routen verfügbar, nicht für L4 (TCP/UDP).
• Die Retries erfolgen sofort hintereinander — es gibt kein exponentielles Backoff.
• Bei einem einzelnen Backend können Retries den Server zusätzlich belasten, wenn er bereits überlastet ist.
• Retry Count von 1 bedeutet: 1 initialer Versuch + 1 Retry = maximal 2 Anfragen ans Backend.
• Retries sind für den Client unsichtbar — er bekommt entweder die erfolgreiche Antwort oder den letzten Fehler.
• In Kombination mit Circuit Breaker: Wenn der Circuit Breaker offen ist, werden keine Retries versucht (Caddy liefert sofort 503).

Siehe auch

• CIRCUIT-BREAKER.md — schützt das Backend bei dauerhaftem Ausfall
• UPTIME-MONITORING.md — erkennt längere Ausfälle ergänzend zum Retry