Conceito e mecanismo
Uma integração orientada a eventos precisa de distinguir entrega e processamento de negócio. EventBridge aplica retries a falhas elegíveis, com limites de tempo e quantidade. A política predefinida permite até 24 horas e 185 tentativas; não é uma promessa de execução funcional ilimitada.
Certos erros, como falta de permissão, podem seguir diretamente para uma DLQ sem retries. Lê os metadados de erro antes de assumir que o contador está errado. Para DLQs de regras, usa SQS standard na mesma Região e configura a política que permite entrega.
Uma fila criada por API não garante que essa autorização esteja correta. Observa também falhas de envio para a própria DLQ.
Aplicação guiada
Depois de corrigir a integração, o trabalho acumulado continua a precisar de recuperação. Identifica efeitos já aplicados, inclusive por um procedimento alternativo, e usa identificadores idempotentes e reconciliação. Repete um lote delimitado, observa resultados e amplia apenas quando há evidência.
Uma DLQ conserva mensagens; não elimina duplicados nem repete automaticamente todo o negócio. Durante investigação, constrói uma linha temporal com alterações, tráfego, métricas e traces. Latência após uma release é uma hipótese, não prova isolada de causa.
A remediação automática deve ter condições de paragem: se restarts repetidos agravam impacto, contém a execução e escala com evidência.
Definir a ocorrência de negócio
Um processamento fictício deve tratar um lote por dia de negócio. Antes de escrever cron, define fuso, identidade do lote, prazo, dependências e tratamento de uma ocorrência ausente. EventBridge Scheduler tem precisão de sessenta segundos para invocação; isso não garante conclusão do trabalho nesse minuto.
Uma janela flexível permite dispersar chamadas dentro do intervalo escolhido e pode ser inadequada quando outro processo espera resultado pouco depois da hora nominal. Orquestra dependências a partir do resultado observado ou de um contrato explícito de disponibilidade.
Regista separadamente hora planeada, tentativa de invocação, início efetivo e conclusão funcional. Esses instantes ajudam a distinguir atraso de agendamento, execução lenta e falha do consumidor.
Ensaiar mudanças de hora e ciclo de vida
Uma agenda cron num fuso local pode apontar para uma hora inexistente no avanço do relógio. Nessa data, a ocorrência é omitida. No recuo, a hora repetida não cria duas ocorrências cron; este comportamento de calendário não garante efeitos de negócio exatamente uma vez.
Já rate com unidade days representa uma duração de vinte e quatro horas, que não é sempre o intervalo entre a mesma hora local em dias consecutivos. Escolhe a semântica que corresponde ao requisito. Para agendas at, StartDate e EndDate não substituem a expressão pontual nem a desativação explícita.
Agendas pontuais que permanecem existentes continuam a contar para quota após execução, pelo que o ciclo de vida precisa de limpeza e evidência separada.
Separar falha de entrega e recuperação do lote
Configura uma política de tentativas e uma DLQ apropriadas ao destino e ao prazo. A DLQ do Scheduler usa SQS standard e exige autorização de envio na execution role; permissões de leitura do consumidor não resolvem esse caminho. O conteúdo de falha ajuda a diagnosticar a invocação, mas não prova por si só o resultado final da operação de negócio.
No caso da mudança de hora, uma ocorrência omitida pelo calendário exige identificação e recuperação do lote, sem assumir um evento de falha de invocação correspondente. Antes de repetir, verifica efeitos já aplicados, identidade estável e reconciliação.
A recuperação deve conseguir explicar quais instruções foram processadas, quais continuam pendentes e quem valida o fecho.
Tornar aprovação executável
Num runbook Automation, a lista de approvers define quem pode decidir, enquanto MinRequiredApprovals define quantas aprovações são necessárias. Omitir esse parâmetro usa um mínimo de um, mesmo que a lista contenha vários nomes. Relaciona timeout e tratamento de falha com a janela de mudança: o timeout predefinido de sete dias não prolonga uma autorização interna de duas horas.
Revalida identidade, âmbito e validade antes de aplicar a ação. A ação aws:approve não suporta o modo multi-account and Region de Automation; se o desenho distribui alterações, coloca a decisão numa fronteira de orquestração suportada. Mensagens de aprovação devem apresentar o efeito e o recurso de forma inequívoca para permitir uma decisão informada.
Observar estado e limitar scripts
Depois de iniciar uma mudança assíncrona, uma espera fixa não demonstra conclusão. Usa uma ação de espera por propriedade quando o próximo passo precisa de um estado observado, com timeout e caminho de falha explícitos. O JSONPath deve selecionar a propriedade do recurso certo; uma lista convertida em texto ou qualquer HTTP 200 não prova igualdade com o valor desejado.
Quando código personalizado é necessário, considera os limites de aws:executeScript: cada ação dura no máximo dez minutos e não fornece retry automático de throttling. O código ou cliente deve tratar repetição de forma limitada, sem esconder falhas ou duplicar efeitos.
Para trabalho longo, separa arranque, observação e validação numa orquestração adequada à duração. Se o script chamar APIs AWS ou enviar output para CloudWatch Logs, configura a service role exigida, com confiança e permissões adequadas. A identidade que inicia o runbook não substitui esse requisito.
Exercício: autorizar uma ocorrência identificada
O modelo local recebe um identificador de lote, um conjunto de decisões de principals, o quórum interno e a validade temporal. Não implementa Scheduler nem aws:approve. Distingue uma ocorrência já concluída, aprovação insuficiente e autorização expirada, antes de preparar trabalho.
A persistência real precisa de proteção contra concorrência; consultar um conjunto em memória não torna a ação seguinte atómica. Executa os casos e acrescenta um cenário de duas workers que tentam o mesmo lote. Descreve a reserva ou escrita condicional necessária e a forma de reconciliar um efeito aplicado sem confirmação.
Fecha o exercício com uma mensagem de passagem de turno que identifique o lote, a decisão, a evidência e o próximo responsável.
# Original local policy exercise; not Scheduler, aws:approve, or an atomic deduplication store.
def plan_occurrence(batch_id, completed, decisions, allowed, quorum, now, expires):
if not batch_id or quorum < 1 or quorum > len(allowed):
raise ValueError("invalid occurrence or quorum")
if batch_id in completed:
return "already completed: reconcile evidence"
if now >= expires:
return "hold: authorization expired"
approved = {principal for principal, decision in decisions.items()
if principal in allowed and decision == "approve"}
if len(approved) < quorum:
return "hold: insufficient approval"
return "prepare: reserve identity atomically and revalidate before effect"
allowed = {"operator-a", "operator-b", "operator-c"}
approvals = {"operator-a": "approve", "operator-b": "approve"}
assert plan_occurrence("batch-7", set(), approvals, allowed, 2, 10, 20).startswith("prepare")
assert plan_occurrence("batch-7", {"batch-7"}, approvals, allowed, 2, 10, 20).startswith("already completed")
assert plan_occurrence("batch-7", set(), approvals, allowed, 2, 20, 20) == "hold: authorization expired"
assert plan_occurrence("batch-7", set(), {"operator-a": "approve", "outsider": "approve"}, allowed, 2, 10, 20) == "hold: insufficient approval"
# An approval count alone is an internal exercise policy, not all AWS rejection semantics.
Corrigir uma permissão resolve o caminho de entrega. Os movimentos retidos precisam de comparação com o que já foi tratado manualmente.
Armadilhas comuns
Retry como garantia; DLQ como exatamente uma vez; correção técnica como fecho; correlação como causa raiz.
Tópicos relacionados: Segurança e evidência operacional · Pipeline, artefactos e identidade
Fecha o incidente quando o serviço e o trabalho pendente estão reconciliados.
Referências
- EventBridge DLQ · AWS documentation consulted 2026-09-29
- DOP-C02 incident and event response objectives · AWS documentation consulted 2026-10-05
- Scheduler schedule types · AWS documentation consulted 2026-10-05
- Scheduler flexible time windows · AWS documentation consulted 2026-10-05
- Scheduler dead-letter queues · AWS documentation consulted 2026-10-05
- Automation approval action · AWS documentation consulted 2026-10-05
- Automation resource-property wait · AWS documentation consulted 2026-10-05
- Automation resource-property assertion · AWS documentation consulted 2026-10-05
- Automation script action · AWS documentation consulted 2026-10-05