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.

Lista de códigos de erro 4xx: todo erro de cliente registrado e onde ele é definido
CódigoNomeDefinido em
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, 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

  1. Leia o código exato, não só a classe. 401, 403, 404, 405 e 429 têm correções completamente diferentes.
  2. Reproduza a requisição da verificação de outro lugar com curl, incluindo os cabeçalhos e o método.
  3. Compare com uma requisição feita por um cliente real. A diferença quase sempre é a resposta.
  4. Procure a requisição do monitor no log de acesso do servidor e veja o que ficou registrado.
  5. 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.

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.