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.
| Code | Name | Definiert in |
|---|---|---|
| 500 | Internal Server Error | RFC 9110 |
| 501 | Not Implemented | RFC 9110 |
| 502 | Bad Gateway | RFC 9110 |
| 503 | Service Unavailable | RFC 9110 |
| 504 | Gateway Timeout | RFC 9110 |
| 505 | HTTP Version Not Supported | RFC 9110 |
| 506 | Variant Also Negotiates | RFC 2295 |
| 507 | Insufficient Storage | RFC 4918 (WebDAV) |
| 508 | Loop Detected | RFC 5842 (WebDAV) |
| 509 | Bandwidth Limit Exceeded | Nicht registriert: von manchen Webhostern gesendet, wenn ein Konto sein Bandbreitenkontingent aufgebraucht hat |
| 510 | Not Extended | RFC 2774, inzwischen veraltet |
| 511 | Network Authentication Required | RFC 6585 |
| 520 | Web Server Returns an Unknown Error | Cloudflare, nicht registriert |
| 521 | Web Server Is Down | Cloudflare, nicht registriert |
| 522 | Connection Timed Out | Cloudflare, nicht registriert |
| 523 | Origin Is Unreachable | Cloudflare, nicht registriert |
| 524 | A Timeout Occurred | Cloudflare, nicht registriert |
| 525 | SSL Handshake Failed | Cloudflare, nicht registriert |
| 526 | Invalid SSL Certificate | Cloudflare, 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
- Lesen Sie zuerst den genauen Code: Er benennt die Schicht, und die Schicht bestimmt, wo Sie suchen.
- Prüfen Sie, ob der Fehler im Log Ihrer Anwendung steht oder nur in dem des Proxys: Das allein halbiert die Suche.
- Klären Sie, ob alle Anfragen betroffen sind oder nur ein Teil, das unterscheidet einen Totalausfall von einem Teilausfall.
- Gleichen Sie den Beginn mit Deployments, Konfigurationsänderungen und Incidents bei Abhängigkeiten ab.
- 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.
Verwandte Fehlerleitfäden
Begriffe auf dieser Seite
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.