Guía de errores

Errores 4xx de cliente

La clase de respuestas que indica que el fallo está en la petición. Para un monitor, un 4xx suele significar que la comprobación está mal configurada.

Los errores 4xx son la clase de códigos de estado HTTP de error del cliente, del 400 al 499. Un 4xx dice que el servidor entendió la petición y la rechazó porque el problema era la propia petición: mal formada, sin autorización, dirigida a algo que no existe o con un método no permitido. El servidor funciona y responde. Lo que dice es que la pregunta estaba mal.

Los códigos que verá con más frecuencia son 400 Bad Request (la petición estaba mal formada), 401 Unauthorized (no se enviaron credenciales válidas), 403 Forbidden (se deniega el acceso, con o sin credenciales), 404 Not Found (no hay nada en esa ruta), 405 Method Not Allowed, 410 Gone y 429 Too Many Requests. Cada uno se arregla de una forma distinta, así que lea el código exacto antes que nada.

Eso hace que esta clase sea peculiar en la monitorización. Un 4xx en una comprobación suele señalar a la comprobación, no al servicio. Un monitor que recibe un 401 ha perdido sus credenciales. Uno que recibe un 404 apunta a una ruta que se movió. Uno que recibe un 405 usa el método equivocado. Avisar a la guardia por estos casos produce una alerta sobre un ajuste de monitorización, el tipo de alerta que enseña a la gente a ignorar las alertas.

Dos códigos de la clase rompen esa regla y merecen tratarse como fallos reales. Un 429 significa que el servidor está descartando carga a propósito, una señal de capacidad sobre el servicio. Un 408 significa que el servidor se cansó de esperar a que llegara la petición, lo que suele decir más de la red o de la carga del propio servidor que del cliente. Los dos tienen su propia guía.

4xx frente a 5xx se reduce a quién culpa el código de estado. Un 4xx culpa a la petición, un 5xx dice que el servidor falló con una petición que parecía válida, y solo el primer dígito decide la clase (RFC 9110). Por eso 408 Request Timeout, que a menudo se archiva con los errores de servidor porque habla de un timeout, es un 4xx: el servidor agotó el tiempo esperando a que el cliente terminara de enviar. Un timeout mientras se espera a un servidor upstream es, en cambio, el 5xx 504.

Lista de códigos de error 4xx: cada error de cliente registrado y dónde está definido
CódigoNombreDefinido en
400Bad RequestRFC 9110
401UnauthorizedRFC 9110
402Payment Required (reserved)RFC 9110
403ForbiddenRFC 9110
404Not FoundRFC 9110
405Method Not AllowedRFC 9110
406Not AcceptableRFC 9110
407Proxy Authentication RequiredRFC 9110
408Request TimeoutRFC 9110
409ConflictRFC 9110
410GoneRFC 9110
411Length RequiredRFC 9110
412Precondition FailedRFC 9110
413Content Too LargeRFC 9110
414URI Too LongRFC 9110
415Unsupported Media TypeRFC 9110
416Range Not SatisfiableRFC 9110
417Expectation FailedRFC 9110
418(Unused)RFC 9110
421Misdirected RequestRFC 9110
422Unprocessable ContentRFC 9110
423LockedRFC 4918 (WebDAV)
424Failed DependencyRFC 4918 (WebDAV)
425Too EarlyRFC 8470
426Upgrade RequiredRFC 9110
428Precondition RequiredRFC 6585
429Too Many RequestsRFC 6585
431Request Header Fields Too LargeRFC 6585
451Unavailable For Legal ReasonsRFC 7725
499Client Closed Requestnginx, no registrado

Causas habituales

  • La comprobación apunta a una URL que se movió, cambió de nombre o nunca fue correcta.
  • La autenticación que envía la comprobación caducó, se rotó o nunca se configuró.
  • El método, las cabeceras o el cuerpo de la petición no coinciden con lo que espera el endpoint.
  • Un WAF, un filtro de bots o un limitador de tasa rechaza específicamente al monitor, mientras el tráfico real pasa.
  • El endpoint devuelve un 4xx a propósito como parte de su funcionamiento normal, y la comprobación lo trata como un fallo.

Cómo diagnosticarlo

  1. Lea el código exacto, no solo la clase. 401, 403, 404, 405 y 429 se arreglan de formas completamente distintas.
  2. Reproduzca la petición de la comprobación desde otro lugar con curl, incluidos sus encabezados y su método.
  3. Compárela con una petición que haga un cliente real. La diferencia casi siempre es la respuesta.
  4. Busque la petición del monitor en el registro de accesos del servidor y vea qué quedó registrado.
  5. Si la petición funciona desde su máquina y no desde el monitor, sospeche de un filtro por IP o por user-agent.

¿De quién es la culpa? Normalmente, del lado del cliente

Por definición, el fallo está en la petición. En monitorización eso casi siempre significa que hay que arreglar la comprobación y no el servicio. Las dos excepciones que vale la pena investigar del lado del servidor son 429 y 408.

Qué ve la monitorización

Por defecto, una comprobación de Uptimely solo pasa cuando el estado de la respuesta está entre 200 y 399, así que cualquier 4xx la hace fallar. El código exacto se guarda con la comprobación, de modo que el fallo se lee como un 401 o un 404 y no como un error genérico. Si un endpoint responde con un 4xx a propósito, cambie los criterios del monitor para comprobar el código de estado que espera, en lugar de dejar que avise cada noche. Por defecto, solo se declara un incidente tras dos comprobaciones fallidas seguidas. Un 408 no es distinto: se registra como estado 408 y hace fallar la comprobación como cualquier otro estado fuera de ese rango.

Preguntas

¿Cuál es la diferencia entre un error 4xx y uno 5xx?

Un error 4xx significa que el fallo estaba en la petición y el servidor la rechazó, así que el arreglo suele estar en el cliente o en la comprobación. Un error 5xx significa que la petición era válida y el servidor no pudo atenderla, así que el arreglo está en el servidor. La línea la marca la clase, no el síntoma: un 408 Request Timeout es un 4xx porque el servidor esperaba la petición del cliente, mientras que un 504 Gateway Timeout es un 5xx porque un gateway esperaba a un servidor upstream.

¿El 408 es un error de servidor o de cliente?

Un 408 Request Timeout es un error de cliente, un 4xx, no un error 5xx de servidor. La RFC 9110 lo define como que el servidor no recibió una petición completa en el tiempo que estaba dispuesto a esperar, así que el estado culpa a una petición que llegó demasiado despacio. La causa puede seguir estando en el servidor o en la red: un enlace lento, un cliente que sube un cuerpo grande o un servidor con un timeout de lectura corto. Un monitor lo informa como estado 408 y, por defecto, hace fallar la comprobación, porque solo pasan las respuestas de 200 a 399 a menos que cambie los criterios del monitor.

¿Debe un monitor tratar cada 4xx como una caída?

No. Un 4xx suele significar que la comprobación está mal, no el servicio, y avisar por ello enseña al equipo a ignorar las alertas. Las excepciones son 429 y 408, que describen la capacidad del servidor y no la corrección de la petición.

¿Por qué mi monitor recibe un 4xx y mi navegador no?

Casi siempre por una diferencia en la petición. Faltan cookies o cabeceras de autenticación, cambia el user-agent, o un filtro de bots deja pasar a un navegador y bloquea una IP de centro de datos. Reproduzca la petición exacta del monitor con curl para ver cuál de ellas es.

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.