Monitoring Amazon EventBridge - Amazon EventBridge
EventBridge metricsDimensions for EventBridge metrics
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

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:

EventBridge metrics

The Amazon/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
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.

Valid Dimensions: RuleName

Units: Count
Events

The number of partner events ingested by EventBridge.

Valid Dimensions: EventSourceName

Units: 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.

Valid Dimensions: RuleName

Units: 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.

Valid Dimensions: None, RuleName

Units: Count
InvocationAttempts

Number of times EventBridge attempted invoking a target.

Valid Dimensions: None

Units: 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.

Valid Dimensions: None

Units: 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.

Valid Dimensions: RuleName

Units: Count
IngestiontoInvocationCompleteLatency

The time taken from event ingestion to completion of the first successful invocation attempt.

Valid Dimensions: EventBusName, None, RuleName

Units: Milliseconds
IngestiontoInvocationStartLatency

The time to process events, measured from when an event is ingested by EventBridge to the first invocation of a target.

Valid Dimensions: EventBusName, None, RuleName

Units: 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.

Valid Dimensions: RuleName

Units: 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.

Valid Dimensions: EventBusName, RuleName, EventSourceName

Units: Count
RetryInvocationAttempts

Number of times target invocation has been retried.

Note

EventBridge only sends this metric to CloudWatch if it isn't zero.

Valid Dimensions: None

Units: Count
SuccessfulInvocationAttempts

Number of times target was successfully invoked.

Valid Dimensions: None

Units: 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.

Valid Dimensions: EventBusName, None, RuleName

Units: 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.

Valid Dimensions: EventBusName, None, RuleName

Units: Count

EventBridge PutEvents metrics

The Amazon/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
PutEventsApproximateCallCount

Approximate number of received PutEvents requests.

Valid Dimensions: None

Units: Count
PutEventsApproximateFailedCount

Approximate number of failed PutEvents requests.

Valid Dimensions: None

Units: Count
PutEventsApproximateSuccessCount

Approximate number of successful PutEvents requests.

Valid Dimensions: None

Units: Count
PutEventsApproximateThrottledCount

Number of PutEvents requests rejected due to throttling.

Valid Dimensions: None

Units: Count
PutEventsEntriesCount

The number of event entries contained in a PutEvents request.

Valid Dimensions: None

Units: Count
PutEventsFailedEntriesCount

The number of event entries contained in a PutEvents request that failed to be ingested.

Valid Dimensions: None

Units: Count
PutEventsLatency

The time taken per PutEvents request.

Valid Dimensions: None

Units: Milliseconds
PutEventsRequestSize

The size of the PutEvents request.

Valid Dimensions: None

Units: Bytes

EventBridge PutPartnerEvents metrics

The Amazon/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
PutPartnerEventsApproximateCallCount

Approximate number of received PutPartnerEvents requests.

Valid Dimensions: None

Units: Count
PutPartnerEventsApproximateFailedCount

Approximate number of failed PutPartnerEvents requests.

Valid Dimensions: None

Units: Count
PutPartnerEventsApproximateThrottledCount

Number of PutPartnerEvents requests rejected due to throttling.

Valid Dimensions: None

Units: Count
PutPartnerEventsApproximateSuccessCount

Approximate number of successful PutPartnerEvents requests.

Valid Dimensions: None

Units: Count
PutPartnerEventsEntriesCount

The number of event entries contained in a PutPartnerEvents request.

Valid Dimensions: None

Units: Count
PutPartnerEventsFailedEntriesCount

The number of event entries contained in a PutPartnerEvents request that failed to be ingested.

Valid Dimensions: None

Units: Count
PutPartnerEventsLatency

The time taken per PutPartnerEvents request.

Valid Dimensions: None

Units: 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.