Available CloudWatch metrics for Amazon SQS
Amazon SQS sends the following metrics to CloudWatch.
Note
For some metrics, the result is approximate because of the distributed architecture of Amazon SQS. In most cases, the count should be close to the actual number of messages in the queue.
Amazon SQS metrics
The AWS/SQS
namespace includes the following metrics.
Metric | Description |
---|---|
ApproximateAgeOfOldestMessage |
The approximate age of the oldest non-deleted message in the
queue. Note
Reporting criteria: A non-negative value is reported if the queue is active. Units: Seconds Valid statistics: Average, Minimum, Maximum, Sum, Data Samples (displays as Sample Count in the Amazon SQS console) |
ApproximateNumberOfGroupsWithInflightMessages |
The approximate number of message groups with in flight
messages, where a message is considered to be in flight after it's received from
a queue by a consumer, but not yet deleted from the queue. This
metric can help you troubleshoot and optimize your FIFO queue
throughput by either increasing FIFO message groups, or scaling
your consumers.
Reporting criteria: A non-negative value is reported if the queue is active. Units: Count Valid statistics: Average, Minimum, Maximum, Sum, Data Samples (displays as Sample Count in the Amazon SQS console) For current FIFO throughput and in flight limits, see Amazon SQS message quotas. |
ApproximateNumberOfMessagesDelayed |
The number of messages in the queue that are delayed and not
available for reading immediately. This can happen when the
queue is configured as a delay queue or when a message has been
sent with a delay parameter.
Reporting criteria: A non-negative value is reported if the queue is active. Units: Count Valid statistics: Average, Minimum, Maximum, Sum, Data Samples (displays as Sample Count in the Amazon SQS console) |
ApproximateNumberOfMessagesNotVisible |
The number of messages that are in flight. Messages are
considered to be in flight if they have
been sent to a client but have not yet been deleted or have not
yet reached the end of their visibility
window. Reporting criteria: A non-negative value is reported if the queue is active. Units: Count Valid statistics: Average, Minimum, Maximum, Sum, Data Samples (displays as Sample Count in the Amazon SQS console) |
ApproximateNumberOfMessagesVisible |
The number of messages to be processed.
Reporting criteria: A non-negative value is reported if the queue is active. Units: Count Valid statistics: Average, Minimum, Maximum, Sum, Data Samples (displays as Sample Count in the Amazon SQS console) There is no limit on the number of messages to processes, however you can subject this backlog to a retention period. |
NumberOfEmptyReceives ¹ |
The number of ReceiveMessage API calls that did
not return a
message.Reporting criteria: A non-negative value is reported if the queue is active. Units: Count Valid statistics: Average, Minimum, Maximum, Sum, Data Samples (displays as Sample Count in the Amazon SQS console) |
NumberOfDeduplicatedSentMessages |
The number of messages sent to a queue that were
deduplicated. This metric can help determine if a producer is
sending duplicate messages to an Amazon SQS FIFO
queue. Reporting criteria: A non-negative value is reported if the queue is active. Units: Count Valid statistics: Average, Minimum, Maximum, Sum, Data Samples (displays as Sample Count in the Amazon SQS console) |
NumberOfMessagesDeleted ¹ |
The number of messages deleted from the
queue. Reporting criteria: A non-negative value is reported if the queue is active. Units: Count Valid statistics: Average, Minimum, Maximum, Sum, Data Samples (displays as Sample Count in the Amazon SQS console) Amazon SQS emits theNumberOfMessagesDeleted metric for every
successful deletion operation that uses a valid receipt handle, including duplicate deletions. The
following scenarios might cause the value of the
NumberOfMessagesDeleted metric to be higher
than expected:
|
NumberOfMessagesReceived ¹ |
The number of messages returned by calls to the
ReceiveMessage
action.Reporting criteria: A non-negative value is reported if the queue is active. Units: Count Valid statistics: Average, Minimum, Maximum, Sum, Data Samples (displays as Sample Count in the Amazon SQS console) |
NumberOfMessagesSent ¹ |
The number of messages added to a queue.
If you send a message to a dead-letter queue manually, it is captured by the
Reporting criteria: A non-negative value is reported if the queue is active. Units: Count Valid statistics: Average, Minimum, Maximum, Sum, Data Samples (displays as Sample Count in the Amazon SQS console) |
SentMessageSize ¹ |
The size of messages added to a queue. Reporting criteria: A non-negative value is reported if the queue is active. Units: Bytes Valid statistics: Average, Minimum, Maximum, Sum, Data Samples (displays as Sample Count in the Amazon SQS console) Note
|
¹ These metrics are calculated from a service perspective, and can include retries. Don't rely on the absolute values of these metrics, or use them to estimate current queue status.
Dimensions for Amazon SQS metrics
The only dimension that Amazon SQS sends to CloudWatch is QueueName
. This
means that all available statistics are filtered by
QueueName
.