• /
  • Log in
  • Free account
Docs

Amazon SQS monitoring integration

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.

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

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.

For more help

If you need more help, check out these support and learning resources:

Docs
Create issueEdit page
Copyright © 2021 New Relic Inc.