PDF

AWS SQS Sensor

AWS SQS Sensor allows monitoring of key metrics of AWS Simple Queue Service (SQS). SQS is a fully managed message queuing service that enables you to decouple and scale microservices, distributed systems, and serverless applications.

The sensor monitors AWS Simple Queue Service performance and workload parameters. With this sensor, you can avoid queue overload (indicated by a large number of delayed messages) and spot a large number of empty receives - which can inform about errors within pushing service(s).

Requirements

To use this sensor you will need a user Access Key ID and Secret Access Key (the second one is visible only shortly after key pair generation). The user whose credentials are entered during sensor configuration needs proper access rights for CloudWatch queries (example JSON with IAM rights below)


{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "Stmt1338559372809",
      "Action": [
        "cloudwatch:GetMetricStatistics",
	    "cloudwatch:GetMetricData",
        "cloudwatch:ListMetrics",
        "cloudwatch:DescribeAlarms"
      ],
      "Effect": "Allow",
      "Resource": ""
    },
    {
      "Sid": "Stmt1338559548992",
      "Action": [
        "sqs:ListQueues"
      ],
      "Effect": "Allow",
      "Resource": ""
    }
  ]
}

Options

This sensor can only be used on the NetCrunch Cloud Service node. There is only one sensor allowed per node. During sensor configuration, you will have to choose one specific SQS instance that you want to monitor. You can also add your own ID to the sensor if you monitor multiple SQS instances.

Alerts

  • Delayed Messages > 15 - a large number of messages delayed (queue overloaded)
  • Number of Empty Receives > 10 - a large number of empty receives may indicate a pushing service error

Performance Metrics

  • Queue\Oldest Non-deleted Message Age - Age of oldest non-deleted message in seconds
  • Queue\Messages not Visible - The number of messages that are in flight.
  • Queue\Messages Visible - The number of messages available for retrieval from the queue.
  • Queue\Messages Added - The number of messages added to a queue.
  • Queue\Messages Delayed - The number of messages in the queue that are delayed and not available for reading immediately.
  • Queue\Number of Empty Receives - The number of ReceiveMessage API calls that did not return a message.
  • Queue\Messages Deleted - The number of messages deleted from the queue.
  • Queue\Messages Received - The number of messages returned by calls to the ReceiveMessage action.
  • Queue\Sent Message Size Bytes - The size of messages added to a queue.

Reports (Data Collectors)

By default, the sensor adds a report containing Queue\Oldest Non-deleted Message Age, Queue\Messages not Visible, Queue\Messages Visible, and Queue\Messages Added charts. These metrics will be collected and available as a report or through Performance Trend Viewer

awscloudqueueservice