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. An Amazon ECS task definition is a text file in JSON format that specifies the parameters for your application.

To monitor this entity, Set up Cisco AppDynamics Cloud Collectors to Monitor AWS or Set up the Cisco AppDynamics Infrastructure Collector to Monitor AWS.

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 task definition:

  1. Navigate to the Observe page.
  2. Under Containers, click AWS ECS Task Definitions. The list view now displays.
  3. Click an ECS task definition 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 task definitions. See Amazon ECS Container Insights metrics.

Display NameSource MetricDescription
CPU Utilized

CPUUtilized

The CPU units used by tasks in the resource that is specified by the dimension set that you're using.

This metric is collected only for tasks that have a defined CPU reservation in their task definition.

Memory Utilization (%)MemoryUtilized

The memory being used by tasks in the resource that is specified by the dimension set that you're using.

This metric is collected only for tasks that have a defined memory reservation in their task definition.

Memory Utilized Vs Memory Reserved (MiB)
  • MemoryUtilized 
  • MemoryReserved 
The memory used by tasks in the cluster compared to the 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.
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.
Storage Read/Write (KiB)
  • StorageWriteBytes
  • StorageReadBytes
The number of KiB read from and written to storage in the cluster.
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.

Properties (Attributes)

Cisco Cloud Observability displays the following properties for ECS task definitions.

Display NameProperty Name

Description

ECS Task Definition ARN aws.ecs_task_definition.arnThe Amazon Resource Name (ARN) of the task definition.
ECS Task Definition Nameaws.ecs_task_definition.nameThe name of the task definition.
Revision aws.ecs_task_definition.revision

The revision of the task in a particular family.

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.