﻿---
title: AWS SQS Metrics OpenTelemetry Assets
description: This package contains Kibana assets for monitoring SQS queues with AWS CloudWatch metrics collected by the OpenTelemetry Collector. The package is content...
url: https://docs-v3-preview.elastic.dev/elastic/integration-docs/tree/main/reference/aws_sqs_otel
products:
  - Elastic integrations
applies_to:
  - Serverless Observability projects: Preview
  - Serverless Security projects: Preview
  - Elastic Stack: Preview since 9.5
---

# AWS SQS Metrics OpenTelemetry Assets
|                                                                                                                               |                                                                    |
|-------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------|
| **Version**                                                                                                                   | 0.11.0 <applies-to>: Preview</applies-to> ([View all](#changelog)) |
| **Subscription level**[What's this?](https://www.elastic.co/subscriptions)                                                    | Basic                                                              |
| **Developed by**[What's this?](https://docs-v3-preview.elastic.dev/elastic/integration-docs/tree/main/reference/developed-by) | Elastic                                                            |
| **Minimum Kibana version(s)**                                                                                                 | 9.5.0                                                              |

<admonition title="The AWS SQS Metrics OpenTelemetry Assets integration v0.11.0 is in technical preview">
  To use pre-release integrations, go to the **Integrations** page in Kibana, scroll down, and toggle on the _Display beta integrations_ option.
</admonition>

This package contains Kibana assets for monitoring SQS queues with AWS CloudWatch metrics collected by the OpenTelemetry Collector.
The package is **content only**. It provides a curated metrics dashboard, but it does not configure data collection. Use the **AWS CloudWatch OpenTelemetry Input Package** (`aws_cloudwatch_input_otel`) to configure the OpenTelemetry Collector CloudWatch receiver and collect the required AWS service metrics into Elasticsearch.

## Data requirements

- CloudWatch metrics collected by the OpenTelemetry Collector AWS CloudWatch receiver.
- Documents indexed into the `metrics-aws.sqs.otel-*` data stream.
- The relevant AWS dimensions for this service, such as resource name, region, and service-specific identifiers.


## Compatibility

Requires Kibana `^9.5.0`.

## Dashboards

This package includes one pre-built Kibana dashboard:

| Name                   | Description                                                                        |
|------------------------|------------------------------------------------------------------------------------|
| [AWS SQS OTel] Metrics | AWS SQS dashboard for CloudWatch metrics collected by the OpenTelemetry Collector. |


## Alerting Rule Templates

Alert rule templates provide pre-defined configurations for creating alert rules in Kibana.
For more information, refer to the [Elastic documentation](https://www.elastic.co/docs/reference/fleet/alerting-rule-templates).
Alert rule templates require Elastic Stack version 9.2.0 or later.
**The following alert rule templates are available:**
<dropdown title="View the alert rule templates">
  | Name                                   | Description                                                                                                                                                                                                                                              |
  |----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
  | [AWS SQS OTel] DLQ has messages        | Alerts when any dead-letter queue has one or more visible messages. Any message in a DLQ represents a processing failure and warrants immediate investigation.                                                                                           |
  | [AWS SQS OTel] High backlog            | Alerts when a queue's visible message backlog stays above the configured depth across the evaluation window, indicating consumers are not keeping up with producers. Pair with the oldest-message-age alert/SLO, which captures processing lag directly. |
  | [AWS SQS OTel] In-flight saturation    | Alerts when in-flight messages approach the standard-queue limit (~120,000), indicating stuck consumers or processing bottlenecks.                                                                                                                       |
  | [AWS SQS OTel] Oldest message age high | Alerts when the oldest unprocessed message on a queue exceeds a configurable age threshold. This is the headline SQS processing-lag signal.                                                                                                              |
  | [AWS SQS OTel] Producer send rate drop | Alerts when a queue's message send rate drops below the configured minimum, indicating producer slowdown or failure. Requires threshold tuning to match your expected baseline send rate.                                                                |
</dropdown>


## SLO Templates

SLO templates provide pre-defined configurations for creating SLOs in Kibana.
For more information, refer to the [Elastic documentation](https://www.elastic.co/docs/solutions/observability/incident-management/service-level-objectives-slos).
SLO templates require Elastic Stack version 9.4.0 or later.
**The following SLO templates are available:**
<dropdown title="View the SLO templates">
  | Name                                                    | Description                                                                                                                                                                                                                                                                                                                                   |
  |---------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
  | [AWS SQS OTel] DLQ empty 99.5% rolling 30 days          | Tracks dead-letter queue correctness: 99.5% of 1-minute intervals must show zero visible messages on DLQ queues (QueueName matching *dlq*). Any message in a DLQ represents a processing failure and dropped work — the primary SQS error signal. Adjust the QueueName pattern if your DLQ naming convention differs.                         |
  | [AWS SQS OTel] Oldest message age 99.5% rolling 30 days | Tracks processing freshness per queue: 99.5% of 1-minute intervals must show maximum oldest-message age below 300 seconds on non-DLQ queues. ApproximateAgeOfOldestMessage is the headline SQS timeliness signal — sustained elevation means consumers are falling behind. Threshold is workload-dependent and should be tuned per queue SLA. |
</dropdown>


## Screenshots

This integration includes one or more Kibana dashboards that visualizes the data collected by the integration. The screenshots below illustrate how the ingested data is displayed.
<carousel>
  ![Dashboard screenshot](https://epr.elastic.co/package/aws_sqs_otel/0.11.0/img/dashboard.png)
</carousel>


## Changelog

<dropdown title="Changelog">
  | Version    | Details                                                                                                                                                                                                                                                                                                            | Minimum Kibana version |
  |------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------|
  | **0.11.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/19924))Add ML anomaly detection module for SQS queue backlog, in-flight, and oldest-message age.**Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/19924))Add ml_module to the Kibana asset tags. | 9.5.0                  |
  | **0.10.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/19887))Add missing recommended alert for producer send rate drop.                                                                                                                                                                | 9.5.0                  |
  | **0.9.0**  | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/19940))Add tags to Kibana assets                                                                                                                                                                                                 | 9.5.0                  |
  | **0.8.1**  | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/19964))Rename the dashboard to "[AWS SQS OTel] Metrics".                                                                                                                                                                         | 9.5.0                  |
  | **0.8.0**  | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/19884))Remove the idle status and map "no data" to "Unknown" across SQS dashboard panels.                                                                                                                                        | 9.5.0                  |
  | **0.7.0**  | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/19799))Improve ESQL queries in dashboards                                                                                                                                                                                        | 9.5.0                  |
  | **0.6.0**  | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/19797))Add _dev/build/docs/README.md                                                                                                                                                                                             | 9.5.0                  |
  | **0.5.0**  | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/19683))Improve dashboard queries and visualizations                                                                                                                                                                              | 9.5.0                  |
  | **0.4.0**  | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/19695))Update aggregation functions and replace backlog-growth alert with high-backlog.                                                                                                                                          | 9.5.0                  |
  | **0.3.0**  | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/19637))Add alert rules and SLOs to README                                                                                                                                                                                        | 9.5.0                  |
  | **0.2.1**  | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/19666))Standardize the package title and description to the `AWS <service> <signal> OpenTelemetry Assets` naming convention.                                                                                                     | 9.5.0                  |
  | **0.2.0**  | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/19483))Create new SLO and Alert assets                                                                                                                                                                                           | 9.5.0                  |
  | **0.1.0**  | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/19462))Initial AWS SQS OpenTelemetry metrics dashboard package                                                                                                                                                                   | 9.5.0                  |
</dropdown>