AWS SQS monitoring integration

Access to this feature depends on your subscription level. Requires Infrastructure Pro.

New Relic Infrastructure's integrations include an integration for reporting your AWS SQS data to New Relic products. 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 Insights. You can also create alert conditions to notify you of changes in SQS data.

The maximum number of queues for New Relic's SQS integration is 1000.

Activate integration

To enable this integration:

  1. Make sure you have installed the Infrastructure agent before you activate AWS integrations from your Infrastructure account.
  2. Follow standard procedures to Connect AWS services to Infrastructure.

Configuration and polling

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

Default polling information for the AWS SQS integration:

  • New Relic polling interval: 5 minutes
  • Amazon CloudWatch data interval: 5 minutes

Find and use data

To find your integration data in Infrastructure, go to infrastructure.newrelic.com > Integrations > Amazon Web Services and select one of the SQS integration links.

In New Relic Insights, data is attached to 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
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

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

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

For more help

Recommendations for learning more: