The sqs metricset of aws module allows you to monitor your AWS SQS queues. `sqs` metricset fetches a set of values from
https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html[Amazon SQS Metrics].
CloudWatch metrics for Amazon SQS queues are automatically collected and pushed to CloudWatch every five minutes.

[float]
=== AWS Permissions
Some specific AWS permissions are required for IAM user to collect AWS SQS metrics.
----
cloudwatch:GetMetricData
cloudwatch:ListMetrics
ec2:DescribeRegions
sqs:ListQueues
sts:GetCallerIdentity
iam:ListAccountAliases
----

[float]
=== Dashboard

The aws sqs metricset comes with a predefined dashboard. For example:

image::./images/metricbeat-aws-sqs-overview.png[]

[float]
=== Configuration example
[source,yaml]
----
- module: aws
  period: 300s
  metricsets:
    - sqs
  access_key_id: '<access_key_id>'
  secret_access_key: '<secret_access_key>'
  session_token: '<session_token>'
----
