The Service Map for APM is here!

AWS SQS

Crawler Crawler
SQS Dashboard

Overview

Amazon Simple Queue Service (SQS) is a fast, reliable, scalable, fully managed message queuing service.

Enable this integration to see all your SQS metrics in Datadog.

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Configuration

  1. In the AWS integration tile, ensure that SQS is checked under metric collection.

  2. Add those permissions to your Datadog IAM policy in order to collect Amazon SQS metrics:

    • sqs:ListQueues: Used to list alive queues.
    • tag:GetResources: Get custom tags applied to SQS queues.

    For more information on SQS policies, review the documentation on the AWS website.

  3. Install the Datadog - AWS SQS integration.

Data Collected

Metrics

aws.sqs.approximate_age_of_oldest_message
(gauge)
The approximate age of the oldest non-deleted message in the queue.
shown as second
aws.sqs.approximate_number_of_messages_delayed
(gauge)
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.
shown as message
aws.sqs.approximate_number_of_messages_not_visible
(gauge)
The number of messages that are in flight. Messages are considered 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.
shown as message
aws.sqs.approximate_number_of_messages_visible
(gauge)
The number of messages available for retrieval from the queue.
shown as message
aws.sqs.number_of_empty_receives
(count)
The number of ReceiveMessage API calls that did not return a message.
shown as message
aws.sqs.number_of_messages_deleted
(count)
The number of messages deleted from the queue.
shown as message
aws.sqs.number_of_messages_received
(count)
The number of messages returned by calls to the ReceiveMessage API action.
shown as message
aws.sqs.number_of_messages_sent
(count)
The number of messages added to a queue.
shown as message
aws.sqs.sent_message_size
(gauge)
The size of messages added to a queue.
shown as byte

Each of the metrics retrieved from AWS will be assigned the same tags that appear in the AWS console, including but not limited to host name, security-groups, and more.

Events

The AWS SQS integration does not include any event at this time.

Service Checks

The AWS SQS integration does not include any service check at this time.

Troubleshooting

Need help? Contact Datadog Support.