Amazon Elastic Container Service (Amazon ECS) is a scalable container management service that can be used to run, stop, and manage containers on a cluster. You can use an Amazon ECS service to run and maintain your desired number of tasks simultaneously in an Amazon ECS cluster.

To monitor this entity, Set up Cisco AppDynamics Cloud Collectors to Monitor AWS or Set up the Cisco AppDynamics Infrastructure Collector to Monitor AWS. Metric availability will vary depending on the collector that you use. 

Cisco Cloud Observability displays AWS entities on the Observe page. Metrics are displayed for specific entity instances in the list and detail views.

This document contains references to third-party documentation. Splunk AppDynamics does not own any rights and assumes no responsibility for the accuracy or completeness of such third-party documentation.

Detail View

To display the detail view for an Amazon ECS service:

  1. Navigate to the Observe page.
  2. Under Containers, click AWS ECS Services.
    The list view now displays.
  3. Click an ECS service Name to display the detail view.
    The detail view displays metrics, key performance indicators, and properties (attributes) related to the instance you selected.

Metrics and Key Performance Indicators

Cisco Cloud Observability displays the following metrics and key performance indicators (KPIs) for ECS services. See Amazon ECS Container Insights metrics.

Metric availability will vary depending on whether you have an Elastic Compute Cloud (EC2) or Fargate deployment as well as their configurations. The Deployment column below denotes the deployment(s) where each metric is available.

Display NameSource MetricDescriptionDeployment
Task Counts 
  • PendingTaskCount
  • RunningTaskCount
  • DeploymentCount
  • DesiredTaskCount
  • TaskSetCount
  • The number of tasks currently in the PENDING state.
  • The number of tasks currently in the RUNNING state.
  • The number of deployments in an Amazon ECS service.
  • The desired number of tasks for an Amazon ECS service.
  • The number of task sets in the service.
EC2, Fargate
CPU Utilized (%)CPUUtilized

The CPU units used by the tasks in the cluster. This metric is only collected for tasks that have a defined CPU reservation in their task definition.

EC2, Fargate
Memory Utilization (%)MemoryUtilized

The memory used by tasks in the cluster. This metric is only collected for tasks that have a defined memory reservation in their task definition.

EC2, Fargate
Memory Utilized Vs Memory Reserved (MiB)MemoryUtilizedThe memory used by tasks in the cluster. This metric is only collected for tasks that have a defined memory reservation in their task definition.EC2, Fargate
MemoryReservedThe memory that is reserved by tasks in the cluster. This metric is collected only for tasks that have a defined memory reservation in their task definition.EC2, Fargate
Network Throughput (KiB/Sec)
  • NetworkTXBytes
  • NetworkRXBytes
The number of KiB received and transmitted by the cluster. This metric is only available for containers in tasks that use the awsvpc or bridge network modes.Fargate
Storage Read/Write (KiB)
  • StorageReadBytes
  • StorageWriteBytes
The number of KiB read from and written to storage in the cluster.Fargate
Ephemeral Storage Reserved (GiB)EphemeralStorageReserved

The number of bytes reserved from ephemeral storage in the resource specified by the dimensions you're using. Ephemeral storage is used for the container root filesystem and any bind mount host volumes defined in the container image and task definition. The amount of ephemeral storage cannot be changed in a running task.

This metric is only available for tasks that run on Amazon ECS Fargate Linux platform version >=1.4.0.

EC2, Fargate

Properties (Attributes)

Cisco Cloud Observability displays the following properties for ECS services.

Display NameProperty Name

Description

Service Nameaws.ecs_service.nameThe name of the service.
Service ARNaws.ecs.service.arnThe Amazon Resource Name (ARN) that identifies the service.
Service Launch Typeaws.ecs.service.launch.typeThe launch type used by the service.
Service Load Balancersaws.ecs.service.load_balancersA list of Elastic Load Balancing load balancer names.
Service Scheduling Strategyaws.ecs.service.scheduling_strategyThe scheduling strategy used for the service.
Service Created Ataws.ecs_service.created_atThe Unix timestamp for the time that the service was created.
Service Platform Version aws.ecs_service.platform.versionThe platform version to run your service on.

Retention and Purge Time-To-Live (TTL)

For all cloud and infrastructure entities, the retention TTL is 180 minutes (3 hours) and the purge TTL is 525,600 minutes (365 days). 

Amazon Web Services, the AWS logo, AWS, and any other AWS Marks used in these materials are trademarks of Amazon.com, Inc. or its affiliates in the United States and/or other countries.