Circuit breaker em integrações que caem juntas

Circuit breaker é o disjuntor da integração. Quando o destino passa de um limite de falha, o circuito abre e as chamadas novas não saem. Elas esperam ou caem na fila de exceção. Uma prova pequena testa se o destino voltou, e só então o circuito fecha.
Retry sem disjuntor, em cima de um sistema caído, multiplica a carga justamente na hora pior. A fila cresce, o timeout estoura em cascata e o que ainda respondia também cai. O breaker existe para a falha ficar contida.

Quando o circuito deve abrir?
Abre por falha que indica destino doente: timeout, indisponibilidade, erro de sobrecarga, numa janela curta e com um mínimo de chamadas. Uma falha isolada não abre. Um erro de cadastro, que é de negócio, também não: esse caso vai para a exceção, sem contar como “o sistema caiu”.
O limite é número: tantas falhas em tantos segundos, ou uma taxa acima de um corte. “Está ruim” não opera. O limite se calibra com o comportamento normal, para o horário de pico não abrir o circuito à toa.
O que acontece com a chamada enquanto está aberto?
Ela não atravessa. Ou entra numa fila com prazo, ou devolve uma recusa rápida para quem chamou decidir. Esperar o timeout cheio, com o circuito aberto, só prende trabalhador. A falha rápida é o ponto.
O caso de negócio não se perde. Pagamento, pedido e cadastro continuam com chave, para quando o circuito fechar a tentativa não duplicar o efeito. Abrir o disjuntor sem fila e sem chave transforma proteção em perda muda.
| Estado | Chamada nova | Prova |
|---|---|---|
| Fechado | Segue, falha conta para o limite | Não precisa |
| Aberto | Não sai; fila ou recusa rápida | Uma chamada pequena, de tempos em tempos |
| Meio aberto | Só a prova | Se passar, fecha; se falhar, abre de novo |
Como a prova não vira outro martelo?
A prova é pouca e espaçada. Uma chamada de saúde, ou um caso real pequeno, não a fila inteira. Se a prova falha, o circuito continua aberto e o intervalo até a próxima prova aumenta. Prova a cada segundo é retry com outro nome.
A prova também respeita a chave. Se ela usa um caso real, a segunda prova não pode criar o efeito de novo. Melhor uma chamada de leitura, quando o destino oferece, do que repetir a operação que cobra ou cria.
Quem é avisado, e o que o turno faz?
O alerta diz qual integração abriu, desde quando e quantos casos estão esperando. O dono do fluxo decide se espera, se aciona o destino ou se segue um caminho manual. Circuito aberto sem leitor é uma fila invisível.
Fechar na mão, porque “já deve ter voltado”, sem a prova passar, recoloca a sobrecarga. A volta é automática quando a prova fecha, ou explícita com alguém nomeado. As duas ficam registradas.
Como não abrir por erro de negócio?
Cadastro inválido, saldo insuficiente e permissão negada são respostas saudáveis de um sistema no ar. Contá-las como falha abre o circuito num dia normal e para o fluxo que deveria seguir para a exceção humana.
A lista do que conta é curta e escrita: timeout, conexão recusada, HTTP de indisponibilidade. O resto não empurra o disjuntor. Essa separação é a mesma do retry: o que é transitório tenta de novo; o que é regra de negócio não.
Um exemplo de nota que parou de autorizar
O serviço de nota começa a dar timeout. Depois de algumas falhas na janela, o circuito abre. Os pedidos pagos ficam na fila de faturamento, sem cada um esperar trinta segundos de timeout. Uma prova de leitura a cada minuto testa o serviço. Quando ela passa, o circuito fecha e a fila anda, com a chave da nota para não emitir duas.
Sem o breaker, cada pedido teria martelado o serviço caído e a fila de pedidos saudáveis também atrasaria, presa nos timeouts. O disjuntor separa “o destino caiu” de “este pedido tem um problema”.
Checklist prático
O circuito está desenhado quando a falha do destino para de se multiplicar.
- Limite numérico de falhas transitórias numa janela curta
- Erro de negócio fora da conta do disjuntor
- Chamada recusada rápido enquanto está aberto
- Caso guardado em fila, com chave, sem perder o efeito
- Prova espaçada, de preferência de leitura
- Intervalo da prova que aumenta se ela falhar
- Alerta com integração, duração e tamanho da espera
- Volta pela prova, ou por alguém nomeado com registro
Erros comuns
O disjuntor que não protege em geral conta a falha errada ou continua chamando.
- Retry agressivo sem limite enquanto o destino está fora
- Contar erro de cadastro como queda do sistema
- Abrir com uma única falha isolada
- Deixar a chamada esperar o timeout cheio com o circuito aberto
- Descartar o caso em vez de enfileirar com chave
- Prova a cada segundo, recriando a sobrecarga
- Fechar na mão sem a prova e sem registro
- Não avisar quem opera, só logar a abertura
Onde o disjuntor entra no processo?
Em automações de processos, circuit breaker é o freio da integração instável. A fila segura o caso. A prova decide a volta.