Network Performance Monitoring is now generally available! Network Monitoring is now available!
home Home docs Docs api API

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

Metric collection

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

  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 on SQS policies, review the documentation on the AWS website.

  3. Install the Datadog - AWS 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 done, use the Datadog Log Explorer to view your logs.

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

Service Checks

The AWS SQS integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.

Table of Contents