Amazon SQS

SQS Dashboard


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.



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

Metric collection

  1. In the AWS integration page, ensure that SQS is enabled under the Metric Collection tab.

  2. Add these 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, see the SQS policies on the AWS website.

  3. Install the Datadog - Amazon SQS integration.

Log collection

Enable SQS logging

See Logging Amazon SQS API Calls Using AWS CloudTrail to configure your trail. When you define your trails, select a S3 bucket to write the logs in:

CloudTrail logging

Send logs to Datadog

  1. If you haven’t already, set up the Datadog log collection AWS Lambda function.
  2. Once the lambda function is installed, manually add a trigger on the S3 bucket that contains your Amazon SQS logs in the AWS console. In your Lambda, click on S3 in the trigger list:
    S3 trigger configuration
    Configure your trigger by choosing the S3 bucket that contains your Amazon SQS logs and change the event type to Object Created (All) then click on the add button.
    S3 Lambda trigger configuration

Once the trigger has been added, use the Datadog Log Explorer to view your logs.

Data Collected


The approximate age of the oldest non-deleted message in the queue.
Shown as second
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
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
The number of messages available for retrieval from the queue.
Shown as message
The number of ReceiveMessage API calls that did not return a message.
Shown as message
The number of messages deleted from the queue.
Shown as message
The number of messages returned by calls to the ReceiveMessage API action.
Shown as message
The number of messages added to a queue.
Shown as message
The size of messages added to a queue.
Shown as byte

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


The Amazon SQS integration does not include any events.

Service Checks

The Amazon SQS integration does not include any service checks.

Out-of-the-box monitoring

The Amazon SQS integration provides ready-to-use monitoring capabilities to monitor and optimize performance.


Need help? Contact Datadog support.