Circuit breaker em integrações que caem juntas

Disjuntor aberto interrompendo uma pilha de pedidos, com uma luz de prova ao lado

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.

Fila de cartões parada num disjuntor aberto, com um único cartão de prova passando
Com o circuito aberto, só a prova passa. O resto espera.

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.

EstadoChamada novaProva
FechadoSegue, falha conta para o limiteNão precisa
AbertoNão sai; fila ou recusa rápidaUma chamada pequena, de tempos em tempos
Meio abertoSó a provaSe 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.

Perguntas frequentes

▸Circuit breaker substitui a fila?

Não. Ele impede a chamada inútil. A fila guarda o caso até o destino voltar. Sem fila, abrir o circuito é perder o pedido. Sem breaker, a fila vira um martelo de retry.

▸Qual limite usar no começo?

Um corte conservador medido no comportamento normal: várias falhas transitórias em poucos segundos, não uma. Ajuste quando abrir em pico saudável ou quando demorar demais numa queda óbvia. O número fica versionado.

▸Posso ter um breaker só para o destino inteiro?

Pode, se todas as operações dependem da mesma saúde. Se uma leitura segue no ar e a escrita não, separe. Um breaker único para de ler quando só a escrita caiu, e o turno perde o que ainda funcionava.

▸A prova pode ser o próximo caso real?

Pode se a chave impedir duplicata e se a prova for uma, não a fila. Se falhar, o caso volta para a espera. Prova em massa é reabrir o circuito com outro nome.

▸Como o usuário vê isso?

Com uma recusa rápida e um estado de “aguardando o serviço”, não com a página girando até o timeout. Quem opera vê a fila. Quem pediu não precisa achar que o clique se perdeu.

▸Breaker em API interna também?

Sim, se a queda dela derruba os fluxos que chamam. API interna sem disjuntor espalha timeout do mesmo jeito que fornecedor externo. O critério é o efeito em cascata, não o dono do sistema.