---
title: Alibaba Cloud
description: >-
  Alibaba Cloud, a subsidiary of Alibaba Group, provides cloud computing
  services.
breadcrumbs: Docs > Integrations > Alibaba Cloud
---

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

# Alibaba Cloud

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com, us2.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ({% placeholder "user-datadog-site-name" /%}).
{% /alert %}

{% /callout %}

## Overview{% #overview %}

Use the [Alibaba Cloud integration](https://app.datadoghq.com/integrations?integrationId=alibaba-cloud) to collect metrics and logs from your Alibaba Cloud services.

*All use of Datadog Services in (or in connection with environments within) mainland China is subject to the disclaimer published in the [Restricted Service Locations](https://www.datadoghq.com/legal/restricted-service-locations/) section on our website.*

## Setup{% #setup %}

Fill out the following parameters to integrate Datadog with the Alibaba Cloud API.

#### Account name{% #account-name %}

Choose a name that helps you identify this Alibaba Cloud account in Datadog. The name is a label for the account in Datadog and does not need to match your Alibaba Cloud account ID.

#### AccessKey ID and AccessKey secret{% #accesskey-id-and-accesskey-secret %}

1. Enable [Resource Center](https://www.alibabacloud.com/help/resource-management/resource-center/product-overview/resource-center-overview) in your Alibaba Cloud account.

1. In **Resource Access Management (RAM)**, create a user with the following values:

   - **User Login Name**: `Datadog`
   - **Display Name**: `Datadog`

1. Select **Permanent AccessKey**.

1. Copy the **AccessKey ID** and **AccessKey secret**, and paste them in the corresponding Datadog account form fields.

1. For the new user, select **Add Permissions** and add the following system policy:

   ```text
   ReadOnlyAccess
   ```

To collect [Container Service for Kubernetes (ACK)](https://www.alibabacloud.com/en/product/kubernetes) metrics using [Managed Service for Prometheus](https://www.alibabacloud.com/en/product/prometheus?_p_lc=1), also attach a custom policy that allows Datadog to install the `ack-arms-prometheus` add-on on your clusters:

   ```json
   {
     "Version": "1",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": "cs:InstallClusterAddons",
         "Resource": "*"
       }
     ]
   }
   ```

1. Select **Update**. After approximately 15 minutes, metrics appear in [Metric Explorer](https://app.datadoghq.com/metric/explorer). Metrics are tagged with custom tags on your resources and with tags returned by the following APIs:

   - [kvstore/redis DescribeInstances](https://www.alibabacloud.com/help/doc-detail/60933.htm)
   - [ECS DescribeInstances](https://www.alibabacloud.com/help/doc-detail/25506.htm)
   - [DescribeDBInstances](https://www.alibabacloud.com/help/doc-detail/26232.htm)
   - [DescribeLoadBalancers](https://www.alibabacloud.com/help/doc-detail/27582.htm)

#### Account tags{% #account-tags %}

**Account tags** are a list of `key:value` tags applied to all metrics, logs, and resources collected from the Alibaba Cloud account.

#### Collect metrics{% #collect-metrics %}

Metric collection is enabled by default. To limit the metrics Datadog collects, set the following filters:

- **Host filters**: Limit metric collection to hosts matching these Alibaba Cloud tag filters. Datadog imports only hosts that match at least one tag.
- **Cluster filters**: Limit metric collection to clusters matching these Alibaba Cloud tag filters.

#### Collect logs{% #collect-logs %}

Toggle **Collect logs** to collect logs from [Alibaba Cloud Simple Log Service (SLS)](https://www.alibabacloud.com/help/en/sls/). Logs from SLS appear in the [Log Explorer](https://app.datadoghq.com/logs) with the source `alibaba-cloud`.

By default, Datadog ingests all available logs from SLS. To limit collection, use one or both of the filter fields:

- **Project tag filters**: Limit log collection to SLS projects with specified tags.
- **Logstore tag filters**: Limit log collection to logstores with specified tags.

**Note**: Datadog applies project tag filters first, then logstore tag filters. If a project is excluded by its tag filter, all of its logstores are excluded as well.

#### Collect resources{% #collect-resources %}

Toggle **Collect resources** to collect your Alibaba Cloud resources. Resources are visible in the [Datadog Resource Catalog](https://docs.datadoghq.com/infrastructure/resource_catalog.md).

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

### Metrics{% #metrics %}

{% collapsible-section %}
#### See the full list of metric namespaces

| Integration                                                                                              | Metric namespace                                                                                                                                         |
| -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Content Delivery Network (CDN)](https://docs.datadoghq.com/integrations/alibaba-cloud-cdn.md)           | [`alibabacloud.cdn`](https://www.alibabacloud.com/help/cdn/product-overview/what-is-alibaba-cloud-cdn)                                                   |
| [Container Service](https://docs.datadoghq.com/integrations/alibaba-cloud-container-service.md)          | [`alibabacloud.container_service`](https://www.alibabacloud.com/en/product/kubernetes)                                                                   |
| [Dynamic Content Delivery Network (DCDN)](https://docs.datadoghq.com/integrations/alibaba-cloud-dcdn.md) | [`alibabacloud.dcdn`](https://www.alibabacloud.com/help/dcdn/product-overview/what-is-dcdn)                                                              |
| [Elastic Compute Service (ECS)](https://docs.datadoghq.com/integrations/alibaba-cloud-ecs.md)            | [`alibabacloud.ecs`](https://www.alibabacloud.com/help/ecs/user-guide/what-is-ecs)                                                                       |
| [Elastic IP Address (EIP)](https://docs.datadoghq.com/integrations/alibaba-cloud-eip.md)                 | [`alibabacloud.eip`](https://www.alibabacloud.com/help/eip/product-overview/what-is-eip)                                                                 |
| [Express Connect](https://docs.datadoghq.com/integrations/alibaba-cloud-express-connect.md)              | [`alibabacloud.express_connect`](https://www.alibabacloud.com/help/express-connect/product-overview/what-is-express-connect)                             |
| [IP Address Manager (IPAM)](https://docs.datadoghq.com/integrations/alibaba-cloud-ipam.md)               | [`alibabacloud.ipam`](https://www.alibabacloud.com/help/vpc/ip-address-management-ipam/)                                                                 |
| [ApsaraMQ for Kafka](https://docs.datadoghq.com/integrations/alibaba-cloud-kafka.md)                     | [`alibabacloud.kafka`](https://www.alibabacloud.com/help/apsaramq-for-kafka/cloud-message-queue-for-kafka/product-overview/what-is-apsaramq-for-kafka-1) |
| [ApsaraDB for Memcache](https://docs.datadoghq.com/integrations/alibaba-cloud-memcache.md)               | [`alibabacloud.memcache`](https://www.alibabacloud.com/help/memcache/product-overview/product-introduction)                                              |
| [ApsaraDB for MongoDB](https://docs.datadoghq.com/integrations/alibaba-cloud-mongodb.md)                 | [`alibabacloud.mongodb`](https://www.alibabacloud.com/help/mongodb/product-overview/what-is-apsaradb-for-mongodb)                                        |
| [NAT Gateway](https://docs.datadoghq.com/integrations/alibaba-cloud-nat-gateway.md)                      | [`alibabacloud.nat_gateway`](https://www.alibabacloud.com/help/nat-gateway/product-overview/what-is-nat-gateway)                                         |
| [ApsaraDB for OceanBase](https://docs.datadoghq.com/integrations/alibaba-cloud-oceanbase.md)             | [`alibabacloud.oceanbase`](https://www.alibabacloud.com/help/apsaradb-for-oceanbase/latest/what-is-oceanbase-database)                                   |
| [Object Storage Service (OSS)](https://docs.datadoghq.com/integrations/alibaba-cloud-oss.md)             | [`alibabacloud.oss`](https://www.alibabacloud.com/help/oss/product-overview/what-is-oss)                                                                 |
| [PolarDB](https://docs.datadoghq.com/integrations/alibaba-cloud-polardb.md)                              | [`alibabacloud.polardb`](https://www.alibabacloud.com/help/polardb/product-introduction)                                                                 |
| [ApsaraDB RDS](https://docs.datadoghq.com/integrations/alibaba-cloud-rds.md)                             | [`alibabacloud.rds`](https://www.alibabacloud.com/help/rds/product-overview/what-is-apsaradb-rds-what-is-apsaradb-rds)                                   |
| [Tair (Redis OSS-Compatible)](https://docs.datadoghq.com/integrations/alibaba-cloud-redis.md)            | [`alibabacloud.redis`](https://www.alibabacloud.com/help/redis/product-overview/product-introduction)                                                    |
| [ApsaraMQ for RocketMQ](https://docs.datadoghq.com/integrations/alibaba-cloud-rocketmq.md)               | [`alibabacloud.rocketmq`](https://www.alibabacloud.com/help/apsaramq-for-rocketmq/product-overview/what-is-apsaramq-for-rocketmq)                        |
| [Server Load Balancer (SLB)](https://docs.datadoghq.com/integrations/alibaba-cloud-slb.md)               | [`alibabacloud.slb`](https://www.alibabacloud.com/help/slb/product-overview/slb-overview)                                                                |
| [Virtual Private Cloud (VPC)](https://docs.datadoghq.com/integrations/alibaba-cloud-vpc.md)              | [`alibabacloud.vpc`](https://www.alibabacloud.com/help/vpc/product-overview/virtual-private-cloud-overview/)                                             |

{% /collapsible-section %}

### Events{% #events %}

Events from Alibaba Cloud are collected on a per Alibaba Cloud-service basis.

## Troubleshooting{% #troubleshooting %}

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

## Further Reading{% #further-reading %}

Additional helpful documentation, links, and articles:

- [Unified observability for Alibaba Cloud with Datadog](https://www.datadoghq.com/blog/monitor-alibaba-cloud-with-datadog/)
