Alibaba Cloud

Overview

Use the Alibaba Cloud integration 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 section on our website.

Setup

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

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

Enable Resource Center in your Alibaba Cloud account.
In Resource Access Management (RAM), create a user with the following values:
- User Login Name: Datadog
- Display Name: Datadog
Select Permanent AccessKey.
Copy the AccessKey ID and AccessKey secret, and paste them in the corresponding Datadog account form fields.
For the new user, select Add Permissions and add the following system policy:
```
ReadOnlyAccess
```
To collect Container Service for Kubernetes (ACK) metrics using Managed Service for Prometheus, also attach a custom policy that allows Datadog to install the ack-arms-prometheus add-on on your clusters:
```
{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "cs:InstallClusterAddons",
      "Resource": "*"
    }
  ]
}
```
Select Update. After approximately 15 minutes, metrics appear in Metric Explorer. Metrics are tagged with custom tags on your resources and with tags returned by the following APIs:

Account tags

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

Note: The filters below evaluate tags assigned in your Alibaba Cloud environment.

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

Toggle Collect logs to collect logs from Alibaba Cloud Simple Log Service (SLS). Logs from SLS appear in the Log Explorer 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

Toggle Collect resources to collect your Alibaba Cloud resources. Resources are visible in the Datadog Resource Catalog.

Data Collected

Metrics

See the full list of metric namespaces

Integration	Metric namespace
Application Load Balancer (ALB)	`alibabacloud.alb`
AnalyticDB for MySQL	`alibabacloud.analyticdb_for_mysql`
Content Delivery Network (CDN)	`alibabacloud.cdn`
Container Service	`alibabacloud.container_service`
Dynamic Content Delivery Network (DCDN)	`alibabacloud.dcdn`
Elastic Block Storage (EBS)	`alibabacloud.ebs`
Elastic Compute Service (ECS)	`alibabacloud.ecs`
Elastic IP Address (EIP)	`alibabacloud.eip`
Elasticsearch	`alibabacloud.elasticsearch`
Edge Security Acceleration (ESA)	`alibabacloud.esa`
Auto Scaling (ESS)	`alibabacloud.ess`
EventBridge	`alibabacloud.eventbridge`
Express Connect	`alibabacloud.express_connect`
Realtime Compute for Apache Flink	`alibabacloud.flink`
Function Compute	`alibabacloud.function_compute`
IP Address Manager (IPAM)	`alibabacloud.ipam`
ApsaraMQ for Kafka	`alibabacloud.kafka`
Key Management Service (KMS)	`alibabacloud.kms`
ApsaraDB for Memcache	`alibabacloud.memcache`
ApsaraDB for MongoDB	`alibabacloud.mongodb`
File Storage NAS	`alibabacloud.nas`
NAT Gateway	`alibabacloud.nat_gateway`
Network Load Balancer (NLB)	`alibabacloud.nlb`
ApsaraDB for OceanBase	`alibabacloud.oceanbase`
Object Storage Service (OSS)	`alibabacloud.oss`
PolarDB	`alibabacloud.polardb`
ApsaraDB RDS	`alibabacloud.rds`
Tair (Redis OSS-Compatible)	`alibabacloud.redis`
ApsaraMQ for RocketMQ	`alibabacloud.rocketmq`
Server Load Balancer (SLB)	`alibabacloud.slb`
Simple Message Queue (SMQ)	`alibabacloud.smq`
Tair	`alibabacloud.tair`
Virtual Private Cloud (VPC)	`alibabacloud.vpc`
VPN Gateway	`alibabacloud.vpn_gateway`
Web Application Firewall (WAF)	`alibabacloud.waf`