Fila de automação: falha visível, replay sem duplicar

Fila noturna de envelopes, uma caixa de itens que falharam e um alarme

Fila de automação sem dono esconde a falha até o expediente acabar. O caso fica numa fila técnica, o sistema de origem acha que enviou, e o efeito não acontece. Dead letter, alerta e replay fazem o item voltar sem criar o efeito duas vezes.

Fila não é detalhe de infraestrutura. É o lugar onde a operação vê o que não passou, quem responde e até quando. Sem esses três, o desenho só funciona no dia em que nada quebra.

Envelope que falhou saindo da caixa lateral e voltando ao início da fila
O item que não passou fica visível e volta sem repetir o efeito.

O que a fila guarda além da mensagem?

Guarda o identificador de negócio, a tentativa, o último erro, a hora de entrada e o estado: aguardando, em execução, falhou, esgotou. Uma fila que só mostra “mensagem disponível” não diz se o pedido está parado há dez minutos ou há dois dias.

O payload fica no tamanho necessário para reprocessar, com cuidado para não arquivar dado pessoal a mais só porque a mensagem original veio cheia. O que a tentativa precisa para refazer o passo permanece. O restante fica no sistema de origem, apontado pela chave.

Quantas tentativas, e o que muda entre elas?

Erro transitório, como timeout e indisponibilidade, tenta de novo com espera crescente. Erro de negócio, como cadastro inválido ou saldo insuficiente, não tenta de novo: vai para a exceção. Misturar os dois faz o sistema martelar um erro que só uma pessoa corrige, ou desistir de uma queda de rede.

O número de tentativas é curto e escrito. Depois dele, o item sai da fila principal e entra na dead letter. Continuar tentando para sempre ocupa o trabalhador e empurra o caso novo para trás. A fila principal é para o que ainda tem chance automática.

ErroTentativa automáticaDestino
Timeout ou sistema foraSim, com espera crescenteDe volta à fila, até o limite
Cadastro ou dado inválidoNãoExceção, com o campo que falta
Efeito incerto depois de uma quedaConsulta antes de repetirDead letter se a consulta não fechar
Limite de tentativas estourouNãoDead letter e alerta

Para que serve a dead letter?

A dead letter é a fila que uma pessoa olha. O item chega com o motivo, a última tentativa e a chave de negócio. Não é um balde técnico esquecido no servidor. Tem dono, horário de leitura e um prazo a partir do qual o atraso vira incidente.

Esvaziar a dead letter “reprocessando tudo” sem ler o motivo repete a falha e pode duplicar o que já tinha sido feito. O replay é individual, depois de corrigir a causa ou de confirmar que a causa era transitória e já passou.

Como o alerta chega em quem age?

O alerta diz qual fila, quantos itens, qual o mais antigo e qual erro se repete. Um gráfico de CPU não chama o analista da operação. O destinatário é o dono do processo, com um substituto. Alerta para um canal que ninguém lê é o mesmo que silêncio.

Separe atraso de pico. Pico de entrada com a fila andando pode ser volume. Item mais antigo passando do prazo é falha, mesmo que o volume seja baixo. A métrica que dispara é a idade do item mais velho, não só a quantidade.

Como fazer replay sem duplicar o efeito?

O replay usa a mesma chave de negócio da tentativa original. Se o efeito externo já aconteceu e o registro local falhou, a nova tentativa consulta o externo e completa o registro. Se nada aconteceu, executa. Se já está completo, devolve o estado e tira o item da dead letter.

Replay em massa só existe para um erro que já foi corrigido e classificado, com a chave respeitada item a item. Um botão de “reprocessar a fila” sem essa checagem é a forma mais rápida de cobrar ou criar pedido duas vezes depois de uma instabilidade.

Quem olha a fila no dia seguinte?

O ritual cabe em poucos minutos: idade do item mais velho, erros repetidos, o que foi para dead letter desde ontem e o que ainda espera pessoa. Isso é pauta de operação, não uma revisão trimestral de arquitetura.

Um exemplo: a fila envia pedido pago para o faturamento. Uma nota falha porque o cadastro do município está vazio. Isso é erro de negócio, não retry. O item aparece para o financeiro com o pedido e o campo. Quando o cadastro é corrigido, o replay daquele pedido segue, e a chave impede uma segunda nota. Os timeouts da noite, esses sim, foram reentregues sozinhos.

Checklist prático

A fila está operável quando a falha tem nome, dono e um jeito de voltar sem repetir o efeito.

  • Estado visível: aguardando, executando, falhou, esgotou
  • Chave de negócio em cada item, separada do ID da tentativa
  • Erro transitório e erro de negócio com destinos diferentes
  • Limite curto de tentativas e espera crescente
  • Dead letter com dono, motivo e idade do item
  • Alerta pela idade do mais antigo, para quem age
  • Replay que consulta o efeito antes de repetir
  • Ritual de leitura da fila, não só painel de infraestrutura

Erros comuns

A falha silenciosa e a duplicata no replay nascem destas escolhas.

  • Retry infinito de erro de cadastro, segurando a fila inteira
  • Desistir na primeira queda de rede
  • Dead letter sem dono, olhada só quando o cliente cobra
  • Alertar volume e ignorar a idade do item mais velho
  • Reprocessar tudo depois de uma falha, sem checar o que já tinha sido feito
  • Guardar o payload completo com dado pessoal que o replay não usa
  • Medir a fila pela CPU do trabalhador, não pelo atraso do pedido
  • Botão de replay em massa sem a chave de negócio

Onde a fila entra no processo?

Em automações de processos, a fila é parte visível da operação. O caso que não passou tem dono, prazo e replay seguro.

Perguntas frequentes

▸Toda automação precisa de fila?

Precisa quando o passo pode falhar fora do turno de quem originou o caso, ou quando o volume não cabe numa chamada síncrona. Um fluxo pequeno e supervisionado pode viver sem fila. No dia em que a falha passa a ser descoberta pelo cliente, a fila deixou de ser opcional.

▸Qual a diferença entre retry e dead letter?

Retry é a tentativa automática de um erro transitório, com limite. Dead letter é o destino quando o limite acaba ou quando o erro é de negócio. A primeira a operação não precisa ver, se funcionar. A segunda alguém precisa abrir.

▸Posso reprocessar a dead letter inteira de manhã?

Só se a causa já foi corrigida e cada item respeita a chave, consultando o efeito antes de repetir. Reprocessar em massa um erro de cadastro só recoloca os mesmos itens. Reprocessar um pagamento incerto pode cobrar de novo.

▸Que alerta vale a pena?

A idade do item mais antigo acima do prazo, e um erro que se repete. Quantidade sozinha não separa pico saudável de item parado. O destinatário é o dono do processo, com substituto, num canal que o turno realmente lê.

▸A fila guarda o dado pessoal do payload?

Guarda o mínimo para reprocessar e a chave para buscar o resto na origem. Copiar o cadastro inteiro para a mensagem aumenta o risco sem ajudar o replay. O prazo de retenção da fila segue a necessidade do processo, não o default do produto.

▸Como saber se o replay duplicou?

Pelo efeito de negócio: duas notas, dois pedidos, duas cobranças para a mesma chave. O log de “mensagem reprocessada” não responde. A checagem do efeito externo antes de repetir existe para esse número permanecer em um.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *