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

• Dimensions for EventBridge metrics

• Best practices for monitoring event delivery in Amazon EventBridge

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 DeadLetterInvocations. Note EventBridge 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 DeadLetterInvocations. Note EventBridge 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. Note EventBridge 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. Note EventBridge 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. Note EventBridge 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 event bus 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 PutEvents requests.	None	Count
PutEventsApproximateFailedCount	Approximate number of failed PutEvents requests.	None	Count
PutEventsApproximateSuccessCount	Approximate number of successful PutEvents requests.	None	Count
PutEventsApproximateThrottledCount	Number of PutEvents requests rejected due to throttling.	None	Count
PutEventsEntriesCount	The number of event entries contained in a PutEvents request.	None	Count
PutEventsFailedEntriesCount	The number of event entries contained in a PutEvents request that failed to be ingested.	None	Count
PutEventsLatency	The time taken per PutEvents request.	None	Milliseconds
PutEventsRequestSize	The size of the PutEvents request.	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 PutPartnerEvents requests.	None	Count
PutPartnerEventsApproximateFailedCount	Approximate number of failed PutPartnerEvents requests.	None	Count
PutPartnerEventsApproximateThrottledCount	Number of PutPartnerEvents requests rejected due to throttling.	None	Count
PutPartnerEventsApproximateSuccessCount	Approximate number of successful PutPartnerEvents requests.	None	Count
PutPartnerEventsEntriesCount	The number of event entries contained in a PutPartnerEvents request.	None	Count
PutPartnerEventsFailedEntriesCount	The number of event entries contained in a PutPartnerEvents request that failed to be ingested.	None	Count
PutPartnerEventsLatency	The time taken per PutPartnerEvents request.	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.