Monitoring Amazon EventBridge
EventBridge sends metrics to Amazon CloudWatch every minute for everything from the number of matched events to the number of times a target is invoked by a rule.
The following video reviews monitoring and auditing EventBridge behavior through CloudWatch:
Topics
EventBridge metrics
The AWS/Events
namespace includes the following metrics.
For the metrics that use Count as a unit, Sum and SampleCount tend to be the most useful statistics.
Metrics that specify only the RuleName
dimension refer to the default event bus.
Metrics that specify both the EventBusName
and RuleName
dimensions refer to a custom event bus.
Metric | Description | Dimensions | Units |
---|---|---|---|
DeadLetterInvocations
|
The number of times a rule’s target isn't invoked in response to an event. This includes invocations that would result in running the same rule again, causing an infinite loop. |
RuleName |
Count |
Events
|
The number of partner events ingested by EventBridge. |
EventSourceName |
Count |
FailedInvocations
|
The number of invocations that failed permanently. This doesn't
include invocations that are retried or invocations that succeeded
after a retry attempt. It also doesn't count failed invocations that
are counted in NoteEventBridge only sends this metric to CloudWatch if it isn't zero. |
RuleName |
Count |
Invocations
|
The number of times a target is invoked by a rule in response to
an event. This includes successful and failed invocations, but
doesn't include throttled or retried attempts until they fail
permanently. It doesn't include
NoteEventBridge only sends this metric to CloudWatch if it isn't zero. |
None, RuleName |
Count |
InvocationAttempts |
Number of times EventBridge attempted invoking a target. |
EventBusName, None, RuleName |
Count |
InvocationsCreated
|
The total number of invocations created in response to each event. This metric is often used to monitor utilization of the Invocations throttle limit in transactions per second EventBridge service quota. |
None |
Count |
InvocationsFailedToBeSentToDlq
|
The number of invocations that couldn't be moved to a dead-letter queue. Dead-letter queue errors occur due to permissions errors, unavailable resources, or size limits. NoteEventBridge only sends this metric to CloudWatch if it isn't zero. |
RuleName |
Count |
IngestiontoInvocationCompleteLatency
|
The time taken from event ingestion to completion of the first invocation attempt. |
EventBusName, None, RuleName |
Milliseconds |
IngestionToInvocationSuccessLatency |
The time taken from event ingestion to successful target delivery, using the invocation end time as cutoff. This metric is only emitted after the first successful delivery attempt to the target. |
EventBusName, None, RuleName |
Milliseconds |
IngestiontoInvocationStartLatency
|
The time to process events, measured from when an event is ingested by EventBridge to the first invocation of a target. |
EventBusName, None, RuleName |
Milliseconds |
InvocationsSentToDlq
|
The number of invocations that are moved to a dead-letter queue. NoteEventBridge only sends this metric to CloudWatch if it isn't zero. |
RuleName |
Count |
MatchedEvents
|
If EventBusName or EventSourceName is specified, the number of events that matched with any rule. If RuleName is specified, the number of events that matched with a specific rule. |
EventBusName, EventSourceName, RuleName |
Count |
RetryInvocationAttempts |
Number of times target invocation has been retried. NoteEventBridge only sends this metric to CloudWatch if it isn't zero. |
EventBusName, None, RuleName |
Count |
SuccessfulInvocationAttempts |
Number of times target was successfully invoked. |
EventBusName, None, RuleName |
Count |
ThrottledRules
|
The number of times rule execution was throttled. Invocations for those rules may be delayed. For more information, see Invocations throttle limit in transactions per second in EventBridge quotas. |
EventBusName, None, RuleName |
Count |
TriggeredRules
|
The number of rules that have run and matched with any event. You won't see this metric in CloudWatch until a rule is triggered. |
EventBusName, None, RuleName |
Count |
EventBridge PutEvents metrics
The AWS/Events
namespace includes the following metrics pertaining to
the PutEvents
API requests.
For the metrics that use Count as a unit, Sum and SampleCount tend to be the most useful statistics.
Metric | Description | Dimensions | Units |
---|---|---|---|
PutEventsApproximateCallCount |
Approximate number of received |
None |
Count |
PutEventsApproximateFailedCount
|
Approximate number of failed |
None |
Count |
PutEventsApproximateSuccessCount
|
Approximate number of successful |
None |
Count |
PutEventsApproximateThrottledCount
|
Number of |
None |
Count |
PutEventsEntriesCount |
The number of event entries contained in a |
None |
Count |
PutEventsFailedEntriesCount |
The number of event entries contained in a |
None |
Count |
PutEventsLatency
|
The time taken per |
None |
Milliseconds |
PutEventsRequestSize
|
The size of the |
None |
Bytes |
EventBridge PutPartnerEvents metrics
The AWS/Events
namespace includes the following metrics
pertaining to the PutPartnerEvents
API requests.
Note
EventBridge only includes metrics pertaining to PutPartnerEvents requests in SaaS partner accounts that send events. For more information, see Receiving events from a SaaS partner with Amazon EventBridge
For the metrics that use Count as a unit, Sum and SampleCount tend to be the most useful statistics.
Metric | Description | Dimensions | Units |
---|---|---|---|
PutPartnerEventsApproximateCallCount |
Approximate number of received |
None |
Count |
PutPartnerEventsApproximateFailedCount
|
Approximate number of failed |
None |
Count |
PutPartnerEventsApproximateThrottledCount
|
Number of |
None |
Count |
PutPartnerEventsApproximateSuccessCount
|
Approximate number of successful |
None |
Count |
PutPartnerEventsEntriesCount |
The number of event entries contained in a |
None |
Count |
PutPartnerEventsFailedEntriesCount |
The number of event entries contained in a |
None |
Count |
PutPartnerEventsLatency
|
The time taken per |
None |
Milliseconds |
Dimensions for EventBridge metrics
EventBridge metrics have dimensions, or sortable attributes, which are listed below.
Dimension | Description |
---|---|
EventBusName
|
Filters the available metrics by event bus name. |
EventSourceName
|
Filters the available metrics by partner event source name. |
RuleName
|
Filters the available metrics by rule name. |