Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

亚马逊 ECS CloudWatch 指标

您可以使用亚马逊监控您的亚马逊 ECS 资源 CloudWatch，它收集来自 Amazon ECS 的原始数据并将其处理为可读的近乎实时的指标。这些统计数据会保存两周，以便您能够访问历史信息并更好地了解您的群集或服务的运行情况。亚马逊 ECS 指标数据会自动发送到 CloudWatch 以 1 分钟为周期。有关以下内容的更多信息 CloudWatch，请参阅亚马逊 CloudWatch 用户指南。

Amazon ECS 收集集群和服务的指标。你必须打开亚马逊 ECS CloudWatch 针对每项任务指标的容器见解，包括 CPU 和内存利用率。有关安装 Container Insights 的更多信息，请参阅 亚马逊 ECS CloudWatch 集装箱洞察。

使用 CloudWatch 指标

任何使用 Fargate 启动类型的亚马逊 ECS 服务都有 CloudWatch CPU 和内存利用率指标会自动执行，因此您无需执行任何手动步骤。

对于任何使用 EC2 启动类型的亚马逊 ECS 任务或服务，您的亚马逊 ECS 容器实例需要容器代理版本 1.4.0 或更高版本 (Linux) 或 1.0.0 或更高版本 (Windows) CloudWatch 指标。但是，我们建议使用最新的容器代理版本。有关检查您的代理版本并更新到最新版本的信息，请参阅更新 Amazon ECS 容器代理。

可靠指标的最低 Docker 版本是 Docker 版本 v20.10.13 及更高版本，该版本包含在亚马逊 ECS 优化的 AMI 20220607 及更高版本中。

如果您要手动启动代理（例如，如果您未对容器实例使用经 Amazon ECS 优化的 AMI），请参阅 手动更新 Amazon ECS 容器代理（适用于非经 Amazon ECS 优化的 AMI）。

您的 Amazon ECS 容器实例还需要对您用来启动容器实例的 IAM 角色的 ecs:StartTelemetrySession 权限。如果您之前创建了 Amazon ECS 容器实例角色 CloudWatch 有可用于 Amazon ECS 的指标，您可能需要添加此权限。有关检查 Amazon ECS 容器实例角色并为容器实例附加托管 IAM policy 的信息，请参阅 在 IAM 控制台中检查容器实例 (ecsInstanceRole)。

可用指标和维度

以下部分列出了 Amazon ECS 发送给亚马逊的指标和维度 CloudWatch。

统计数据概述

统计数据是指定时间段内的指标数据聚合。 CloudWatch 根据您的自定义数据提供的指标数据点或其他服务提供的指标数据点提供统计信息Amazon到 CloudWatch。聚合通过使用命名空间、指标名称、维度以及数据点度量单位在您指定的时间段内完成。下表介绍了可用的统计信息。

Amazon ECS 指标

Amazon ECS 为您提供了用来监控资源的指标。您可以将集群内的 CPU 和内存预留以及使用率作为一个整体进行监控，并监控集群中的各个服务的 CPU 和内存使用率。对于您的 GPU 工作负载，您可以度量集群中的 GPU 预留。

可用的指标将取决于集群中任务和服务的启动类型。如果您对服务使用 Fargate 启动类型，则会提供 CPU 和内存利用率指标以帮助监控您的服务。对于 EC2 启动类型，Amazon ECS 在集群和服务级别上提供 CPU、内存和 GPU 预留以及 CPU 和内存利用率指标。您需要单独监控构成底层基础设施的 Amazon EC2 实例。

亚马逊 ECS 将以下指标发送到 CloudWatch 每分钟。当 Amazon ECS 收集指标时，每分钟会收集多个数据点。然后将它们聚合成一个数据点，并将数据发送到 CloudWatch。所以在 CloudWatch，一个样本计数实际上是一分钟内多个数据点的聚合。

AWS/ECS 命名空间包括以下指标。

Amazon ECS 指标的维度

Amazon ECS 指标使用 AWS/ECS 命名空间并提供以下维度的指标。维度的指标仅反映一段时间内具有正在运行的任务的资源。例如，如果您的集群包含一个服务，但该服务没有处于 RUNNING 状态的任务，则不会向 CloudWatch 发送任何指标。如果您有两个服务，其中一个服务具有正在运行的任务，而另一个服务没有，则仅发送具有正在运行的任务的服务的指标。

集群预留

集群预留指标以所有 Amazon ECS 任务在某个集群上预留的 CPU、内存和 GPU 占已为该集群中每个活动容器实例注册的聚合 CPU、内存和 GPU 的百分比来度量。仅处于 ACTIVE 或 DRAINING 状态的容器实例将影响集群预留指标。此指标仅用于包含使用 EC2 启动类型的任务或服务的集群。包含使用 Fargate 启动类型的任务的集群不支持此指标。

                                  (Total CPU units reserved by tasks in cluster) x 100
Cluster CPU reservation =  --------------------------------------------------------------
                           (Total CPU units registered by container instances in cluster)

                                     (Total MiB of memory reserved by tasks in cluster x 100)
Cluster memory reservation =  ------------------------------------------------------------------
                              (Total MiB of memory registered by container instances in cluster)

                                     (Total GPUs reserved by tasks in cluster x 100)
Cluster GPU reservation =  ------------------------------------------------------------------
                              (Total GPUs registered by container instances in cluster)

当您在某个集群中运行某项任务时，Amazon ECS 将分析该集群的任务定义并预留在该集群的容器定义中指定的聚合 CPU 单元数、内存 MiB 数和 GPU 数。Amazon ECS 每分钟都会计算当前为在该集群中运行的每个任务预留的 CPU 单元数、内存 MiB 数和 GPU 数。计算出为集群上运行的所有任务预留的 CPU、内存和 GPU 的总量，并将这些数字报告给 CloudWatch 占集群注册资源总额的百分比。如果您指定软限制 (memoryReservation) 在任务定义中，它用于计算预留内存量。否则将使用硬限制 (memory)。集群中任务预留的总内存量 MiB 还包括临时文件系统 (tmpfs) 卷大小和sharedMemorySize如果在任务定义中定义。有关硬限制和软限制、共享内存大小以及 tmpfs 卷大小的更多信息，请参见任务定义参数。

例如，某个集群注册了两个活动容器实例：一个 c4.4xlarge 实例和一个 c4.large 实例。c4.4xlarge 实例在集群中注册了 16,384 个 CPU 单元和 30,158 MiB 内存。c4.large 实例注册了 2,048 个 CPU 单元和 3,768 MiB 内存。此集群的聚合资源为 18,432 个 CPU 单元和 33,926 MiB 内存。

如果某个任务定义预留了 1024 个 CPU 单元和 2048 MiB 内存，并且在此集群上启动了 10 个使用此任务定义的任务（当前没有运行其他任务），则总共将预留 10240 个 CPU 单元和 20480 MiB 内存。这已报告给 CloudWatch 为集群预留了 55% 的 CPU 和 60% 的内存预留。

下图显示了在某个集群中注册的 CPU 单元总数，以及它们的预留和利用率对现有任务和新任务放置的意义。较低的（已保留，已使用）和中心（已保留，未使用）块表示为集群上正在运行的现有任务预留的 CPU 单位总数，或者CPUReservation CloudWatch 公制。下方块表示正在运行的任务在集群上实际使用的预留 CPU 单元，或者CPUUtilization CloudWatch 公制。上面的块表示现有任务未预留的 CPU 单元数；这些 CPU 单元可用于新任务放置。现有任务如果对 CPU 资源的需求增加，也可以使用这些未预留 CPU 单元。有关更多信息，请参阅 cpu 任务定义参数文档。

集群利用率

集群利用率以所有 Amazon ECS 任务在某个集群上使用的 CPU 和内存占为该集群中每个活动容器实例注册的聚合 CPU 和内存的百分比的形式来度量。仅处于 ACTIVE 或 DRAINING 状态的容器实例将影响集群利用率指标。不支持 GPU 利用率指标，因为它无法过度使用 GPU。此指标仅用于包含使用 EC2 启动类型的任务或服务的集群。包含使用 Fargate 启动类型的任务的集群不支持此指标。

                                  (Total CPU units used by tasks in cluster) x 100
Cluster CPU utilization =  --------------------------------------------------------------
                           (Total CPU units registered by container instances in cluster)

                                     (Total MiB of memory used by tasks in cluster x 100)
Cluster memory utilization =  ------------------------------------------------------------------
                              (Total MiB of memory registered by container instances in cluster)

每个容器实例上的 Amazon ECS 容器代理每分钟都会计算当前用于该容器实例上正在运行的每个任务的 CPU 单元数和内存 MiB 数，并将此信息报告回 。它还会计算用于在该集群上运行的所有任务的 CPU 和内存的总量，并将这些数字以占该集群的总注册资源数的百分比的形式报告给 CloudWatch 。

例如，某个集群注册了两个活动容器实例：一个 c4.4xlarge 实例和一个 c4.large 实例。c4.4xlarge 实例在集群中注册了 16,384 个 CPU 单元和 30,158 MiB 内存。c4.large 实例注册了 2,048 个 CPU 单元和 3,768 MiB 内存。此集群的聚合资源为 18,432 个 CPU 单元和 33,926 MiB 内存。

如果有 10 个任务正在此集群上运行，并且每个任务使用 1024 个 CPU 单元和 2048 MiB 内存，则该集群上总共使用了 10240 个 CPU 单元和 20480 MiB 内存。这已报告给 CloudWatch 为集群的 55% 的 CPU 利用率和 60% 的内存使用率。

服务利用率

服务利用率以属于集群上某个服务的 Amazon ECS 任务使用的 CPU 和内存占该服务的任务定义中指定的 CPU 和内存的百分比的形式来度量。具有使用 EC2 和 Fargate 启动类型的任务的服务支持此指标。

                                      (Total CPU units used by tasks in service) x 100
Service CPU utilization =  ----------------------------------------------------------------------------
                           (Total CPU units specified in task definition) x (number of tasks in service)

                                         (Total MiB of memory used by tasks in service) x 100
Service memory utilization =  --------------------------------------------------------------------------------
                              (Total MiB of memory specified in task definition) x (number of tasks in service)

每分钟，与每个容器实例上的的 Amazon ECS 容器代理都会计算当前用于该容器实例上运行的服务所拥有的每个任务的 CPU 单元数和内存 MiB 数，并将此信息报告回 Amazon ECS。它还将计算用于由该服务拥有且正在该集群上运行的所有任务的 CPU 和内存的总量，并将这些数字以占在该服务的任务定义中为该服务指定的总资源的百分比的形式报告给 CloudWatch 。如果您指定软限制 (memoryReservation)，它用于计算预留内存量。否则将使用硬限制 (memory)。有关软限制和硬限制的更多信息，请参阅任务定义参数。

例如，某个服务的任务定义为其所有容器总共指定了 512 个 CPU 单元和 1,024 MiB 内存 (带硬限制 memory 参数)。该服务需要有 1 个正在运行的任务，并且该服务在一个包含 1 个 c4.large 容器实例 (具有 2,048 个 CPU 单元和 3,768 MiB 总内存) 的集群上运行，该集群上没有其他正在运行的任务。尽管该任务指定了 512 个 CPU 单元，但由于它是具有 2048 个 CPU 单元的容器实例上唯一一个正在运行的任务，它最多可以使用指定数量的四倍的资源 (2048/512)。但是，1024 MiB 的指定内存量是一个它无法超出的硬限制，因此在这种情况下，服务内存利用率不能超过 100%。

如果上述示例使用了软限制 memoryReservation 而不是硬限制 memory 参数，则该服务的任务可以根据需要使用超出指定的 1024MiB 的内存量。在这种情况下，该服务的内存利用率可能会超过 100%。

如果您的应用程序的内存利用率在短时间内突然激增，您将不会看到服务内存利用率增加，因为 Amazon ECS 每分钟收集多个数据点，然后将它们聚合到一个数据点并发送到 CloudWatch。

如果该任务在某个时间段内执行 CPU 密集型工作并且用尽了 2048 个可用 CPU 单元和 512 MiB 内存，则服务将报告 400% CPU 利用率和 50% 内存利用率。如果该任务处于空闲状态且使用了 128 个 CPU 单元和 128 MiB 内存，则服务将报告 25% CPU 利用率和 12.5% 内存利用率。

服务 RUNNING 任务计数

你可以用 CloudWatch 用于查看服务中任务数量的指标RUNNING州。例如，你可以设置一个 CloudWatch 当您的服务中正在运行的任务数量低于指定值时，该指标会发出警报。

服务RUNNING亚马逊 ECS 中的任务数 CloudWatch 集装箱洞察

“正在运行的任务数” (RunningTaskCount) 当您使用 Amazon ECS 时，每个集群和每项服务都可使用指标 CloudWatch 容器见解。您可以通过选择加入容器见解来创建的所有新集群containerInsights账户设置，通过在创建集群期间在单个集群上开启集群设置，或者在现有集群上使用 UpdateClusterSettings API。收集的指标由 CloudWatch 容器见解按自定义指标收费。有关以下内容的更多信息 CloudWatch 定价，请参阅CloudWatch 定价。

要查看此指标，请参阅亚马逊 ECS 容器洞察指标在亚马逊 CloudWatch 用户指南。

来自 Amazon ECS 提供的指标的服务 RUNNING 任务计数

但是，Amazon ECS 会提供监控指标，无需额外费用。要使用这些指标来计算正在运行的任务，请按照以下步骤操作 CloudWatch 控制台。