---
title: Alibaba Cloud SMQ
description: >-
  Monitor Alibaba Cloud SMQ message throughput, queue backlogs, API call volume,
  and success rates.
breadcrumbs: Docs > Integrations > Alibaba Cloud SMQ
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Alibaba Cloud SMQ
Integration version1.0.0
{% callout %}
# Important note for users on the following Datadog sites: us2.ddog-gov.com

{% alert level="info" %}
To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com).
{% /alert %}

{% /callout %}

## Overview{% #overview %}

Alibaba Cloud SMQ (Simple Message Queue, formerly MNS) is a distributed messaging service that lets you transfer data and notifications between the components of an application using queues and topics.

Use this integration to monitor message throughput, queue backlogs, API call volume, and success rates for your SMQ queues and topics.

## Setup{% #setup %}

### Installation{% #installation %}

After you set up the [Alibaba Cloud](https://docs.datadoghq.com/integrations/alibaba_cloud.md) integration, ensure that the SMQ service is included in your Alibaba Cloud monitoring configuration.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **alibabacloud.smq.active_messages.average**(gauge)                                   | Number of active messages in the queue.*Shown as message*                              |
| **alibabacloud.smq.active_messages.minimum**(gauge)                                   | Number of active messages in the queue.*Shown as message*                              |
| **alibabacloud.smq.active_messages.maximum**(gauge)                                   | Number of active messages in the queue.*Shown as message*                              |
| **alibabacloud.smq.batch_delete_message_count.average**(gauge)                      | Number of batch delete message requests.*Shown as request*                             |
| **alibabacloud.smq.batch_delete_message_count.minimum**(gauge)                      | Number of batch delete message requests.*Shown as request*                             |
| **alibabacloud.smq.batch_delete_message_count.maximum**(gauge)                      | Number of batch delete message requests.*Shown as request*                             |
| **alibabacloud.smq.batch_receive_message_count.average**(gauge)                     | Number of batch receive message requests.*Shown as request*                            |
| **alibabacloud.smq.batch_receive_message_count.minimum**(gauge)                     | Number of batch receive message requests.*Shown as request*                            |
| **alibabacloud.smq.batch_receive_message_count.maximum**(gauge)                     | Number of batch receive message requests.*Shown as request*                            |
| **alibabacloud.smq.batch_send_message_count.average**(gauge)                        | Number of batch send message requests.*Shown as request*                               |
| **alibabacloud.smq.batch_send_message_count.minimum**(gauge)                        | Number of batch send message requests.*Shown as request*                               |
| **alibabacloud.smq.batch_send_message_count.maximum**(gauge)                        | Number of batch send message requests.*Shown as request*                               |
| **alibabacloud.smq.change_message_visibility_count.average**(gauge)                 | Number of change message visibility requests.*Shown as operation*                      |
| **alibabacloud.smq.change_message_visibility_count.minimum**(gauge)                 | Number of change message visibility requests.*Shown as operation*                      |
| **alibabacloud.smq.change_message_visibility_count.maximum**(gauge)                 | Number of change message visibility requests.*Shown as operation*                      |
| **alibabacloud.smq.delay_messages.average**(gauge)                                    | Number of delayed messages in the queue.*Shown as message*                             |
| **alibabacloud.smq.delay_messages.minimum**(gauge)                                    | Number of delayed messages in the queue.*Shown as message*                             |
| **alibabacloud.smq.delay_messages.maximum**(gauge)                                    | Number of delayed messages in the queue.*Shown as message*                             |
| **alibabacloud.smq.delete_message_count.average**(gauge)                             | Number of delete message requests.*Shown as request*                                   |
| **alibabacloud.smq.delete_message_count.maximum**(gauge)                             | Number of delete message requests.*Shown as request*                                   |
| **alibabacloud.smq.delete_message_count.minimum**(gauge)                             | Number of delete message requests.*Shown as request*                                   |
| **alibabacloud.smq.inactive_messages.average**(gauge)                                 | Number of inactive messages in the queue.*Shown as message*                            |
| **alibabacloud.smq.inactive_messages.minimum**(gauge)                                 | Number of inactive messages in the queue.*Shown as message*                            |
| **alibabacloud.smq.inactive_messages.maximum**(gauge)                                 | Number of inactive messages in the queue.*Shown as message*                            |
| **alibabacloud.smq.receive_message_count.average**(gauge)                            | Number of receive message requests.*Shown as request*                                  |
| **alibabacloud.smq.receive_message_count.minimum**(gauge)                            | Number of receive message requests.*Shown as request*                                  |
| **alibabacloud.smq.receive_message_count.maximum**(gauge)                            | Number of receive message requests.*Shown as request*                                  |
| **alibabacloud.smq.send_message_count.average**(gauge)                               | Number of send message requests.*Shown as request*                                     |
| **alibabacloud.smq.send_message_count.minimum**(gauge)                               | Number of send message requests.*Shown as request*                                     |
| **alibabacloud.smq.send_message_count.maximum**(gauge)                               | Number of send message requests.*Shown as request*                                     |
| **alibabacloud.smq.topic_count.value**(gauge)                                         | Number of topics.*Shown as item*                                                       |
| **alibabacloud.smq.topic_count_new.value**(gauge)                                    | Number of topics.*Shown as item*                                                       |
| **alibabacloud.smq.topic_success_rate.average**(gauge)                               | Percentage of successful push notifications to topic subscribers.*Shown as percent*    |
| **alibabacloud.smq.topic_success_rate_new.value**(gauge)                            | Percentage of successful push notifications to topic subscribers.*Shown as percent*    |
| **alibabacloud.smq.age_of_oldest_message.value**(gauge)                             | Delay time of the oldest backlogged message.*Shown as millisecond*                     |
| **alibabacloud.smq.age_of_oldest_visible_message_per_subscription.value**(gauge) | Backlog time of the oldest visible message for the subscription.*Shown as millisecond* |
| **alibabacloud.smq.max_api_qps_per_user.value**(rate)                              | Maximum API QPS per second.*Shown as query*                                            |
| **alibabacloud.smq.max_console_api_qps_per_user.value**(rate)                     | Maximum console API QPS per second.*Shown as query*                                    |
| **alibabacloud.smq.number_of_batch_delete_api_calls.value**(gauge)                | Number of batch delete API calls.*Shown as request*                                    |
| **alibabacloud.smq.number_of_batch_receive_api_calls.value**(gauge)               | Number of batch receive API calls.*Shown as request*                                   |
| **alibabacloud.smq.number_of_batch_sned_api_calls.value**(gauge)                  | Number of batch send API calls.*Shown as request*                                      |
| **alibabacloud.smq.number_of_change_messa_visibility_api_calls.value**(gauge)    | Number of change message visibility API calls.*Shown as request*                       |
| **alibabacloud.smq.number_of_delete_api_calls.value**(gauge)                       | Number of delete API calls.*Shown as request*                                          |
| **alibabacloud.smq.number_of_empty_receives.value**(gauge)                          | Number of empty receive requests.*Shown as request*                                    |
| **alibabacloud.smq.number_of_messages_delayed.value**(gauge)                        | Number of delayed (scheduled) messages.*Shown as message*                              |
| **alibabacloud.smq.number_of_messages_invisible.value**(gauge)                      | Number of invisible messages.*Shown as message*                                        |
| **alibabacloud.smq.number_of_messages_visible.value**(gauge)                        | Number of visible messages.*Shown as message*                                          |
| **alibabacloud.smq.number_of_messages_visible_per_subscription.value**(gauge)     | Number of backlogged messages for the subscription.*Shown as message*                  |
| **alibabacloud.smq.number_of_publish_api_calls_per_topic.value**(gauge)          | Number of publish API calls for the topic.*Shown as request*                           |
| **alibabacloud.smq.number_of_push_per_subscription.value**(gauge)                  | Number of pushes for the subscription.*Shown as message*                               |
| **alibabacloud.smq.number_of_receive_api_calls.value**(gauge)                      | Number of receive API calls.*Shown as request*                                         |
| **alibabacloud.smq.number_of_send_api_calls.value**(gauge)                         | Number of send API calls.*Shown as request*                                            |
| **alibabacloud.smq.process_success_rate_per_subscription.value**(gauge)            | Processing success rate for the subscription.*Shown as percent*                        |
| **alibabacloud.smq.watermark_of_api_qps.value**(gauge)                              | API QPS watermark percentage.*Shown as percent*                                        |
| **alibabacloud.smq.watermark_of_console_api_qps.value**(gauge)                     | Console API QPS watermark percentage.*Shown as percent*                                |

### Events{% #events %}

Alibaba Cloud SMQ does not include any events.

### Service Checks{% #service-checks %}

Alibaba Cloud SMQ does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).