--- title: Alibaba Cloud description: >- Alibaba Cloud, a subsidiary of Alibaba Group, provides cloud computing services. breadcrumbs: Docs > Integrations > Alibaba Cloud --- # 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 %} Connect to Alibaba Cloud to collect metrics and logs from your Alibaba Cloud services. **Note**: Due to Alibaba Cloud's deprecation of Cloud Monitor support for Container Service metrics, you cannot collect metrics for clusters created after September 30, 2025. For more information, see the [Alibaba Cloud deprecation notice](https://www.alibabacloud.com/help/cms/cloudmonitor-1-0/product-overview/announcement-on-the-discontinuation-of-kubernetes-container-monitoring-feature-of-cloudmonitor). *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 %} ### Installation{% #installation %} Navigate to the [Datadog-Alibaba Cloud integration configuration tile](https://app.datadoghq.com/integrations/alibaba_cloud) and press *add account*. ### Configuration{% #configuration %} Fill out the following parameters to integrate Datadog with the Alibaba Cloud API: - **`Account Id`** Find this by hovering over the avatar on the top right of the Alibaba Cloud console and selecting *Security Settings*. The account ID is displayed on the top of that page. {% image source="https://docs.dd-static.net/images/integrations/alibaba_cloud/account_id_ac.eb578e45e50e5b42250c037ebd6a9ccb.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/integrations/alibaba_cloud/account_id_ac.eb578e45e50e5b42250c037ebd6a9ccb.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Account ID AC" /%} - **`Access Key Id`** & **`Access Key Secret`** In your Alibaba Cloud Account: 1. Ensure that [Resource Center](https://www.alibabacloud.com/help/resource-management/resource-center/product-overview/resource-center-overview) is enabled 1. Create a new user in the *RAM* tab with the following parameters: - `Logon Name`: Datadog - `display name`: Datadog - `description`: Datadog User for the Datadog-Alibaba Cloud integration 1. Select *Programmatic Access*: {% image source="https://docs.dd-static.net/images/integrations/alibaba_cloud/ac_programmatic_access.43cec1d2bcd8619fb73dc7c1783e0590.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/integrations/alibaba_cloud/ac_programmatic_access.43cec1d2bcd8619fb73dc7c1783e0590.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Programmatic access" /%} 1. After clicking *OK*, copy and paste the `AccessKeyID` and `AccessKeySecret` in the [Datadog-Alibaba Cloud integration tile](https://app.datadoghq.com/integrations/alibaba_cloud) and click *install integration*. {% image source="https://docs.dd-static.net/images/integrations/alibaba_cloud/ac_access_keys.3e465550d15171454b4944fdd9f418e1.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/integrations/alibaba_cloud/ac_access_keys.3e465550d15171454b4944fdd9f418e1.png?auto=format&fit=max&w=850&dpr=2 2x" alt="AC access keys" /%} 1. In your Alibaba Cloud Account, select `Add Permissions` for the user you just created, then 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), attach a custom policy with the following statement so Datadog can install the `ack-arms-prometheus` add-on on your clusters: ```json { "Version": "1", "Statement": [ { "Effect": "Allow", "Action": "cs:InstallClusterAddons", "Resource": "*" } ] } ``` 1. Press *Update*, and after around ~15 minutes, the metrics seen in the *Metrics* tab of the Datadog-Alibaba Cloud integration tile starts appearing in your [metric explorer page](https://app.datadoghq.com/metric/explorer) tagged with any custom tags you add to your resources and tags found here: - [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) 1. Optional - Set `Optionally Limit Metrics Collection` in your [Datadog-Alibaba Cloud integration tile](https://app.datadoghq.com/integrations/alibaba_cloud). This comma separated list of Alibaba Cloud tags (in the form ``) defines a filter to use when collecting metrics from Alibaba Cloud. Wildcards such as `?` (for single characters) and `*` (for multiple characters) can be used. Only hosts that match one of the defined labels are imported into Datadog—the rest are ignored. Hosts matching a given label can also be excluded by adding `!` before the label. ## Log collection{% #log-collection %} Datadog collects logs from [Alibaba Cloud Simple Log Service (SLS)](https://www.alibabacloud.com/help/en/sls/). After you enable log collection, Datadog ingests all available logs from SLS. ### Enable log collection{% #enable-log-collection %} In the [Datadog-Alibaba Cloud integration tile](https://app.datadoghq.com/integrations/alibaba_cloud), expand the **Log collection** section and toggle **Enable log collection** on. Logs from SLS appear in the [Log Explorer](https://app.datadoghq.com/logs) with the source `alibaba-cloud`. ### Filter logs by tag{% #filter-logs-by-tag %} By default, Datadog collects all available logs from SLS. To limit collection, use one or both of the optional filter fields under **Log collection**: - **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. #### Tag filter syntax{% #tag-filter-syntax %} The **Project tag filters** and **Logstore tag filters** fields accept comma-separated `key:value` Alibaba Cloud tags. Prefix a tag with `!` to negate it. The comma separator behaves differently depending on the tag types used: - **Positive tags only**: OR logic—included if the project or logstore has **any** of the listed tags. - **Negative tags only** (prefixed with `!`): OR logic—excluded if **any** of the negated tags is present. - **Mixed positive and negative tags**: AND logic—must satisfy **all** listed conditions to be included. Examples: - `datadog:monitored,env:prod*`: include if **either** tag is present. - `!env:staging,!testing:true`: exclude if **either** tag is present. - `datadog:monitored,!env:staging`: include only if the `datadog:monitored` tag is present **and** the `env:staging` tag is absent. ## Data Collected{% #data-collected %} ### Metrics{% #metrics %} **Note**: If you set up the Alibaba Cloud integration before December 2025, reconfigure it to collect metrics from these namespaces: `alibabacloud.kafka`, `alibabacloud.memcache`, `alibabacloud.mongodb`, `alibabacloud.oceanbase`. {% collapsible-section %} #### See the full list of metric namespaces | Integration | Metric namespace | | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Content Delivery Network (CDN) | [`alibabacloud.cdn`](https://www.alibabacloud.com/help/cdn/product-overview/what-is-alibaba-cloud-cdn) | | Container Service (deprecated for clusters created after September 30, 2025) | [`alibabacloud.container_service`](https://www.alibabacloud.com/help/cms/cloudmonitor-1-0/product-overview/announcement-on-the-discontinuation-of-kubernetes-container-monitoring-feature-of-cloudmonitor) | | Dynamic Content Delivery Network (DCDN) | [`alibabacloud.dcdn`](https://www.alibabacloud.com/help/dcdn/product-overview/what-is-dcdn) | | Elastic Compute Service (ECS) | [`alibabacloud.ecs`](https://www.alibabacloud.com/help/ecs/user-guide/what-is-ecs) | | Elastic IP Address (EIP) | [`alibabacloud.eip`](https://www.alibabacloud.com/help/eip/product-overview/what-is-eip) | | Express Connect | [`alibabacloud.express_connect`](https://www.alibabacloud.com/help/express-connect/product-overview/what-is-express-connect) | | ApsaraMQ for Kafka | [`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 | [`alibabacloud.memcache`](https://www.alibabacloud.com/help/memcache/product-overview/product-introduction) | | ApsaraDB for MongoDB | [`alibabacloud.mongodb`](https://www.alibabacloud.com/help/mongodb/product-overview/what-is-apsaradb-for-mongodb) | | NAT Gateway | [`alibabacloud.nat_gateway`](https://www.alibabacloud.com/help/nat-gateway/product-overview/what-is-nat-gateway) | | ApsaraDB for OceanBase | [`alibabacloud.oceanbase`](https://www.alibabacloud.com/help/apsaradb-for-oceanbase/latest/what-is-oceanbase-database) | | ApsaraDB RDS | [`alibabacloud.rds`](https://www.alibabacloud.com/help/rds/product-overview/what-is-apsaradb-rds-what-is-apsaradb-rds) | | Tair (Redis OSS-Compatible) | [`alibabacloud.redis`](https://www.alibabacloud.com/help/redis/product-overview/product-introduction) | | Server Load Balancer (SLB) | [`alibabacloud.slb`](https://www.alibabacloud.com/help/slb/product-overview/slb-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 %} - [Monitor Alibaba Cloud with Datadog](https://www.datadoghq.com/blog/monitor-alibaba-cloud-datadog/)