

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon ECS Container Insights 指標
<a name="Container-Insights-metrics-ECS"></a>

Container Insights 指標可提供額外的網路、儲存和暫時性儲存指標。這些指標可提供比標準 Amazon ECS 指標更多的資訊。Container Insights 可與 CloudWatch Logs 整合。可以建立指標變更與日誌項目的關聯，以便更輕鬆地進行疑難排解。Container Insights 也會透過在所有任務中平均資料，顯示叢集、服務和精靈整體統計資料。這可讓您更清楚了解服務和協助程式運作狀態，協助環境監控和容量規劃。

**使用案例**
+ **問題識別和疑難排解**：透過分析任務狀態轉換模式來追蹤失敗的部署，從而快速確定故障點。透過全面檢查任務啟動序列和初始化行為來診斷組態問題
+ **叢集和服務層級運作狀態評估**：顯示叢集的平均任務效能。這種方法可調節異常值，以提供更穩定的叢集和服務運作狀態檢視。使用這些洞見進行一般服務監控，因為極端值可能會產生誤導 
+ **服務可用性問題**：透過監控執行中的任務計數指標來偵測部署失敗。將服務事件日誌與效能指標建立關聯，以了解基礎設施影響。追蹤任務重新啟動模式，以確定不穩定的服務或基礎設施問題
+ **平均負載的容量規劃**：它有助於根據典型任務行為模式確定資源需求，提供一致的指標以支援有效的長期規劃，並減少短期尖峰對容量決策的影響
+ **提供其他指標**：收集付費指標中無法使用的其他網路、儲存和暫時性儲存指標

如需 Amazon ECS 指標的詳細資訊，請參閱 [Amazon ECS 服務使用率指標使用案例](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service_utilization-metrics-explanation.html)，以及具有增強可觀測性的 Container Insights 的資訊 ([具有增強可觀測性指標的 Amazon ECS Container Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Container-Insights-enhanced-observability-metrics-ECS.html))。

**注意**  
Amazon ECS 受管協助程式指標使用與服務指標相同的`ECS/ContainerInsights`命名空間和`ServiceName`維度。對於協助程式指標，`ServiceName`維度值使用格式 `daemon:{{daemon-name}}`。例如，名為 的協助程式`my-daemon`的`ServiceName`維度值為 `daemon:my-daemon`。下表中包含`ServiceName`維度的所有指標也適用於 Managed Daemons。

下表列出 Container Insights 為 Amazon ECS 收集的指標和維度。這些指標會在 `ECS/ContainerInsights` 命名空間中。如需詳細資訊，請參閱[指標](cloudwatch_concepts.md#Metric)。

如果您沒有在主控台中看到任何容器洞見指標，請確定您已完成容器洞見的設定。在完整設定容器洞見前指標都不會出現。如需詳細資訊，請參閱[設定 Container Insights](deploy-container-insights.md)。

當您完成 [在 Amazon ECS 上設定 Container Insights](deploy-container-insights-ECS-cluster.md) 中的步驟後即可使用下列指標。


| 指標名稱 | 維度 | 說明 | 
| --- | --- | --- | 
| `ContainerInstanceCount` | `ClusterName` | 執行 Amazon ECS 代理程式並與叢集註冊的 EC2 執行個體數量。<br />只會針對在叢集中執行 Amazon ECS 任務的容器執行個體來收集此指標。對於沒有任何 Amazon ECS 任務的空容器執行個體，不會收集此指標。<br />單位：計數 | 
| `CpuUtilized` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName` | 資源中任務所使用的 CPU 單位，由您正在使用的維度設定所指定。<br />也適用於 Managed Daemons。<br />單位：無 | 
| `CpuReserved` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName` | 資源中任務所預留的 CPU 單位，由您正在使用的維度設定所指定。<br />根據任務定義中定義的 CPU 預留來收集此指標，例如在任務或所有容器層級。如果在任務定義中未定義，則會使用執行個體 CPU 預留。<br />也適用於 Managed Daemons。<br />單位：無 | 
| `DeploymentCount` | `ServiceName`, `ClusterName` | 在 Amazon ECS 服務中部署的數量。<br />單位：計數 | 
| `DesiredTaskCount` | `ServiceName`, `ClusterName` | Amazon ECS 服務所需的任務數。<br />單位：計數 | 
| `EBSFilesystemSize` | `VolumeName`, `TaskDefinitionFamily`, `ClusterName`<br />`TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName` | 分配給您正在使用之維度所指定資源的 Amazon EBS 檔案系統儲存總量，以 GB 為單位。<br />此指標僅適用於在 Fargate 上使用平台版本 `1.4.0` 執行的 Amazon ECS 基礎設施上執行的任務，或使用容器代理程式版本 `1.79.0` 或更新版本的 Amazon EC2 執行個體。<br />也適用於 Managed Daemons。<br />單位：千兆位元組 (GB) | 
| `EBSFilesystemUtilized` | `VolumeName`, `TaskDefinitionFamily`, `ClusterName`<br />`TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName` | 您正在使用之維度所指定資源的 Amazon EBS 檔案系統儲存總量，以 GB 為單位。<br />此指標僅適用於在 Fargate 上使用平台版本 `1.4.0` 執行的 Amazon ECS 基礎設施上執行的任務，或使用容器代理程式版本 `1.79.0` 或更新版本的 Amazon EC2 執行個體。<br />對於在 Fargate 上執行的任務，Fargate 會在只有 Fargate 使用的磁碟上預留空間。Fargate 使用的空間不會產生相關費用，但您可以使用 `df` 等工具檢視此額外儲存空間。<br />也適用於 Managed Daemons。<br />單位：千兆位元組 (GB) | 
|  EphemeralStorageReserved [1](#ci-metrics-ecs-storage-fargate-note)  | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName` | 資源中從暫時性儲存裝置中所預留的位元組數，該資源由您正在使用的維度所指定。暫時性儲存裝置會用於容器根檔案系統，以及容器映像和任務定義中定義的任何綁定掛載主機磁碟區。在執行中的任務中，無法變更暫時性儲存裝置的數量。<br />此指標僅適用於在 Fargate Linux 平台版本 1.4.0 或更新版本上執行的任務。<br />也適用於 Managed Daemons。<br />單位：千兆位元組 (GB) | 
|  EphemeralStorageUtilized [1](#ci-metrics-ecs-storage-fargate-note)  | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName` | 資源中從暫時性儲存裝置中使用的位元組數，該資源由您正在使用的維度所指定。暫時性儲存裝置會用於容器根檔案系統，以及容器映像和任務定義中定義的任何綁定掛載主機磁碟區。在執行中的任務中，無法變更暫時性儲存裝置的數量。<br />此指標僅適用於在 Fargate Linux 平台版本 1.4.0 或更新版本上執行的任務。<br />也適用於 Managed Daemons。<br />單位：千兆位元組 (GB) | 
| `InstanceOSFilesystemUtilization` | `CapacityProviderName`, `ClusterName`, `ContainerInstanceId`, `EC2InstanceId`<br />`ClusterName` | 用於作業系統磁碟區的總磁碟空間百分比。 | 
| `InstanceDataFilesystemUtilization` | `CapacityProviderName`, `ClusterName`, `ContainerInstanceId`, `EC2InstanceId`<br />`ClusterName` | 用於資料磁碟區的總磁碟空間百分比。 | 
| `MemoryUtilized` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName` | 資源中任務正在使用的記憶體，由您正在使用的維度設定所指定。 如果將 Java ZGC 垃圾收集器用於您的應用程式，則此指標可能不準確。 <br />雖然 `MemoryUtilized` 和 `MemoryReserved` 標記為「MB」，但實際單位為 MiB。 <br />也適用於 Managed Daemons。<br />單位：MB | 
| `MemoryReserved` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName` | 資源中任務所預留的記憶體，由您正在使用的維度設定所指定。根據任務定義中定義的記憶體預留來收集此指標，例如在任務或所有容器層級。如果在任務定義中未定義，則會使用執行個體記憶體預留。<br />也適用於 Managed Daemons。<br />單位：MB 雖然 `MemoryUtilized` 和 `MemoryReserved` 標記為「MB」，但實際單位為 MiB。  | 
| `NetworkRxBytes` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName` | 資源收到的位元組數，由您正在使用的維度所指定。從 Docker 執行期獲取此指標。<br />此指標僅適用於使用 `awsvpc` 或 `bridge` 網路模式的任務中的容器。<br />也適用於 Managed Daemons。<br />單位：位元組/秒 | 
| `NetworkTxBytes` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName` | 資源傳輸的位元組數，由您正在使用的維度所指定。從 Docker 執行期獲取此指標。<br />此指標僅適用於使用 `awsvpc` 或 `bridge` 網路模式的任務中的容器。<br />也適用於 Managed Daemons。<br />單位：位元組/秒 | 
| `PendingTaskCount` | `ServiceName`, `ClusterName` | 目前處於 `PENDING` 狀態的任務數。<br />單位：計數 | 
| `RunningTaskCount` | `ServiceName`, `ClusterName` | 目前處於 `RUNNING` 狀態的任務數。<br />單位：計數 | 
| `RestartCount` | `ClusterName`<br />`ClusterName`, `ServiceName`<br />`ClusterName`, `TaskDefinitionFamily` | Amazon ECS 任務中的容器重新啟動的次數。<br />只會針對已啟用重新啟動政策的容器收集此指標。<br />也適用於 Managed Daemons。<br />單位：計數 | 
| `ServiceCount` | `ClusterName` | 叢集中的服務數量。<br />單位：計數 | 
| `StorageReadBytes` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName` | 資源中從執行個體儲存裝置讀取的位元組數，該資源由您正在使用的維度所指定。這不包括儲存裝置的讀取位元組。從 Docker 執行期獲取此指標。<br />也適用於 Managed Daemons。<br />單位：位元組 | 
| `StorageWriteBytes` | `TaskDefinitionFamily`, `ClusterName`<br />`ServiceName`, `ClusterName`<br />`ClusterName` | 資源中寫入儲存裝置的位元組數，該資源由您正在使用的維度所指定。從 Docker 執行期獲取此指標。<br />也適用於 Managed Daemons。<br />單位：位元組 | 
| `TaskCount` | `ClusterName` | 叢集中執行的任務數。<br />單位：計數 | 
| `TaskSetCount` | `ServiceName`, `ClusterName` | 服務中的任務集數。<br />單位：計數 | 

**注意**  
此 `EphemeralStorageReserved` 與 `EphemeralStorageUtilized` 指標僅適用於在 Fargate Linux 平台版本 1.4.0 或更新版本上執行的任務。  
Fargate 會在磁盤上保留空間。此空間僅由 Fargate 使用。我們不會向您收費。它不會顯示在這些指標中。但是，您可以在其他工具 (例如 `df`) 中看到此額外儲存空間。

當您完成 [部署 CloudWatch 代理程式以收集 Amazon ECS 上的 EC2 執行個體層級指標](deploy-container-insights-ECS-instancelevel.md) 中的步驟後即可使用下列指標


| 指標名稱 | 維度 | 說明 | 
| --- | --- | --- | 
| `instance_cpu_limit` | `ClusterName` | 可指派至此叢集中單一 EC2 執行個體的 CPU 單位數量上限。<br />單位：無 | 
| `instance_cpu_reserved_capacity` | `ClusterName`<br />`InstanceId`, `ContainerInstanceId`, `ClusterName` | 目前保留在叢集中單一 EC2 執行個體上的 CPU 百分比。<br />單位：百分比 | 
| `instance_cpu_usage_total` | `ClusterName` | 叢集中單一 EC2 執行個體正在使用的 CPU 單位數目。<br />單位：無 | 
| `instance_cpu_utilization` | `ClusterName`<br />`InstanceId`, `ContainerInstanceId`, `ClusterName` | 叢集中單一 EC2 執行個體正在使用的 CPU 單位總百分比。<br />單位：百分比 | 
| `instance_filesystem_utilization` | `ClusterName`<br />`InstanceId`, `ContainerInstanceId`, `ClusterName` | 叢集中單一 EC2 執行個體正在使用的檔案系統容量總百分比。<br />單位：百分比 | 
| `instance_memory_limit` | `ClusterName` | 可指派至此叢集中單一 EC2 執行個體的記憶體數量上限 (以位元組為單位)。<br />單位：位元組 | 
| `instance_memory_reserved_capacity` | `ClusterName`<br />`InstanceId`, `ContainerInstanceId`, `ClusterName` | 目前保留在叢集中單一 EC2 執行個體上的記憶體百分比。<br />單位：百分比 | 
| `instance_memory_utilization` | `ClusterName`<br />`InstanceId`, `ContainerInstanceId`, `ClusterName` | 叢集中單一 EC2 執行個體正在使用的記憶體總百分比。 如果將 Java ZGC 垃圾收集器用於您的應用程式，則此指標可能不準確。 <br />單位：百分比 | 
| `instance_memory_working_set` | `ClusterName` | 叢集中單一 EC2 執行個體正在使用的記憶體數量 (以位元組為單位)。 如果將 Java ZGC 垃圾收集器用於您的應用程式，則此指標可能不準確。 <br />單位：位元組 | 
| `instance_network_total_bytes` | `ClusterName` | 叢集中單一 EC2 執行個體上透過網路傳輸和接收的每秒位元組總數。<br />單位：位元組/秒 | 
| `instance_number_of_running_tasks` | `ClusterName` | 叢集中單一 EC2 執行個體上執行的任務數目。<br />單位：計數 | 