Guias de erros

Erros HTTP e de rede, do lado do servidor

A maioria das páginas sobre “502 Bad Gateway” manda o leitor limpar o cache e tentar de novo mais tarde, um conselho inútil para a única pessoa que pode de fato resolver. Estes guias foram escritos para quem opera o servidor: o que o código diz sobre a sua stack, as causas que vale verificar em ordem, como saber de que lado está o problema e o que uma verificação de uptime vai ver e o que não vai.

Para o vocabulário em vez dos códigos, o glossário de monitoramento define os termos que estes guias usam. Para falhas de TLS e de certificado como 525 e 526, o monitoramento de certificados SSL mostra o que um monitor de certificado da Uptimely lê e quais regras alertam sobre ele. Para os erros legíveis por máquina que a própria API da Uptimely retorna, veja a documentação da API.

Erros de cliente (4xx)

A culpa foi da requisição. Numa verificação de monitoramento, isso quase sempre significa que é a verificação que precisa de conserto, e não o serviço, com duas exceções.

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.

400 Bad Request

O servidor não conseguiu interpretar ou não quis aceitar a requisição como foi enviada: ela estava malformada antes de qualquer lógica rodar.

401 Unauthorized

A requisição precisa de autenticação e não enviou credenciais válidas: o servidor não sabe quem você é.

403 Forbidden

O servidor entendeu a requisição e se recusa a atendê-la: autenticar não vai mudar a resposta.

404 Not Found

O servidor não tem nada nesse caminho, e não vai dizer se nunca teve ou se não tem mais.

405 Method Not Allowed

Um erro 405 Method Not Allowed significa que a URL existe, mas não aceita o método HTTP usado, normalmente um GET enviado a um endpoint feito para POST.

408 Request Timeout

O servidor desistiu de esperar que o cliente terminasse de enviar a requisição.

410 Gone

O recurso existiu e foi removido de forma permanente: uma versão deliberada e definitiva do 404.

429 Too Many Requests

O cliente atingiu um limite de taxa: o servidor está descartando as requisições dele de propósito para se proteger.

499 Client Closed Request

O código próprio do Nginx para um cliente que desligou antes de a resposta ficar pronta: um sintoma de lentidão, não uma causa.

Erros de servidor (5xx)

A falha é do seu lado. O código específico identifica a camada, e isso é a maior parte da triagem.

Erros 5xx de servidor

A classe que significa que o servidor não conseguiu atender uma requisição que, até onde ele podia dizer, era válida.

500 Internal Server Error

A aplicação sofreu uma falha não tratada: a resposta genérica quando nada mais específico se aplica.

501 Not Implemented

O servidor não oferece de forma alguma a funcionalidade necessária para atender a requisição.

502 Bad Gateway

Um proxy pediu uma resposta à sua aplicação e recebeu algo que não conseguia usar, ou nada.

503 Service Unavailable

O servidor está se recusando de propósito a atender agora: sobrecarregado, em manutenção ou sem nada saudável para onde rotear.

504 Gateway Timeout

Um proxy esperou pela sua aplicação e desistiu: o upstream estava acessível, só lento demais.

508 Loop Detected

O servidor abortou uma requisição porque ela estava andando em círculos: normalmente um loop de redirecionamento ou de reescrita.

Erros de origem da Cloudflare (52x)

Códigos próprios da Cloudflare, não padrões HTTP. Cada um diz algo específico sobre o trecho entre a borda e a sua origem.

Falhas de rede e de TLS

Falhas sem nenhum código de status, porque a requisição nunca foi longe o bastante para existir uma resposta. É o que um monitor informa quando nada respondeu.

Certificado SSL vencido

O período de validade do certificado terminou, então todos os clientes recusam a conexão.

SSL/TLS handshake failed

Um “SSL handshake failed” ou uma falha no handshake TLS significa que a conexão TCP deu certo e que a negociação TLS por cima dela não deu.

A code you were looking for and did not find? Email support@getuptimely.com. Para saber quando um destes começar a acontecer no seu próprio serviço: Uptimely checks every minute on the free plan.

Verificado em pela equipe do Uptimely.