Monitoring Amazon EventBridge - Amazon EventBridge

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