---
title: Alibaba Cloud ESS
description: >-
  Monitor Alibaba Cloud Auto Scaling (ESS) capacity and instance counts across
  your scaling groups.
breadcrumbs: Docs > Integrations > Alibaba Cloud ESS
---

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

# Alibaba Cloud ESS
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 Auto Scaling (ESS)](https://www.alibabacloud.com/product/auto-scaling) automatically adjusts computing resources based on your workload's usage patterns and predefined scaling rules, adding or removing ECS instances to match demand.

Use this integration to monitor scaling group capacity, instance counts by state, type, and zone, and desired capacity for your Auto Scaling groups by collecting metrics from the `alibabacloud.ess` namespace.

## Setup{% #setup %}

### Installation{% #installation %}

After you set up the [Alibaba Cloud](https://docs.datadoghq.com/integrations/alibaba_cloud.md) integration, metrics for ESS are collected automatically.

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

### Metrics{% #metrics %}

|  |
|  |
| **alibabacloud.ess.desired_capacity.average**(gauge)                                | Average desired number of instances in the scaling group.*Shown as instance*                   |
| **alibabacloud.ess.desired_capacity.minimum**(gauge)                                | Minimum desired number of instances in the scaling group.*Shown as instance*                   |
| **alibabacloud.ess.desired_capacity.maximum**(gauge)                                | Maximum desired number of instances in the scaling group.*Shown as instance*                   |
| **alibabacloud.ess.instance_count_agg_by_instance_charge_type.average**(gauge) | Average distribution of instance counts by billing method.*Shown as instance*                  |
| **alibabacloud.ess.instance_count_agg_by_instance_charge_type.maximum**(gauge) | Maximum distribution of instance counts by billing method.*Shown as instance*                  |
| **alibabacloud.ess.instance_count_agg_by_instance_charge_type.minimum**(gauge) | Minimum distribution of instance counts by billing method.*Shown as instance*                  |
| **alibabacloud.ess.instance_count_agg_by_instance_type.average**(gauge)         | Average distribution of instance counts by instance type.*Shown as instance*                   |
| **alibabacloud.ess.instance_count_agg_by_instance_type.maximum**(gauge)         | Maximum distribution of instance counts by instance type.*Shown as instance*                   |
| **alibabacloud.ess.instance_count_agg_by_instance_type.minimum**(gauge)         | Minimum distribution of instance counts by instance type.*Shown as instance*                   |
| **alibabacloud.ess.instance_count_agg_by_zone.average**(gauge)                   | Average distribution of instance counts by availability zone.*Shown as instance*               |
| **alibabacloud.ess.instance_count_agg_by_zone.maximum**(gauge)                   | Maximum distribution of instance counts by availability zone.*Shown as instance*               |
| **alibabacloud.ess.instance_count_agg_by_zone.minimum**(gauge)                   | Minimum distribution of instance counts by availability zone.*Shown as instance*               |
| **alibabacloud.ess.max_instance_count.average**(gauge)                             | Maximum number of instances allowed in the scaling group.*Shown as instance*                   |
| **alibabacloud.ess.max_instance_count.minimum**(gauge)                             | Maximum number of instances allowed in the scaling group.*Shown as instance*                   |
| **alibabacloud.ess.max_instance_count.maximum**(gauge)                             | Maximum number of instances allowed in the scaling group.*Shown as instance*                   |
| **alibabacloud.ess.min_instance_count.average**(gauge)                             | Minimum number of instances allowed in the scaling group.*Shown as instance*                   |
| **alibabacloud.ess.min_instance_count.minimum**(gauge)                             | Minimum number of instances allowed in the scaling group.*Shown as instance*                   |
| **alibabacloud.ess.min_instance_count.maximum**(gauge)                             | Minimum number of instances allowed in the scaling group.*Shown as instance*                   |
| **alibabacloud.ess.pending_instance_count.average**(gauge)                         | Average number of instances currently being added to the scaling group.*Shown as instance*     |
| **alibabacloud.ess.pending_instance_count.minimum**(gauge)                         | Minimum number of instances currently being added to the scaling group.*Shown as instance*     |
| **alibabacloud.ess.pending_instance_count.maximum**(gauge)                         | Maximum number of instances currently being added to the scaling group.*Shown as instance*     |
| **alibabacloud.ess.removing_instance_count.average**(gauge)                        | Average number of instances currently being removed from the scaling group.*Shown as instance* |
| **alibabacloud.ess.removing_instance_count.minimum**(gauge)                        | Minimum number of instances currently being removed from the scaling group.*Shown as instance* |
| **alibabacloud.ess.removing_instance_count.maximum**(gauge)                        | Maximum number of instances currently being removed from the scaling group.*Shown as instance* |
| **alibabacloud.ess.running_instance_count.average**(gauge)                         | Average number of running instances in the scaling group.*Shown as instance*                   |
| **alibabacloud.ess.running_instance_count.minimum**(gauge)                         | Minimum number of running instances in the scaling group.*Shown as instance*                   |
| **alibabacloud.ess.running_instance_count.maximum**(gauge)                         | Maximum number of running instances in the scaling group.*Shown as instance*                   |
| **alibabacloud.ess.total_instance_count.average**(gauge)                           | Average total number of instances in the scaling group.*Shown as instance*                     |
| **alibabacloud.ess.total_instance_count.minimum**(gauge)                           | Minimum total number of instances in the scaling group.*Shown as instance*                     |
| **alibabacloud.ess.total_instance_count.maximum**(gauge)                           | Maximum total number of instances in the scaling group.*Shown as instance*                     |

### Events{% #events %}

The Alibaba Cloud ESS integration does not include any events.

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

The Alibaba Cloud ESS integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

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