Guide des erreurs

Erreurs serveur 5xx

La classe qui signifie que le serveur n'a pas pu traiter une requête qui, à sa connaissance, était valide.

Un statut 5xx signifie que le serveur n'a pas pu traiter une requête qui semblait valide. La responsabilité se trouve côté serveur : l'application, ses dépendances ou l'infrastructure placée devant elle. Contrairement à un 4xx, aucun changement côté client ne l'aurait évité.

C'est la classe pour laquelle la surveillance existe, et chacun de ses codes devrait faire échouer une vérification par défaut. C'est aussi la classe la plus visible pour les clients, car un 5xx signifie généralement qu'une requête qui aurait dû fonctionner n'a pas fonctionné.

Le code précis indique quelle couche a échoué, ce qui constitue l'essentiel du premier tri : 500, c'est l'application qui lève une exception ; 502 et 504, c'est un proxy qui signale que quelque chose derrière lui a échoué ou a été trop lent ; 503 est un refus délibéré pour cause de capacité ou de maintenance ; 501 est une méthode que le serveur n'implémente pas. Atteindre vite la bonne couche vaut plus que n'importe quelle supposition sur les causes.

Liste des codes d'erreur 5xx : les erreurs serveur enregistrées, plus 509 et les codes 52x de Cloudflare
CodeNomDéfini dans
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 ExceededNon enregistré : envoyé par certains hébergeurs quand un compte a épuisé son quota de bande passante
510Not ExtendedRFC 2774, désormais obsolète
511Network Authentication RequiredRFC 6585
520Web Server Returns an Unknown ErrorCloudflare, non enregistré
521Web Server Is DownCloudflare, non enregistré
522Connection Timed OutCloudflare, non enregistré
523Origin Is UnreachableCloudflare, non enregistré
524A Timeout OccurredCloudflare, non enregistré
525SSL Handshake FailedCloudflare, non enregistré
526Invalid SSL CertificateCloudflare, non enregistré

Causes fréquentes

  • Une exception non gérée dans le code de l'application.
  • Une dépendance (base de données, cache, file d'attente, API tierce) qui échoue ou dépasse son délai.
  • L'épuisement des ressources : mémoire, descripteurs de fichiers, pools de connexions, disque.
  • Un déploiement qui a introduit un bug, ou un changement de configuration qui a cassé une connexion.
  • Un service upstream en panne, injoignable ou qui répond trop lentement.

Comment le diagnostiquer

  1. Lisez d'abord le code exact : il identifie la couche, et la couche indique où chercher.
  2. Vérifiez si l'erreur figure dans le journal de votre application ou seulement dans celui du proxy : cela suffit à couper la recherche en deux.
  3. Établissez si toutes les requêtes sont touchées ou seulement une partie, ce qui distingue une panne totale d'une panne partielle.
  4. Rapprochez l'heure de début des déploiements, des changements de configuration et des incidents de dépendances.
  5. Vérifiez la santé de chaque dépendance avant de déboguer votre propre code ; la plupart des incidents 5xx sont la panne de quelqu'un d'autre qui arrive chez vous.

À qui la faute ? Côté serveur

Par définition côté serveur, même si un 5xx est souvent causé par une dépendance plutôt que par l'application elle-même, et cela reste votre incident même quand ce n'est pas votre bug.

Ce que voit la surveillance

Les critères par défaut d'Uptimely font échouer une vérification sur un 5xx et enregistrent le code exact. Un moniteur déclare un incident une fois le seuil d'échec atteint (deux vérifications échouées d'affilée par défaut) : un incident isolé est donc enregistré comme indisponibilité sans alerter personne, tandis qu'un 5xx persistant ouvre un incident et déclenche la politique d'astreinte.

Questions

Chaque 5xx doit-il déclencher une alerte ?

Chaque 5xx doit faire échouer la vérification. Qu'il déclenche une alerte dépend du seuil : attendre deux échecs d'affilée élimine les incidents isolés tout en les enregistrant comme indisponibilité, ce qui est presque toujours le bon réglage par défaut.

Quels codes 5xx désignent un proxy plutôt que mon application ?

502 et 504 sont produits par quelque chose placé devant votre application : un reverse proxy ou un CDN qui signale que l'upstream a échoué ou a été trop lent. Un 500 vient de l'application elle-même.

L'un des guides Uptimely des erreurs HTTP et réseau, écrits pour la personne qui exploite le serveur plutôt que pour celle qui recharge la page. Something here read wrong to you? Email support@getuptimely.com.

Vérifié le par l'équipe Uptimely.