Amazon SQS monitoring integration | New Relic Documentation

Important

Enable the AWS CloudWatch Metric Streams integration to monitor all CloudWatch metrics from your AWS services, including custom namespaces. Individual integrations are no longer our recommended option.

New Relic's infrastructure integrations include an integration for reporting your Amazon SQS data to New Relic. This document explains how to activate the integration and describes the data reported.

Features

Amazon Simple Queue Service (Amazon SQS) provides hosted queues for storing messages in transit. New Relic's SQS integration reports queue-related data such as the count of messages delivered, delayed, and received, message size, and other metrics and configuration/inventory data. SQS data is available in pre-built dashboards and you can also create custom queries and charts in New Relic One. You can also create alert conditions to notify you of changes in SQS data.

Activate integration

To enable this integration follow standard procedures to Connect AWS services to New Relic.

Configuration and polling

You can change the polling frequency and filter data using configuration options.

Default polling information for the Amazon SQS integration:

New Relic polling interval: 5 minutes
AWS CloudWatch data interval: 1 minute

Find and use data

To find your integration data, go to one.newrelic.com > Infrastructure > AWS and select one of the SQS integration links.

You can query and explore your data using the QueueSample event type, with a provider value of SqsQueue.

For more on how to use your data, see Understand integration data.

Metric data

This integration collects the following Amazon SQS metrics. For full metric descriptions, see Amazon's SQS documentation.

Name	Description
`approximateAgeOfOldestMessage`	The approximate age of the oldest non-deleted message in the queue, in seconds. For dead letter queues, this value is the longest time that a message has been in the queue.
`approximateNumberOfMessagesDelayed`	The approximate 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.
`approximateNumberOfMessagesNotVisible`	The approximate 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.
`approximateNumberOfMessagesVisible`	The approximate number of messages available for retrieval from the queue.
`numberOfEmptyReceives`	The number of `ReceiveMessage` API calls that did not return a message.
`numberOfMessagesDeleted`	The number of messages deleted from the queue.
`numberOfMessagesReceived`	The number of messages returned by calls to the `ReceiveMessage` API action.
`numberOfMessagesSent`	The number of messages added to a queue.
`sentMessagesSize`	The size in bytes of messages added to a queue.

Inventory data

EOL NOTICE

After March 2022, we're discontinuing support for several capabilities, including inventory data for cloud integrations. For more details, including how you can easily prepare for this transition, see our Explorers Hub post.

This integration reports the following SQS configuration options as inventory data. For more about inventory data, see Understand integration data.

Tip

Data indicated with an asterisk * are only fetched if extended inventory collection is on.

Name	Description
`awsRegion`	The AWS region for the queue.
`delaySeconds`*	The number of seconds that a message placed into the queue should remain invisible to consumers before becoming available for consumption. Valid values: `0` and `900` (15 minutes).
`maximumMessageSize`*	The maximum amount of bytes a message can contain before Amazon SQS rejects it. For more information, see SetQueueAttributes.
`messageRetentionPeriod`*	The number of seconds Amazon SQS retains a message. For more information, see SetQueueAttributes.
`queue`	The name of the queue, which is a combination of the region, the AWS account ID and the customer specified queue name. For example, in `https://sqs.us-east-1.amazonaws.com/01234567890/new-car-orders`: `us-east-1` is the region `01234567890` is the AWS account ID `new-car-orders` is the name of the queue
`queueArn`*	The Amazon Resource Name (ARN) for the queue. For example, in `arn:aws:sqs:us-east-1:01234567890/new-car-orders` the ARN is `aws`.
`queueUrl`	The URL for the queue. For example, `https://sqs.us-east-1.amazonaws.com/01234567890/new-car-orders`.
`receiveMessageWaitTimeSeconds`*	The time in seconds for which a ReceiveMessage call will wait for a message to arrive. Valid values: `0` to `20`
`visibilityTimeout`*	The visibility timeout for the queue, in seconds. Valid values: `0` to `43200` (12 hours).
`createdTimestamp`*	Returns the time when the queue was created in seconds.
`lastModifiedTimestamp`*	Returns the time when the queue was last changed in seconds.
`redrivePolicy`*	Returns the string that includes the parameters for dead letter queue functionality of the source queue.