Guia de erros
Erros 4xx de cliente
A classe de respostas que indica que o problema estava na requisição. Para um monitor, um 4xx geralmente significa que a verificação está mal configurada.
Erros 4xx são a classe de códigos de status HTTP de erro do cliente, de 400 a 499. Um 4xx diz que o servidor entendeu a requisição e a recusou porque o problema era a própria requisição: malformada, sem autorização, apontada para algo que não existe ou usando um método que não é permitido. O servidor está funcionando e respondendo. Ele está dizendo que a pergunta estava errada.
Os códigos que você mais vai encontrar são 400 Bad Request (a requisição estava malformada), 401 Unauthorized (nenhuma credencial válida foi enviada), 403 Forbidden (o acesso é recusado, com ou sem credenciais), 404 Not Found (não há nada nesse caminho), 405 Method Not Allowed, 410 Gone e 429 Too Many Requests. Cada um tem uma correção diferente, então leia o código exato antes de qualquer outra coisa.
Isso torna a classe incomum no monitoramento. Um 4xx em uma verificação normalmente aponta para a verificação, não para o serviço. Um monitor que recebe 401 perdeu suas credenciais. Um que recebe 404 aponta para um caminho que mudou. Um que recebe 405 está usando o método errado. Acionar o plantão por isso gera um alerta sobre uma configuração de monitoramento, o tipo de alerta que ensina as pessoas a ignorar alertas.
Dois códigos da classe quebram essa regra e merecem ser tratados como falhas reais. Um 429 significa que o servidor está descartando carga de propósito, um sinal de capacidade sobre o serviço. Um 408 significa que o servidor desistiu de esperar a requisição chegar, o que geralmente diz mais sobre a rede ou a carga do próprio servidor do que sobre o cliente. Os dois têm guias próprios.
4xx versus 5xx se resume a quem o código de status culpa. Um 4xx culpa a requisição, um 5xx diz que o servidor falhou em uma requisição que parecia válida, e só o primeiro dígito decide a classe (RFC 9110). Por isso 408 Request Timeout, que muitas vezes é arquivado junto com os erros de servidor por falar em timeout, é um 4xx: o servidor esgotou o tempo esperando o cliente terminar de enviar. Um timeout enquanto se espera um servidor upstream é, em vez disso, o 5xx 504.
| Código | Nome | Definido em |
|---|---|---|
| 400 | Bad Request | RFC 9110 |
| 401 | Unauthorized | RFC 9110 |
| 402 | Payment Required (reserved) | RFC 9110 |
| 403 | Forbidden | RFC 9110 |
| 404 | Not Found | RFC 9110 |
| 405 | Method Not Allowed | RFC 9110 |
| 406 | Not Acceptable | RFC 9110 |
| 407 | Proxy Authentication Required | RFC 9110 |
| 408 | Request Timeout | RFC 9110 |
| 409 | Conflict | RFC 9110 |
| 410 | Gone | RFC 9110 |
| 411 | Length Required | RFC 9110 |
| 412 | Precondition Failed | RFC 9110 |
| 413 | Content Too Large | RFC 9110 |
| 414 | URI Too Long | RFC 9110 |
| 415 | Unsupported Media Type | RFC 9110 |
| 416 | Range Not Satisfiable | RFC 9110 |
| 417 | Expectation Failed | RFC 9110 |
| 418 | (Unused) | RFC 9110 |
| 421 | Misdirected Request | RFC 9110 |
| 422 | Unprocessable Content | RFC 9110 |
| 423 | Locked | RFC 4918 (WebDAV) |
| 424 | Failed Dependency | RFC 4918 (WebDAV) |
| 425 | Too Early | RFC 8470 |
| 426 | Upgrade Required | RFC 9110 |
| 428 | Precondition Required | RFC 6585 |
| 429 | Too Many Requests | RFC 6585 |
| 431 | Request Header Fields Too Large | RFC 6585 |
| 451 | Unavailable For Legal Reasons | RFC 7725 |
| 499 | Client Closed Request | nginx, não registrado |
Causas comuns
- A verificação aponta para uma URL que mudou de lugar, foi renomeada ou nunca esteve certa.
- A autenticação que a verificação envia expirou, foi rotacionada ou nunca foi configurada.
- O método, os cabeçalhos ou o corpo da requisição não batem com o que o endpoint espera.
- Um WAF, um filtro de bots ou um limitador de taxa está rejeitando especificamente o monitor, enquanto o tráfego real passa.
- O endpoint retorna um 4xx de propósito como parte do funcionamento normal, e a verificação trata isso como falha.
Como diagnosticar
- Leia o código exato, não só a classe. 401, 403, 404, 405 e 429 têm correções completamente diferentes.
- Reproduza a requisição da verificação de outro lugar com curl, incluindo os cabeçalhos e o método.
- Compare com uma requisição feita por um cliente real. A diferença quase sempre é a resposta.
- Procure a requisição do monitor no log de acesso do servidor e veja o que ficou registrado.
- Se a requisição funciona da sua máquina e não do monitor, desconfie de um filtro por IP ou por user-agent.
De quem é a culpa? Normalmente, do lado do cliente
Por definição, o problema está na requisição. No monitoramento, isso quase sempre significa que é a verificação que precisa de correção, e não o serviço. As duas exceções que valem investigação do lado do servidor são 429 e 408.
O que o monitoramento vê
Por padrão, uma verificação da Uptimely só passa quando o status da resposta está entre 200 e 399, então qualquer 4xx a faz falhar. O código exato é registrado com a verificação, de modo que a falha aparece como um 401 ou um 404, e não como um erro genérico. Se um endpoint responde com um 4xx de propósito, mude os critérios do monitor para verificar o código de status que você espera, em vez de deixá-lo alertar toda noite. Por padrão, um incidente só é declarado depois de duas verificações com falha seguidas. Um 408 não é diferente: ele é registrado como status 408 e faz a verificação falhar como qualquer outro status fora desse intervalo.
Guias de erros relacionados
Termos usados nesta página
Perguntas
Qual é a diferença entre um erro 4xx e um erro 5xx?
Um erro 4xx significa que o problema estava na requisição e o servidor a recusou, então a correção geralmente está no cliente ou na verificação. Um erro 5xx significa que a requisição era válida e o servidor não conseguiu atendê-la, então a correção está no servidor. Quem traça a linha é a classe, não o sintoma: um 408 Request Timeout é um 4xx porque o servidor esperava a requisição do cliente, enquanto um 504 Gateway Timeout é um 5xx porque um gateway esperava um servidor upstream.
O 408 é um erro de servidor ou de cliente?
Um 408 Request Timeout é um erro de cliente, um 4xx, e não um erro 5xx de servidor. A RFC 9110 o define como o servidor não receber uma requisição completa dentro do tempo que estava disposto a esperar, então o status culpa a requisição que chegou devagar demais. A causa ainda pode estar no servidor ou na rede: um link lento, um cliente enviando um corpo grande ou um servidor com timeout de leitura curto. Um monitor o informa como status 408 e, por padrão, faz a verificação falhar, porque só passam as respostas de 200 a 399, a menos que você mude os critérios do monitor.
Um monitor deve tratar todo 4xx como indisponibilidade?
Não. Um 4xx geralmente significa que a verificação está errada, não o serviço, e acionar alertas por isso ensina a equipe a ignorar alertas. As exceções são 429 e 408, que descrevem a capacidade do servidor e não a correção da requisição.
Por que meu monitor recebe um 4xx e meu navegador não?
Quase sempre por uma diferença na requisição. Cookies ou cabeçalhos de autenticação ausentes, um user-agent diferente ou um filtro de bots que deixa um navegador passar e bloqueia um IP de data center. Reproduza a requisição exata do monitor com curl para ver qual é.
Um dos guias de erros HTTP e de rede da Uptimely, escritos para quem opera o servidor, e não para quem recarrega a página. Something here read wrong to you? Email support@getuptimely.com.
Verificado em pela equipe do Uptimely.