Gleam.br Wiki

GBR: ADR-0011 Motor de Reconexão com Backoff Exponencial e Jitter | Wiki

Documentação de engenharia e especificações técnicas da Gleam-BR.

GBR: ADR-0011 Motor de Reconexão com Backoff Exponencial e Jitter

  • *Status:* Aceito
  • *Data:* 2026-05-01

*Contexto:*

Uma falha central causa a morte silenciosa dos processos de conexão nos agentes, exigindo reinicialização manual. Sem um mecanismo de retentativa inteligente, uma volta em massa de milhares de agentes simultaneamente causaria um ataque de negação de serviço (Thundering Herd) não intencional contra o Gateway.

*Decisão:*

  1. *Loop de Reconexão Autônomo:* O Ator de conexão do Agente não deve terminar em caso de erro de socket (tcp_closed); ele deve transicionar para um estado de Reconnecting.
  2. *Algoritmo de Backoff:* Utilizar esperas crescentes (5s, 10s, 20s, 40s…) entre as tentativas de gbr_p2p.dial.
  3. *Injeção de Jitter:* Adicionar uma variação aleatória de tempo (ex: +/- 2s) para garantir que os agentes se reconectem em momentos distintos, protegendo a infraestrutura da Nuvem.

*Consequências:*

  • *Positivas:* Autocura do sistema sem intervenção humana; estabilidade da infraestrutura de nuvem sob estresse de rede.
  • *Negativas/Riscos:* Atraso na percepção de "Agente Online" no painel administrativo durante o ciclo de backoff.