English for Amazon EventBridge

An event that should have triggered a downstream action but silently didn’t is one of the hardest bugs to explain without the right vocabulary — was it never published, did the rule not match, or did the target fail — and this guide gives you the words to name exactly which stage broke.

Key Vocabulary

Event bus — the central pipeline events are published to in EventBridge, with a default bus for AWS service events and custom buses for application-specific events, isolating traffic by concern. “We publish order events to a custom event bus separate from the default one — that keeps our application events from getting mixed in with the flood of AWS service-generated events.”

Rule — a pattern-matching filter that selects which events on a bus trigger which targets, defined by matching against fields like the event source, type, or detail payload. “The notification never fired because the rule’s pattern only matches order.completed events — this was an order.refunded event, so it correctly didn’t match and nothing was broken.”

Target — the destination a matched event is delivered to, such as a Lambda function, an SQS queue, or a Step Functions workflow, with a rule able to fan out to multiple targets from a single matched event. “That rule has three targets — a Lambda for sending the email, an SQS queue for the analytics pipeline, and a Step Functions workflow for fulfillment — so one event triggers all three independently.”

Event pattern — the JSON structure defining what a rule matches against, checked field-by-field against incoming events, where an unintentionally narrow or malformed pattern is a common cause of “missing” events that were actually never matched. “The event pattern was checking detail.status as a string, but the actual field was nested one level deeper — the rule silently matched nothing for weeks because the pattern just never matched.”

Dead-letter queue (DLQ) — a queue configured to capture events that failed delivery to their target after retries are exhausted, used to catch and later reprocess events that would otherwise be silently dropped. “Those failed Lambda invocations weren’t lost — they landed in the dead-letter queue after retries ran out, so we can reprocess them once we’ve fixed the underlying bug in the handler.”

Common Phrases

• “Was the event actually published to the bus, or did it never leave the source?”
• “Did the rule’s pattern actually match, or is that why nothing happened?”
• “Which target failed — was it the Lambda, or something downstream of it?”
• “Is there a dead-letter queue configured, or are failed events just gone?”
• “Is this event on the default bus or a custom one?”

Example Sentences

Diagnosing a missing downstream action: “Nothing’s actually broken end-to-end — the event pattern on that rule was checking a field one level too shallow in the nested detail object, so it’s been silently not matching any events since it was deployed.”

Explaining a fan-out design: “One event on the order bus triggers three separate targets — a Lambda for the confirmation email, an SQS queue that feeds our analytics pipeline, and a Step Functions workflow for fulfillment. Each one processes independently, so a failure in one doesn’t block the others.”

Describing a failure-recovery setup: “We added a dead-letter queue to that rule’s target after last month’s incident — before, any event that failed all its retries against the Lambda was just gone. Now it lands in the DLQ and we can replay it after fixing the handler.”

Professional Tips

• Say event pattern, not “the rule,” when debugging a matching issue specifically — the rule is the container, the pattern is the actual logic that can be subtly wrong.
• Verify events reach the event bus at all before assuming a rule or target is broken — a missing event and a non-matching rule look identical from the consumer’s side.
• Name the specific target that failed rather than saying “the integration broke” — a rule can fan out to multiple targets, and only one may actually be failing.
• Always configure a dead-letter queue for any target where losing an event silently is unacceptable — without one, failed deliveries after retry exhaustion are gone with no trace.

Practice Exercise

1. Write a sentence explaining the difference between an event bus and a rule.
2. Explain why an overly narrow event pattern can cause events to silently not trigger anything.
3. Describe what a dead-letter queue is for and why it matters.