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

# Amazon ECS CloudWatch 指標
<a name="available-metrics"></a>

您可以使用 CloudWatch 用量指標來提供您帳戶的資源用量可見度。使用這些指標，以 CloudWatch 圖表和儀表板視覺化目前的服務使用狀況。

Amazon ECS 每隔 1 分鐘就會將指標傳送至 CloudWatch。這些指標為具有 `RUNNING` 狀態之任務的資源而收集。如果叢集、服務或其他資源沒有執行中的任務，則該期間內不會回報該資源的指標。舉例來說，如果您有叢集包含一個服務，但該服務沒有處於 `RUNNING` 狀態的任務，則不會向 CloudWatch 傳送任何指標。同理，如果您有兩個服務，其中一個服務有執行中的任務，而另一個沒有，則只會傳送有執行中任務之服務的指標。


****  

| 指標 | Description | 有效維度 | 實用統計量 | 單位 | 
| --- | --- | --- | --- | --- | 
| CPUReservation |  叢集或服務中所保留 CPU 單位的百分比。 CPU 保留量 (依 `ClusterName` 篩選) 的計算方式為，叢集上 Amazon ECS 任務所保留的 CPU 單元總數，除以叢集中所有已註冊 Amazon EC2 執行個體的 CPU 單位總數。僅處於 `ACTIVE` 或 `DRAINING` 狀態的 Amazon EC2 執行個體會影響 CPU 保留量指標。該指標僅適用於託管在 Amazon EC2 執行個體上的任務。  |  ClusterName. | 平均值、最小值、最大值 | 百分比 | 
| CPUUtilization |  叢集或服務或受管協助程式使用的 CPU 單位百分比。 叢集層級 CPU 使用率 (依 `ClusterName` 篩選) 的計算方式為，叢集上 Amazon ECS 任務所使用 CPU 單元總數，除以叢集中所有已註冊 Amazon EC2 執行個體的 CPU 單位總數。僅處於 `ACTIVE` 或 `DRAINING` 狀態的 Amazon EC2 執行個體會影響 CPU 保留量指標。叢集層級指標僅適用於託管在 Amazon EC2 執行個體上的任務。 服務層級 CPU 使用率 (依 `ClusterName`、`ServiceName` 篩選) 的計算方式為，屬於該服務之任務所使用的 CPU 總數，除以為這些任務保留的 CPU 單位總數。服務層級指標適用於託管在 Amazon EC2 執行個體和 Fargate 上的任務。 常駐程式層級 CPU 使用率 （由 篩選`ClusterName`，`ServiceName`) 的測量方式為屬於受管常駐程式的任務正在使用的 CPU 單位總數，除以屬於受管常駐程式的任務預留的 CPU 單位總數。  |  ClusterName, ServiceName |  平均值、最小值、最大值  | 百分比 | 
| MemoryReservation |  由叢集內執行中任務保留的記憶體的百分比。 叢集記憶體保留量的計算方式為，叢集上 Amazon ECS 任務所保留的記憶體總量，除以叢集中所有已註冊 Amazon EC2 執行個體的記憶體總量。此指標只能依 `ClusterName` 篩選。僅處於 `ACTIVE` 或 `DRAINING` 狀態的 Amazon EC2 執行個體會影響記憶體保留量指標。叢集層級記憶體保留量指標僅適用於託管在 Amazon EC2 執行個體上的任務。  計算記憶體使用率時，如果已指定 `MemoryReservation`，則將以此數值代入計算，而非採用記憶體總量。   |  ClusterName. | 平均值、最小值、最大值 | 百分比 | 
| MemoryUtilization |  叢集或服務或受管協助程式使用的記憶體百分比。 叢集層級記憶體使用率 (依 `ClusterName` 篩選) 的衡量方式為，叢集上 Amazon ECS 任務所使用的記憶體總量，除以叢集中所有已註冊 Amazon EC2 執行個體的記憶體總量。僅處於 `ACTIVE` 或 `DRAINING` 狀態的 Amazon EC2 執行個體會影響記憶體使用率指標。叢集層級指標僅適用於託管在 Amazon EC2 執行個體上的任務。 服務層級記憶體使用率 (依 `ClusterName`、`ServiceName` 篩選) 的計算方式為，屬於該服務之任務所使用的記憶體總量，除以為術語該服務的這些任務保留的記憶體總量。服務層級指標適用於託管在 Amazon EC2 執行個體和 Fargate 上的任務。 常駐程式層級記憶體使用率 （由 篩選`ClusterName`，`ServiceName`) 的測量方式為屬於受管常駐程式的任務正在使用的總記憶體，除以屬於受管常駐程式的任務預留的總記憶體。  |  ClusterName, ServiceName |  平均值、最小值、最大值  | 百分比 | 
| EBSFilesystemUtilization |  服務中任務所使用的 Amazon EBS 檔案系統百分比。 服務層級 EBS 檔案系統使用率指標 (依 `ClusterName`、`ServiceName` 篩選) 的計算方式為，屬於該服務之任務所使用的 EBS 檔案系統總量，除以為屬於該服務的所有任務配置的 EBS 檔案系統儲存總量。服務層級 EBS 檔案系統使用率指標僅適用於託管在 Amazon EC2 執行個體 (使用容器代理程式版本 `1.79.0`) 與 Fargate (使用平台版本 `1.4.0`) 上且已連接 EBS 磁碟區的任務。  對於託管在 Fargate 上的任務，磁碟上有僅供 Fargate 使用的空間。Fargate 使用的空間不會產生相關費用，但您可以使用 `df` 等工具檢視此額外儲存空間。   |  ClusterName, ServiceName |  平均值、最小值、最大值  | 百分比 | 
| GPUReservation |  由叢集內執行中任務保留的 GPU 可用總數的百分比。 叢集層級 GPU 保留量指標的計算方式為，叢集上 Amazon ECS 任務所保留的 GPU 數量，除以叢集中所有已註冊且搭載 GPU 之 Amazon EC2 執行個體的 GPU 總數。僅處於 `ACTIVE` 或 `DRAINING` 狀態的 Amazon EC2 執行個體會影響 GPU 保留量指標。  | ClusterName | 平均值、最小值、最大值 | 百分比 | 
| ActiveConnectionCount | 從用戶端到在共享所選 `DiscoveryName` 的任務中執行之 Amazon ECS Service Connect Proxy 的作用中同時連線總數。 僅當您已設定 Amazon ECS Service Connect 時，才能使用此指標。 有效維度：`DiscoveryName` 和 `DiscoveryName, ServiceName, ClusterName`。 |  DiscoveryName 與 DiscoveryName、ServiceName、ClusterName | 平均值、最小值、最大值、總和 | 計數 | 
| NewConnectionCount |  從用戶端到在共享所選 `DiscoveryName` 的任務中執行之 Amazon ECS Service Connect Proxy 的新建立連線總數。 僅當您已設定 Amazon ECS Service Connect 時，才能使用此指標。  | DiscoveryName 和 DiscoveryName, ServiceName, ClusterName | 平均值、最小值、最大值、總和 | 計數 | 
| ProcessedBytes |  Service Connect Proxy 處理的輸入流量總位元組數。 僅當您已設定 Amazon ECS Service Connect 時，才能使用此指標。  | DiscoveryName 和 DiscoveryName, ServiceName, ClusterName | 平均值、最小值、最大值、總和 | 位元組 | 
| RequestCount |  Service Connect Proxy 處理的輸入流量請求數。 僅當您已設定 Amazon ECS Service Connect 時，才能使用此指標。 您也需在任務定義的連接埠映射中設定 `appProtocol`。  | DiscoveryName 和 DiscoveryName, ServiceName, ClusterName | 平均值、最小值、最大值、總和 | 計數 | 
| GrpcRequestCount |  Service Connect Proxy 處理的 gRPC 輸入流量請求數。 僅當您已設定 Amazon ECS Service Connect 且 `appProtocol` 在任務定義的連接埠映射中為 `GRPC` 時，才能使用此指標。  | DiscoveryName 和 DiscoveryName, ServiceName, ClusterName | 平均值、最小值、最大值、總和 | 計數 | 
| HTTPCode\$1Target\$12XX\$1Count |  這些任務中應用程式所產生的編號 200 至 299 的 HTTP 回應代碼數。這些任務是目標。此指標只會計算應用程式在這些任務中傳送至 Service Connect Proxy 的回應，而非直接傳送的回應。 僅當您已設定 Amazon ECS Service Connect 且 `appProtocol` 在任務定義的連接埠映射中為 `HTTP` 或 `HTTP2` 時，才能使用此指標。 有效維度：  | TargetDiscoveryName 和 TargetDiscoveryName, ServiceName, ClusterName | 平均值、最小值、最大值、總和 | 計數 | 
| HTTPCode\$1Target\$13XX\$1Count |  這些任務中應用程式所產生的編號 300 至 399 的 HTTP 回應代碼數。這些任務是目標。此指標只會計算應用程式在這些任務中傳送至 Service Connect Proxy 的回應，而非直接傳送的回應。 僅當您已設定 Amazon ECS Service Connect 且 `appProtocol` 在任務定義的連接埠映射中為 `HTTP` 或 `HTTP2` 時，才能使用此指標。  | TargetDiscoveryName 和 TargetDiscoveryName, ServiceName, ClusterName | 平均值、最小值、最大值、總和 | 計數 | 
| HTTPCode\$1Target\$14XX\$1Count |  這些任務中應用程式所產生的編號 400 至 499 的 HTTP 回應代碼數。這些任務是目標。此指標只會計算應用程式在這些任務中傳送至 Service Connect Proxy 的回應，而非直接傳送的回應。 僅當您已設定 Amazon ECS Service Connect 且 `appProtocol` 在任務定義的連接埠映射中為 `HTTP` 或 `HTTP2` 時，才能使用此指標。  | TargetDiscoveryName 和 TargetDiscoveryName, ServiceName, ClusterName | 平均值、最小值、最大值、總和 | 計數 | 
| HTTPCode\$1Target\$15XX\$1Count |  這些任務中應用程式所產生的編號 500 至 599 的 HTTP 回應代碼數。這些任務是目標。此指標只會計算應用程式在這些任務中傳送至 Service Connect Proxy 的回應，而非直接傳送的回應。 僅當您已設定 Amazon ECS Service Connect 且 `appProtocol` 在任務定義的連接埠映射中為 `HTTP` 或 `HTTP2` 時，才能使用此指標。  | TargetDiscoveryName 和 TargetDiscoveryName, ServiceName, ClusterName | 平均值、最小值、最大值、總和 | 計數 | 
| RequestCountPerTarget |  共享所選 `DiscoveryName` 的每個目標接收的平均請求數。 僅當您已設定 Amazon ECS Service Connect 時，才能使用此指標。  | TargetDiscoveryName 和 TargetDiscoveryName, ServiceName, ClusterName | 平均數 | 計數 | 
| TargetProcessedBytes |  Service Connect Proxy 處理的總位元組數。 僅當您已設定 Amazon ECS Service Connect 時，才能使用此指標。  | TargetDiscoveryName 和 TargetDiscoveryName, ServiceName, ClusterName | 平均值、最小值、最大值、總和 | 位元組 | 
| TargetResponseTime |  應用程式請求處理的延遲。從請求到達目標任務中的 Service Connect Proxy，直到 Proxy 收到目標應用程式回應所經過的時間 (以毫秒為單位)。 僅當您已設定 Amazon ECS Service Connect 時，才能使用此指標。  |  TargetDiscoveryName 和 TargetDiscoveryName, ServiceName, ClusterName |  平均值、最小值、最大值  | 毫秒 | 
| ClientTLSNegotiationErrorCount |  TLS 連線失敗的總次數。僅當已啟用 TLS 時才使用此指標。 僅當您已設定 Amazon ECS Service Connect 時，才能使用此指標。  |  DiscoveryName 與 DiscoveryName、ServiceName、ClusterName | 平均值、最小值、最大值、總和 | 計數 | 
| TargetTLSNegotiationErrorCount |  TLS 連線因缺少用戶端憑證、 AWS 私有 CA 驗證失敗或 SAN 驗證失敗而失敗的總次數。僅當已啟用 TLS 時才使用此指標。 僅當您已設定 Amazon ECS Service Connect 時，才能使用此指標。  |  ServiceName、ClusterName、TargetDiscoveryName 與 TargetDiscoveryName | 平均值、最小值、最大值、總和 | 計數 | 

## Amazon ECS 指標的維度
<a name="ecs-metrics-dimensions"></a>

Amazon ECS 指標使用 `AWS/ECS` 命名空間，並提供下列維度的指標。Amazon ECS 只會針對 `RUNNING` 狀態中有任務的資源傳送指標。舉例來說，如果您有叢集包含一個服務，但該服務沒有處於 `RUNNING` 狀態的任務，則不會傳送任何指標至 CloudWatch。如果您有兩個服務，其中一個有執行中的任務，而另一個沒有，則只會傳送有執行中任務之服務的指標。


****  

| 維度 | 定義 | 
| --- | --- | 
| ClusterName |  此維度可篩選您為指定叢集中所有資源請求的資料。所有 Amazon ECS 指標皆以 `ClusterName` 篩選。  | 
| ServiceName |  此維度會篩選您在指定叢集內，對指定服務或協助程式中所有資源請求的資料。對於協助程式指標，`ServiceName`維度值具有字首，`daemon:`後面接著協助程式名稱。例如，名為 的協助程式`my-daemon`的`ServiceName`維度值為 `daemon:my-daemon`。  | 
| DiscoveryName |  此維度會篩選您為流量指標請求，且傳送至所有 Amazon ECS 叢集內指定 Service Connect 探索名稱的資料。 請注意，執行中容器內的特定連接埠可以擁有多個探索名稱。  | 
| DiscoveryName, ServiceName, ClusterName |  此維度會篩選您為流量指標請求，且傳送至具有此探索名稱並由此叢集中此服務所建立之任務內指定 Service Connect 探索名稱的資料。 如果您在不同命名空間的多個服務中重複使用相同的探索名稱，請使用此維度來查看特定服務的輸入流量指標。 請注意，執行中容器內的特定連接埠可以擁有多個探索名稱。  | 
| TargetDiscoveryName |  此維度會篩選您為流量指標請求，且傳送至所有 Amazon ECS 叢集內指定 Service Connect 探索名稱的資料。 與 `DiscoveryName` 不同，這些流量指標僅會測量傳送至此 `DiscoveryName`，且來自在此命名空間中具有 Service Connect 組態的其他 Amazon ECS 任務的輸入流量。這包括服務使用僅限用戶端或用戶端-伺服器 Service Connect 組態建立的任務。 請注意，執行中容器內的特定連接埠可以擁有多個探索名稱。  | 
| TargetDiscoveryName, ServiceName, ClusterName |  此維度會篩選您為流量指標請求，且傳送至指定 Service Connect 探索名稱的資料，但僅會計算來自此叢集中此服務所建立任務的流量。 使用此維度來查看來自另一服務中特定用戶端的輸入流量指標。 與 `DiscoveryName, ServiceName, ClusterName` 不同，這些流量指標僅會測量傳送至此 `DiscoveryName`，且來自在此命名空間中具有 Service Connect 組態的其他 Amazon ECS 任務的輸入流量。這包括服務使用僅限用戶端或用戶端-伺服器 Service Connect 組態建立的任務。 請注意，執行中容器內的特定連接埠可以擁有多個探索名稱。  |