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

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.

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.
| Erro | Tentativa automática | Destino |
|---|---|---|
| Timeout ou sistema fora | Sim, com espera crescente | De volta à fila, até o limite |
| Cadastro ou dado inválido | Não | Exceção, com o campo que falta |
| Efeito incerto depois de uma queda | Consulta antes de repetir | Dead letter se a consulta não fechar |
| Limite de tentativas estourou | Não | Dead 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.