Fehlerleitfaden

429 Too Many Requests

Der Client wurde per Rate Limit gebremst: Der Server weist seine Anfragen bewusst ab, um sich zu schützen.

Ein 429 bedeutet, dass der Client zu viele Anfragen gesendet hat und der Server weitere vorerst ablehnt. Das ist kein Ausfall im üblichen Sinn: Der Server ist gesund und schützt sich bewusst oder setzt ein Kontingent durch. Ein sauber implementierter 429 enthält einen Header Retry-After, der angibt, wie lange zu warten ist.

Er ist der für den Betrieb interessanteste Code der 4xx-Klasse, weil er als einziger verlässlich etwas über die Kapazität aussagt statt über die Korrektheit. Eine steigende 429-Rate bei unverändertem Verhalten der Clients bedeutet, dass das Wachstum an die Limits stößt, dass Limits verschärft wurden oder dass etwas viel aggressiver wiederholt als früher.

Im Monitoring hat er eine besondere Falle: Ein Monitor, der häufig prüft, kann selbst ein Rate Limit auslösen, besonders wenn sich mehrere Monitore eine ausgehende IP mit anderem Traffic teilen. Der Alarm beschreibt dann das Monitoring, nicht den Dienst.

Häufige Ursachen

  • Echter Traffic, der ein konfiguriertes Rate Limit oder Kontingent überschreitet.
  • Eine Retry-Schleife ohne Backoff, die einen vorübergehenden Fehler zu einem anhaltenden aufbläht.
  • Monitoring-Prüfungen in kurzem Intervall, die auf dasselbe Limit angerechnet werden wie echter Traffic.
  • Rate Limiting pro IP, wo sich viele Clients eine Adresse teilen, sodass ein lauter Nachbar das Kontingent aller aufbraucht.
  • Ein Kontingent der API, täglich oder monatlich statt pro Sekunde, das für den Zeitraum aufgebraucht ist.
  • Eine WAF oder ein Edge-Produkt, das Anfragen drosselt, die es als automatisiert einstuft.

So finden Sie die Ursache

  1. Lesen Sie Retry-After und eventuelle Header wie X-RateLimit: Sie nennen meist das Limit, das verbleibende Kontingent und den Zeitpunkt des Zurücksetzens.
  2. Stellen Sie fest, welche Schicht drosselt (das CDN, ein Gateway vor der API oder die Anwendung), denn jede hat ihre eigene Konfiguration.
  3. Prüfen Sie, ob das Limit pro IP, pro Schlüssel oder pro Konto gilt; davon hängt ab, wer tatsächlich darum konkurriert.
  4. Suchen Sie nach einem Retry-Sturm: Ein Client ohne Backoff macht aus einer langsamen Antwort Hunderte von Anfragen.
  5. Wenn das Monitoring beteiligt ist, verlängern Sie das Prüfintervall oder setzen Sie den Monitor auf eine Allowlist, statt das Limit zu entfernen.

Wessen Fehler ist es? Das hängt von der Schicht ab

Der Server arbeitet wie vorgesehen, formal liegt der Fehler also beim Client, der das Limit überschreitet. Ein 429, der echte Nutzer erreicht, ist aber ein Kapazitäts- oder Konfigurationsproblem, das man wie einen serverseitigen Incident behandeln sollte.

Was das Monitoring sieht

Uptimely speichert den Statuscode, sodass ein 429 als das erkennbar ist, was er ist, und nicht als anonymer Fehler. Wenn die Prüfungen selbst das Limit auslösen, hilft ein längeres Intervall oder eine Allowlist an der Edge: Ein Monitor, dessen Alarme der Monitor selbst verursacht, ist die eindeutigste Quelle von Alarmmüdigkeit überhaupt.

Fragen

Ist ein 429 eine Downtime?

Für den Client, der ihn erhält, praktisch ja: Die Anfrage war nicht erfolgreich. Für den Dienst ist es so vorgesehen. Ob er auf Ihre Statusseite gehört, hängt davon ab, ob echte Nutzer an das Limit stoßen oder nur automatisierte Clients.

Kann mein Uptime-Monitor 429er verursachen?

Ja, besonders bei kurzen Intervallen oder wenn sich mehrere Monitore eine ausgehende IP mit anderem Traffic teilen. Verlängern Sie das Intervall oder setzen Sie den Monitor an der Edge auf eine Allowlist; entfernen Sie nicht das Rate Limit, nur damit eine Prüfung besteht.

Einer der Uptimely-Leitfäden zu HTTP- und Netzwerkfehlern, geschrieben für die Person, die den Server betreibt, und nicht für die, die die Seite neu lädt. Something here read wrong to you? Email support@getuptimely.com.

Geprüft am vom Uptimely-Team.