---
title: ECS Service Deployment
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > DDSQL Reference > Data Directory > ECS Service Deployment
---

# ECS Service Deployment

ECS Service Deployment in AWS represents the details of a deployment within an Amazon ECS service. It tracks information such as the deployment ID, status, desired and running task counts, launch type, and configuration details. This resource helps manage and monitor how new versions of a service are rolled out, ensuring controlled updates and maintaining availability during changes.

```
aws.ecs_service_deployment
```

## Fields

| Title                      | ID   | Type       | Data Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Description |
| -------------------------- | ---- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| _key                       | core | string     |
| account_id                 | core | string     |
| alarms                     | core | json       | The CloudWatch alarms that determine when a service deployment fails.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| capacity_provider_strategy | core | json       | The capacity provider strategy that are associated with the task set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| cluster_arn                | core | string     | The ARN of the cluster that hosts the service.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| computed_desired_count     | core | int64      | The computed desired count for the task set. This is calculated by multiplying the service's <code>desiredCount</code> by the task set's <code>scale</code> percentage. The result is always rounded up. For example, if the computed desired count is 1.2, it rounds up to 2 tasks.                                                                                                                                                                                                                                                                                                                                                                                                    |
| created_at                 | core | timestamp  | The time the service deployment was created. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| deployment_circuit_breaker | core | json       | The circuit breaker configuration that determines a service deployment failed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| deployment_configuration   | core | json       | Optional deployment parameters that control how many tasks run during a deployment and the ordering of stopping and starting tasks.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| fargate_ephemeral_storage  | core | json       | The Fargate ephemeral storage settings for the task set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| finished_at                | core | timestamp  | The time the service deployment finished. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| id                         | core | string     | The ID of the task set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| launch_type                | core | string     | The launch type the tasks in the task set are using. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html">Amazon ECS launch types</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.                                                                                                                                                                                                                                                                                                                                                                                                                      |
| load_balancers             | core | json       | Details on a load balancer that are used with a task set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| network_configuration      | core | json       | The network configuration for the task set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| pending_count              | core | int64      | The number of tasks in the task set that are in the <code>PENDING</code> status during a deployment. A task in the <code>PENDING</code> state is preparing to enter the <code>RUNNING</code> state. A task set enters the <code>PENDING</code> status when it launches for the first time or when it's restarted after being in the <code>STOPPED</code> state.                                                                                                                                                                                                                                                                                                                         |
| platform_family            | core | string     | The operating system that your tasks in the set are running on. A platform family is specified only for tasks that use the Fargate launch type. All tasks in the set must have the same value.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| platform_version           | core | string     | The Fargate platform version where the tasks in the task set are running. A platform version is only specified for tasks run on Fargate. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html">Fargate platform versions</a> in the <i>Amazon Elastic Container Service Developer Guide</i>.                                                                                                                                                                                                                                                                                                                           |
| rollback                   | core | json       | The rollback options the service deployment uses when the deployment fails.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| running_count              | core | int64      | The number of tasks in the task set that are in the <code>RUNNING</code> status during a deployment. A task in the <code>RUNNING</code> state is running and ready for use.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| scale                      | core | json       | A floating-point percentage of your desired number of tasks to place and keep running in the task set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| service_arn                | core | string     | The ARN of the service for this service deployment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| service_deployment_arn     | core | string     | The ARN of the service deployment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| service_registries         | core | json       | The details for the service discovery registries to assign to this task set. For more information, see <a href="https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html">Service discovery</a>.                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| source_service_revisions   | core | json       | The currently deployed workload configuration.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| stability_status           | core | string     | The stability status. This indicates whether the task set has reached a steady state. If the following conditions are met, the task set are in <code>STEADY_STATE</code>: <ul> <li> The task <code>runningCount</code> is equal to the <code>computedDesiredCount</code>. </li> <li> The <code>pendingCount</code> is <code>0</code>. </li> <li> There are no tasks that are running on container instances in the <code>DRAINING</code> status. </li> <li> All tasks are reporting a healthy status from the load balancers, service discovery, and container health checks. </li> </ul> If any of those conditions aren't met, the stability status returns <code>STABILIZING</code>. |
| stability_status_at        | core | timestamp  | The Unix timestamp for the time when the task set stability status was retrieved.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| started_at                 | core | timestamp  | The time the service deployment statred. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| started_by                 | core | string     | The tag specified when a task set is started. If an CodeDeploy deployment created the task set, the <code>startedBy</code> parameter is <code>CODE_DEPLOY</code>. If an external deployment created the task set, the <code>startedBy</code> field isn't used.                                                                                                                                                                                                                                                                                                                                                                                                                          |
| status                     | core | string     | The service deployment state.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| status_reason              | core | string     | Information about why the service deployment is in the current status. For example, the circuit breaker detected a failure.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| stopped_at                 | core | timestamp  | The time the service deployment stopped. The format is yyyy-MM-dd HH:mm:ss.SSSSSS. The service deployment stops when any of the following actions happen: A user manually stops the deployment The rollback option is not in use for the failure detection mechanism (the circuit breaker or alarm-based) and the service fails.                                                                                                                                                                                                                                                                                                                                                        |
| tags                       | core | hstore_csv |
| target_service_revision    | core | json       | The workload configuration being deployed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| task_definition            | core | string     | The task definition that the task set is using.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| task_set_arn               | core | string     | The Amazon Resource Name (ARN) of the task set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| updated_at                 | core | timestamp  | The time that the service deployment was last updated. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
