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.
| Código | Nombre | Definido en |
|---|---|---|
| 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 | No registrado: lo envían algunos proveedores de hosting cuando una cuenta agota su cuota de ancho de banda |
| 510 | Not Extended | RFC 2774, ya obsoleta |
| 511 | Network Authentication Required | RFC 6585 |
| 520 | Web Server Returns an Unknown Error | Cloudflare, no registrado |
| 521 | Web Server Is Down | Cloudflare, no registrado |
| 522 | Connection Timed Out | Cloudflare, no registrado |
| 523 | Origin Is Unreachable | Cloudflare, no registrado |
| 524 | A Timeout Occurred | Cloudflare, no registrado |
| 525 | SSL Handshake Failed | Cloudflare, no registrado |
| 526 | Invalid SSL Certificate | Cloudflare, 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
- Lea primero el código exacto: identifica la capa, y la capa determina dónde buscar.
- 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.
- Determine si afecta a todas las peticiones o a una parte, lo que distingue un fallo total de uno parcial.
- Cruce la hora de inicio con despliegues, cambios de configuración e incidentes de dependencias.
- 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.
Guías de errores relacionadas
Términos usados en esta página
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.