Guía de errores

Errores 5xx de servidor

La clase que significa que el servidor no pudo atender una petición que, por lo que podía saber, era válida.

Un estado 5xx significa que el servidor no pudo atender una petición que parecía válida. La responsabilidad está del lado del servidor: la aplicación, sus dependencias o la infraestructura que tiene delante. A diferencia de un 4xx, ningún cambio que pudiera hacer el cliente lo habría evitado.

Esta es la clase para la que existe la monitorización, y cada código de ella debería hacer fallar una comprobación por defecto. También es la clase más visible para los clientes, porque un 5xx suele significar que una petición que debía funcionar no funcionó.

El código concreto acota qué capa falló, y eso es la mayor parte del triaje inicial: 500 es la aplicación lanzando una excepción; 502 y 504 son un proxy que informa de que algo detrás de él falló o fue demasiado lento; 503 es un rechazo deliberado por capacidad o mantenimiento; 501 es un método que el servidor no implementa. Llegar rápido a la capa correcta vale más que cualquier cantidad de conjeturas sobre las causas.

Lista de códigos de error 5xx: los errores de servidor registrados, más el 509 y los códigos 52x de Cloudflare
CódigoNombreDefinido en
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 ExceededNo registrado: lo envían algunos proveedores de hosting cuando una cuenta agota su cuota de ancho de banda
510Not ExtendedRFC 2774, ya obsoleta
511Network Authentication RequiredRFC 6585
520Web Server Returns an Unknown ErrorCloudflare, no registrado
521Web Server Is DownCloudflare, no registrado
522Connection Timed OutCloudflare, no registrado
523Origin Is UnreachableCloudflare, no registrado
524A Timeout OccurredCloudflare, no registrado
525SSL Handshake FailedCloudflare, no registrado
526Invalid SSL CertificateCloudflare, no registrado

Causas habituales

  • Una excepción no controlada en el código de la aplicación.
  • Una dependencia (base de datos, caché, cola, API de terceros) que falla o agota el tiempo.
  • Agotamiento de recursos: memoria, descriptores de archivo, pools de conexiones, disco.
  • Un despliegue que introdujo un bug, o un cambio de configuración que rompió una conexión.
  • Un servicio upstream caído, inalcanzable o que responde demasiado despacio.

Cómo diagnosticarlo

  1. Lea primero el código exacto: identifica la capa, y la capa determina dónde buscar.
  2. Compruebe si el error está en el registro de su aplicación o solo en el del proxy: eso por sí solo parte la búsqueda por la mitad.
  3. Determine si afecta a todas las peticiones o a una parte, lo que distingue un fallo total de uno parcial.
  4. Cruce la hora de inicio con despliegues, cambios de configuración e incidentes de dependencias.
  5. Compruebe la salud de cada dependencia antes de depurar su propio código; la mayoría de los incidentes 5xx son la caída de otro que llega hasta usted.

¿De quién es la culpa? Del lado del servidor

Por definición, del lado del servidor, aunque un 5xx suele deberse a una dependencia más que a la propia aplicación, y sigue siendo su incidente aunque no sea su bug.

Qué ve la monitorización

Los criterios por defecto de Uptimely hacen fallar una comprobación ante un 5xx y registran el código exacto. Un monitor declara un incidente cuando se alcanza el umbral de fallos (dos comprobaciones fallidas seguidas por defecto), así que un fallo aislado se registra como caída sin avisar a nadie, mientras que un 5xx sostenido abre un incidente y ejecuta la política de guardia.

Preguntas

¿Debe cada 5xx disparar una alerta?

Cada 5xx debe hacer fallar la comprobación. Que avise o no depende del umbral: esperar a dos fallos seguidos elimina los fallos aislados sin dejar de registrarlos como caída, que casi siempre es el valor por defecto correcto.

¿Qué códigos 5xx señalan a un proxy y no a mi aplicación?

502 y 504 los genera algo que está delante de su aplicación: un proxy inverso o una CDN que informa de que el upstream falló o fue demasiado lento. Un 500 viene de la propia aplicación.

Una de las guías de errores HTTP y de red de Uptimely, escritas para quien opera el servidor y no para quien recarga la página. Something here read wrong to you? Email support@getuptimely.com.

Verificado el por el equipo de Uptimely.