Fehlerleitfaden

5xx-Serverfehler

Die Klasse, die besagt, dass der Server eine Anfrage nicht erfüllen konnte, die nach allem, was er erkennen konnte, gültig war.

Ein 5xx-Status bedeutet, dass der Server eine scheinbar gültige Anfrage nicht erfüllen konnte. Die Verantwortung liegt auf der Serverseite: bei der Anwendung, ihren Abhängigkeiten oder der Infrastruktur davor. Anders als bei einem 4xx hätte keine Änderung auf Seiten des Clients ihn verhindert.

Für diese Klasse gibt es Monitoring, und jeder Code darin sollte eine Prüfung standardmäßig scheitern lassen. Es ist auch die Klasse, die Kunden am deutlichsten sehen, denn ein 5xx bedeutet meist, dass eine Anfrage, die hätte funktionieren sollen, nicht funktioniert hat.

Der genaue Code grenzt ein, welche Schicht ausgefallen ist, und das ist der Großteil der ersten Einordnung: 500 ist die Anwendung, die eine Exception wirft; 502 und 504 sind ein Proxy, der meldet, dass etwas hinter ihm ausgefallen oder zu langsam war; 503 ist eine bewusste Ablehnung wegen Kapazität oder Wartung; 501 ist eine Methode, die der Server nicht implementiert. Schnell bei der richtigen Schicht zu sein ist mehr wert als jedes Raten nach Ursachen.

Liste der 5xx-Fehlercodes: die registrierten Serverfehler, dazu 509 und Cloudflares 52x-Codes
CodeNameDefiniert in
500Internal Server ErrorRFC 9110
501Not ImplementedRFC 9110
502Bad GatewayRFC 9110
503Service UnavailableRFC 9110
504Gateway TimeoutRFC 9110
505HTTP Version Not SupportedRFC 9110
506Variant Also NegotiatesRFC 2295
507Insufficient StorageRFC 4918 (WebDAV)
508Loop DetectedRFC 5842 (WebDAV)
509Bandwidth Limit ExceededNicht registriert: von manchen Webhostern gesendet, wenn ein Konto sein Bandbreitenkontingent aufgebraucht hat
510Not ExtendedRFC 2774, inzwischen veraltet
511Network Authentication RequiredRFC 6585
520Web Server Returns an Unknown ErrorCloudflare, nicht registriert
521Web Server Is DownCloudflare, nicht registriert
522Connection Timed OutCloudflare, nicht registriert
523Origin Is UnreachableCloudflare, nicht registriert
524A Timeout OccurredCloudflare, nicht registriert
525SSL Handshake FailedCloudflare, nicht registriert
526Invalid SSL CertificateCloudflare, nicht registriert

Häufige Ursachen

  • Eine unbehandelte Exception im Anwendungscode.
  • Eine Abhängigkeit (Datenbank, Cache, Queue, Drittanbieter-API), die ausfällt oder in ein Timeout läuft.
  • Erschöpfte Ressourcen: Arbeitsspeicher, Dateideskriptoren, Connection-Pools, Festplatte.
  • Ein Deployment, das einen Bug ausgeliefert hat, oder eine Konfigurationsänderung, die eine Verbindung gekappt hat.
  • Ein Upstream-Dienst, der ausgefallen, nicht erreichbar oder zu langsam ist.

So finden Sie die Ursache

  1. Lesen Sie zuerst den genauen Code: Er benennt die Schicht, und die Schicht bestimmt, wo Sie suchen.
  2. Prüfen Sie, ob der Fehler im Log Ihrer Anwendung steht oder nur in dem des Proxys: Das allein halbiert die Suche.
  3. Klären Sie, ob alle Anfragen betroffen sind oder nur ein Teil, das unterscheidet einen Totalausfall von einem Teilausfall.
  4. Gleichen Sie den Beginn mit Deployments, Konfigurationsänderungen und Incidents bei Abhängigkeiten ab.
  5. Prüfen Sie den Zustand jeder Abhängigkeit, bevor Sie Ihren eigenen Code debuggen; die meisten 5xx-Incidents sind der Ausfall eines anderen, der bei Ihnen ankommt.

Wessen Fehler ist es? Auf der Seite des Servers

Per Definition die Serverseite, auch wenn ein 5xx oft von einer Abhängigkeit ausgelöst wird und nicht von der Anwendung selbst, und es bleibt Ihr Incident, auch wenn es nicht Ihr Bug ist.

Was das Monitoring sieht

Die Standardkriterien von Uptimely lassen eine Prüfung bei einem 5xx scheitern und speichern den genauen Code. Ein Monitor ruft einen Incident aus, sobald die Fehlerschwelle erreicht ist (standardmäßig zwei fehlgeschlagene Prüfungen in Folge), ein einzelner Aussetzer wird also als Ausfallzeit erfasst, ohne jemanden zu alarmieren, während ein anhaltender 5xx einen Incident eröffnet und die Bereitschaftsrichtlinie auslöst.

Fragen

Sollte jeder 5xx einen Alarm auslösen?

Jeder 5xx sollte die Prüfung scheitern lassen. Ob er alarmiert, hängt von der Schwelle ab: Das Warten auf zwei Fehler in Folge filtert einzelne Aussetzer heraus und erfasst sie trotzdem als Ausfallzeit, und das ist fast immer die richtige Voreinstellung.

Welche 5xx-Codes deuten auf einen Proxy statt auf meine Anwendung?

502 und 504 erzeugt etwas, das vor Ihrer Anwendung sitzt: ein Reverse Proxy oder ein CDN, das meldet, dass der Upstream ausgefallen oder zu langsam war. Ein 500 kommt von der Anwendung selbst.

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.