You can use event tracking to view the details and traces of events published in EventBridge. When an event target does not receive an expected event, or receives an incorrect one, event tracking helps you determine where the delivery pipeline failed. Trace each event to pinpoint the exact failure point.
You can use event tracking to perform various operations. For example, you can identify the operations that EventBridge performs on events at different points in time, check whether event publishing is delayed, and find the cloud service to which an event belongs.
Event tracking was previously named event query. The feature itself has not changed.
How event tracking works
EventBridge processes every event through three sequential stages. Event tracking records the outcome at each stage.
Stage | What EventBridge records | Troubleshooting value |
Receive | Timestamp, event source, and event type | Confirms whether EventBridge received the event and identifies the originating cloud service |
Filter | Whether the event matched an event rule | Reveals mismatches between the event and your rule configuration |
Deliver | Timestamp and delivery status | Shows whether the event reached the target and whether delivery was delayed |
Query modes
Choose a query mode based on your event bus type.
Query mode | Event bus type | What it returns |
Query by Event ID | Custom event bus (events from your applications) | Trace and details for a single event, identified by its event ID in event targets |
Query by Time Range | System event bus (events from Alibaba Cloud services) | Multiple events within a time window, with the trace and details for each event |
Event traces
An event trace is a timeline of every operation EventBridge performed on the event, from ingestion through filtering to delivery. Use traces to identify the exact stage where an issue occurred.
Each trace records three types of operations:
Operation | Information recorded |
Receive events | Timestamp when EventBridge received the event, event source, event type |
Filter events | Rule-based filtering result |
Deliver events | Timestamp when EventBridge delivered the event to event targets, delivery status |
Event details
Event details provide the full set of event parameters, including the source, type, and other attributes. Use event details to verify that the event content matches your expectations.
For a description of each event parameter, see Event overview.
What to do next
Query events by event ID -- Trace a specific event on a custom event bus.
Query events by time range -- Find events on the system event bus within a time window.