# Source: https://docs.datadoghq.com/ddsql_reference/data_directory/aws/aws.ecs_service.dataset.md

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

# ECS Service

ECS Service in AWS manages the long-running tasks of an application on Amazon Elastic Container Service. It ensures that the desired number of container instances are running and automatically replaces unhealthy tasks. ECS Service supports load balancing, service discovery, and scaling, making it easier to run containerized applications reliably and at scale.

```
aws.ecs_service
```

## Fields

| Title                             | ID   | Type       | Data Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Description |
| --------------------------------- | ---- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| _key                              | core | string     |
| account_id                        | core | string     |
| availability_zone_rebalancing     | core | string     | Indicates whether to use Availability Zone rebalancing for the service. For more information, see Balancing an Amazon ECS service across Availability Zones in the Amazon Elastic Container Service Developer Guide . The default behavior of AvailabilityZoneRebalancing differs between create and update requests: For create service requests, when no value is specified for AvailabilityZoneRebalancing, Amazon ECS defaults the value to ENABLED. For update service requests, when no value is specified for AvailabilityZoneRebalancing, Amazon ECS defaults to the existing service's AvailabilityZoneRebalancing value. If the service never had an AvailabilityZoneRebalancing value set, Amazon ECS treats this as DISABLED.                                                                                             |
| capacity_provider_strategy        | core | json       | The capacity provider strategy the service uses. When using the DescribeServices API, this field is omitted if the service was created using a launch type.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| cluster_arn                       | core | string     | The Amazon Resource Name (ARN) of the cluster that hosts the service.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| created_at                        | core | timestamp  | The Unix timestamp for the time when the service was created.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| created_by                        | core | string     | The principal that created the service.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| deployment_configuration          | core | json       | Optional deployment parameters that control how many tasks run during the deployment and the ordering of stopping and starting tasks.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| deployment_controller             | core | json       | The deployment controller type the service is using.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| deployments                       | core | json       | The current state of deployments for the service.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| desired_count                     | core | int64      | The desired number of instantiations of the task definition to keep running on the service. This value is specified when the service is created with CreateService , and it can be modified with UpdateService.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| enable_ecs_managed_tags           | core | bool       | Determines whether to use Amazon ECS managed tags for the tasks in the service. For more information, see Tagging Your Amazon ECS Resources in the Amazon Elastic Container Service Developer Guide.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| enable_execute_command            | core | bool       | Determines whether the execute command functionality is turned on for the service. If true, the execute command functionality is turned on for all containers in tasks as part of the service.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| events                            | core | json       | The event stream for your service. A maximum of 100 of the latest events are displayed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| health_check_grace_period_seconds | core | int64      | The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing, VPC Lattice, and container health checks after a task has first started. If your service has more running tasks than desired, unhealthy tasks in the grace period might be stopped to reach the desired count.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| launch_type                       | core | string     | The launch type the service is using. When using the DescribeServices API, this field is omitted if the service was created using a capacity provider strategy.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| load_balancers                    | core | json       | A list of Elastic Load Balancing load balancer objects. It contains the load balancer name, the container name, and the container port to access from the load balancer. The container name is as it appears in a container definition.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| network_configuration             | core | json       | The VPC subnet and security group configuration for tasks that receive their own elastic network interface by using the awsvpc networking mode.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| pending_count                     | core | int64      | The number of tasks in the cluster that are in the PENDING state.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| placement_constraints             | core | json       | The placement constraints for the tasks in the service.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| placement_strategy                | core | json       | The placement strategy that determines how tasks for the service are placed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| platform_family                   | core | string     | The operating system that your tasks in the service run on. A platform family is specified only for tasks using the Fargate launch type. All tasks that run as part of this service must use the same platformFamily value as the service (for example, LINUX).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| platform_version                  | core | string     | The platform version to run your service on. A platform version is only specified for tasks that are hosted on Fargate. If one isn't specified, the LATEST platform version is used. For more information, see Fargate Platform Versions in the Amazon Elastic Container Service Developer Guide.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| propagate_tags                    | core | string     | Determines whether to propagate the tags from the task definition or the service to the task. If no value is specified, the tags aren't propagated.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| role_arn                          | core | string     | The ARN of the IAM role that's associated with the service. It allows the Amazon ECS container agent to register container instances with an Elastic Load Balancing load balancer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| running_count                     | core | int64      | The number of tasks in the cluster that are in the RUNNING state.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| scheduling_strategy               | core | string     | The scheduling strategy to use for the service. For more information, see Services. There are two service scheduler strategies available. REPLICA-The replica scheduling strategy places and maintains the desired number of tasks across your cluster. By default, the service scheduler spreads tasks across Availability Zones. You can use task placement strategies and constraints to customize task placement decisions. DAEMON-The daemon scheduling strategy deploys exactly one task on each active container instance. This task meets all of the task placement constraints that you specify in your cluster. The service scheduler also evaluates the task placement constraints for running tasks. It stop tasks that don't meet the placement constraints. Fargate tasks don't support the DAEMON scheduling strategy. |
| service_arn                       | core | string     | The ARN that identifies the service. For more information about the ARN format, see Amazon Resource Name (ARN) in the Amazon ECS Developer Guide.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| service_name                      | core | string     | The name of your service. Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed. Service names must be unique within a cluster. However, you can have similarly named services in multiple clusters within a Region or across multiple Regions.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| service_registries                | core | json       | The details for the service discovery registries to assign to this service. For more information, see Service Discovery.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| status                            | core | string     | The status of the service. The valid values are ACTIVE, DRAINING, or INACTIVE.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| tags                              | core | hstore_csv |
| task_definition                   | core | string     | The task definition to use for tasks in the service. This value is specified when the service is created with CreateService, and it can be modified with UpdateService.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| task_sets                         | core | json       | Information about a set of Amazon ECS tasks in either an CodeDeploy or an EXTERNAL deployment. An Amazon ECS task set includes details such as the desired number of tasks, how many tasks are running, and whether the task set serves production traffic.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |