Guia de erros
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.
Um 429 significa que o cliente enviou requisições demais e que o servidor está recusando as próximas por enquanto. Não é uma falha no sentido usual: o servidor está saudável e está se protegendo de propósito ou aplicando uma cota. Um 429 bem implementado inclui um cabeçalho Retry-After dizendo quanto tempo esperar.
É o código mais interessante para a operação na classe 4xx, porque é o único que diz algo confiável sobre capacidade, e não sobre correção. Uma taxa de 429 em alta com o comportamento dos clientes inalterado significa que o crescimento está batendo nos limites, que os limites foram apertados ou que algo está repetindo tentativas com muito mais agressividade do que antes.
No monitoramento ele tem uma armadilha particular: um monitor que verifica com frequência pode atingir um limite de taxa sozinho, principalmente quando vários monitores compartilham um IP de saída com outro tráfego. O alerta então descreve o monitoramento, não o serviço.
Causas comuns
- Tráfego real excedendo um limite de taxa ou uma cota configurados.
- Um loop de novas tentativas sem backoff transformando uma falha passageira em uma falha sustentada.
- Verificações de monitoramento em intervalo curto contando contra o mesmo limite que o tráfego real.
- Limitação de taxa aplicada por IP onde muitos clientes compartilham um endereço, então um vizinho barulhento esgota a cota de todos.
- Uma cota de API, diária ou mensal em vez de por segundo, que se esgotou no período.
- Um WAF ou produto de borda limitando requisições que ele classifica como automatizadas.
Como diagnosticar
- Leia o Retry-After e quaisquer cabeçalhos X-RateLimit: eles costumam informar o limite, a cota restante e o horário de reinício.
- Descubra qual camada está limitando (a CDN, um gateway de API ou a aplicação), porque cada uma tem a própria configuração.
- Verifique se o limite é por IP, por chave ou por conta, o que determina quem está de fato competindo por ele.
- Procure uma tempestade de novas tentativas: um cliente sem backoff transforma uma resposta lenta em centenas de requisições.
- Se o monitoramento estiver envolvido, aumente o intervalo de verificação ou coloque o monitor numa lista de permissões em vez de remover o limite.
De quem é a culpa? Depende da camada
O servidor está funcionando como projetado, então formalmente a culpa é do cliente por exceder o limite. Mas um 429 que chega a usuários reais é um problema de capacidade ou de configuração que vale tratar como um incidente do lado do servidor.
O que o monitoramento vê
A Uptimely registra o código de status, então um 429 aparece como o que é, e não como uma falha anônima. Se as próprias verificações estão disparando o limite, a solução é um intervalo maior ou uma lista de permissões na borda: um monitor cujos alertas são causados pelo próprio monitor é a fonte mais clara possível de fadiga de alertas.
Guias de erros relacionados
Termos usados nesta página
Perguntas
Um 429 é tempo de inatividade?
Para o cliente que o recebe, na prática sim: a requisição não teve sucesso. Para o serviço, está funcionando como projetado. Se ele deve aparecer na sua página de status depende de quem está atingindo o limite: usuários reais ou apenas clientes automatizados.
Meu monitor de uptime pode causar erros 429?
Sim, principalmente em intervalos curtos ou quando vários monitores compartilham um IP de saída com outro tráfego. Aumente o intervalo ou coloque o monitor numa lista de permissões na borda; não remova o limite de taxa para fazer uma verificação passar.
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.