Guia de erros
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.
Um status 5xx significa que o servidor não conseguiu atender uma requisição que parecia válida. A responsabilidade está do lado do servidor: a aplicação, suas dependências ou a infraestrutura na frente dela. Ao contrário de um 4xx, nenhuma mudança que o cliente pudesse fazer o teria evitado.
Esta é a classe para a qual o monitoramento existe, e todo código dela deve fazer uma verificação falhar por padrão. É também a classe mais visível para os clientes, porque um 5xx geralmente significa que uma requisição que deveria ter funcionado não funcionou.
O código específico mostra qual camada falhou, e isso é a maior parte da triagem inicial: 500 é a aplicação lançando uma exceção; 502 e 504 são um proxy informando que algo atrás dele falhou ou foi lento demais; 503 é uma recusa deliberada por capacidade ou manutenção; 501 é um método que o servidor não implementa. Chegar rápido à camada certa vale mais do que qualquer quantidade de palpites sobre as causas.
| Código | Nome | Definido em |
|---|---|---|
| 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 | Não registrado: enviado por alguns provedores de hospedagem quando uma conta esgota sua cota de banda |
| 510 | Not Extended | RFC 2774, hoje obsoleta |
| 511 | Network Authentication Required | RFC 6585 |
| 520 | Web Server Returns an Unknown Error | Cloudflare, não registrado |
| 521 | Web Server Is Down | Cloudflare, não registrado |
| 522 | Connection Timed Out | Cloudflare, não registrado |
| 523 | Origin Is Unreachable | Cloudflare, não registrado |
| 524 | A Timeout Occurred | Cloudflare, não registrado |
| 525 | SSL Handshake Failed | Cloudflare, não registrado |
| 526 | Invalid SSL Certificate | Cloudflare, não registrado |
Causas comuns
- Uma exceção não tratada no código da aplicação.
- Uma dependência (banco de dados, cache, fila, API de terceiros) falhando ou estourando o tempo.
- Esgotamento de recursos: memória, descritores de arquivo, pools de conexão, disco.
- Um deploy que entregou um bug, ou uma mudança de configuração que quebrou uma conexão.
- Um serviço upstream fora do ar, inacessível ou respondendo devagar demais.
Como diagnosticar
- Leia primeiro o código exato: ele identifica a camada, e a camada determina onde procurar.
- Veja se o erro está no log da sua aplicação ou só no do proxy: só isso já divide a busca pela metade.
- Descubra se ele afeta todas as requisições ou só uma parte, o que distingue uma falha total de uma parcial.
- Cruze o horário de início com deploys, mudanças de configuração e incidentes de dependências.
- Verifique a saúde de cada dependência antes de depurar o seu próprio código; a maioria dos incidentes 5xx é a queda de outra pessoa chegando até você.
De quem é a culpa? Do lado do servidor
Por definição, do lado do servidor, embora um 5xx muitas vezes seja causado por uma dependência e não pela própria aplicação, e continua sendo o seu incidente mesmo quando o bug não é seu.
O que o monitoramento vê
Os critérios padrão da Uptimely fazem uma verificação falhar diante de um 5xx e registram o código exato. Um monitor declara um incidente quando o limite de falhas é atingido (duas verificações com falha seguidas, por padrão), então uma falha isolada é registrada como indisponibilidade sem acionar ninguém, enquanto um 5xx persistente abre um incidente e executa a política de plantão.
Guias de erros relacionados
Termos usados nesta página
Perguntas
Todo 5xx deve disparar um alerta?
Todo 5xx deve fazer a verificação falhar. Se ele alerta depende do limite: esperar duas falhas seguidas elimina as falhas isoladas sem deixar de registrá-las como indisponibilidade, o que quase sempre é o padrão certo.
Quais códigos 5xx apontam para um proxy e não para a minha aplicação?
502 e 504 são gerados por algo na frente da sua aplicação: um proxy reverso ou uma CDN informando que o upstream falhou ou foi lento demais. Um 500 vem da própria aplicação.
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.