New Relic 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.
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.
To enable this integration follow standard procedures to Connect AWS services to New Relic.
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
- Amazon CloudWatch data interval: 1 minute
To find your integration data, go to one.newrelic.com > Infrastructure > AWS and select one of the SQS integration links.
For more on how to use your data, see Understand integration data.
This integration collects the following Amazon SQS metrics. For full metric descriptions, see Amazon's SQS documentation.
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.
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.
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.
The approximate number of messages available for retrieval from the queue.
The number of
The number of messages deleted from the queue.
The number of messages returned by calls to the
The number of messages added to a queue.
The size in bytes of messages added to a queue.
This integration reports the following SQS configuration options as inventory data. For more about inventory data, see Understand integration data.
Data indicated with an asterisk
* are only fetched if extended inventory collection is on.
The AWS region for the queue.
The number of seconds that a message placed into the queue should remain invisible to consumers before becoming available for consumption.
The maximum amount of bytes a message can contain before Amazon SQS rejects it. For more information, see SetQueueAttributes.
The number of seconds Amazon SQS retains a message. For more information, see SetQueueAttributes.
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
The Amazon Resource Name (ARN) for the queue.
For example, in
The URL for the queue.
The time in seconds for which a ReceiveMessage call will wait for a message to arrive.
The visibility timeout for the queue, in seconds.
Returns the time when the queue was created in seconds.
Returns the time when the queue was last changed in seconds.
Returns the string that includes the parameters for dead letter queue functionality of the source queue.
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's data security and licenses documentation.