Fehlerleitfäden

HTTP- und Netzwerk­fehler, von der Serverseite aus

Die meisten Seiten über „502 Bad Gateway“ raten, den Cache zu leeren und es später noch einmal zu versuchen, ein nutzloser Rat für die eine Person, die das Problem tatsächlich beheben kann. Diese Leitfäden sind für die Person geschrieben, die den Server betreibt: was der Code über Ihren Stack sagt, welche Ursachen Sie der Reihe nach prüfen sollten, wie Sie erkennen, auf wessen Seite das Problem liegt, und was eine Uptime-Prüfung sieht und was nicht.

Für das Vokabular statt der Codes definiert das Monitoring-Glossar die Begriffe, die diese Leitfäden verwenden. Für TLS- und Zertifikatsfehler wie 525 und 526 zeigt die Überwachung von SSL-Zertifikaten, was ein Zertifikatsmonitor von Uptimely liest und welche Regeln darauf alarmieren. Für die maschinenlesbaren Fehler, die die API von Uptimely selbst zurückgibt, lesen Sie die Dokumentation der API.

Client-Fehler (4xx)

Der Fehler lag in der Anfrage. Bei einer Monitoring-Prüfung heißt das fast immer, dass die Prüfung repariert werden muss und nicht der Dienst, mit zwei Ausnahmen.

4xx-Clientfehler

Die Klasse von Antworten, die besagt, dass der Fehler bei der Anfrage lag. Für einen Monitor heißt ein 4xx meist, dass die Prüfung falsch eingerichtet ist.

400 Bad Request

Der Server konnte die Anfrage in der gesendeten Form nicht parsen oder wollte sie nicht annehmen: Sie war fehlerhaft, bevor irgendeine Logik lief.

401 Unauthorized

Die Anfrage braucht eine Authentifizierung und lieferte keine gültigen Zugangsdaten: Der Server weiß nicht, wer Sie sind.

403 Forbidden

Der Server hat die Anfrage verstanden und weigert sich, sie zu erfüllen: Eine Authentifizierung ändert nichts an der Antwort.

404 Not Found

Der Server hat unter diesem Pfad nichts, und er verrät nicht, ob dort nie etwas war oder nicht mehr ist.

405 Method Not Allowed

Ein Fehler 405 Method Not Allowed bedeutet, dass die URL existiert, die verwendete HTTP-Methode aber nicht annimmt, meist ein GET an einen Endpoint, der für POST gebaut ist.

408 Request Timeout

Der Server hat es aufgegeben, darauf zu warten, dass der Client seine Anfrage fertig sendet.

410 Gone

Die Ressource gab es, und sie wurde dauerhaft entfernt: eine bewusste, endgültige Form des 404.

429 Too Many Requests

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

499 Client Closed Request

Der eigene Code von Nginx für einen Client, der auflegte, bevor die Antwort fertig war: ein Symptom von Langsamkeit, keine Ursache.

Server-Fehler (5xx)

Der Fehler liegt auf Ihrer Seite. Der konkrete Code benennt die Schicht, und das ist schon der größte Teil der Triage.

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.

500 Internal Server Error

Die Anwendung stieß auf einen unbehandelten Fehler: die allgemeine Antwort, wenn nichts Genaueres zutrifft.

501 Not Implemented

Der Server unterstützt die Funktion, die für die Anfrage nötig ist, überhaupt nicht.

502 Bad Gateway

Ein Proxy hat Ihre Anwendung um eine Antwort gebeten und etwas Unbrauchbares bekommen, oder gar nichts.

503 Service Unavailable

Der Server verweigert gerade bewusst den Dienst: überlastet, in Wartung oder ohne gesundes Ziel, an das er weiterleiten kann.

504 Gateway Timeout

Ein Proxy hat auf Ihre Anwendung gewartet und aufgegeben: Der Upstream war erreichbar, nur zu langsam.

508 Loop Detected

Der Server hat eine Anfrage abgebrochen, weil sie sich im Kreis drehte: meist eine Schleife aus Weiterleitungen oder Rewrites.

Cloudflare-Origin-Fehler (52x)

Cloudflares eigene Codes, keine HTTP-Standards. Jeder sagt etwas Bestimmtes über die Strecke zwischen der Edge und Ihrem Origin.

Cloudflare 524 A Timeout Occurred

Cloudflare hat sich mit Ihrem Origin verbunden und die Anfrage gesendet, und der Origin brauchte länger als 125 Sekunden für die Antwort.

Netzwerk- und TLS-Fehler

Fehler ganz ohne Statuscode, weil die Anfrage nie weit genug kam, dass es eine Antwort geben konnte. Das meldet ein Monitor, wenn nichts geantwortet hat.

NXDOMAIN (DNS name not found)

Der DNS-Resolver hat eindeutig geantwortet, dass der Name nicht existiert, noch bevor eine Verbindung versucht wurde.

SSL-Zertifikat abgelaufen

Der Gültigkeitszeitraum des Zertifikats ist abgelaufen, daher lehnt jeder Client die Verbindung ab.

SSL/TLS handshake failed

Ein „SSL handshake failed“ oder ein gescheiterter TLS-Handshake bedeutet, dass die TCP-Verbindung zustande kam und die TLS-Aushandlung darüber nicht.

A code you were looking for and did not find? Email support@getuptimely.com. Damit Sie erfahren, wenn einer davon bei Ihrem eigenen Dienst auftritt: Uptimely checks every minute on the free plan.

Geprüft am vom Uptimely-Team.