本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 Amazon CloudWatch 監控 Rekognition
使用 CloudWatch 可獲得個別 Rekognition 操作的指標或帳戶的全域 Rekognition 指標。您可以使用指標來追蹤以 Rekognition 為基礎的解決方案之運作狀態，並設定當一個或多個指標超出既定閾值時傳送警示通知給自己。例如，您可以查看發生的伺服器錯誤次數指標，或者偵測到的臉孔數量指標。您也可以查看特定 Rekognition 操作的成功次數指標。若要查看指標，您可以使用 [Amazon CloudWatch](https://console.aws.amazon.com/cloudwatch/)、[Amazon AWS Command Line Interface](https://docs.aws.amazon.com/AmazonCloudWatch/latest/cli/) 或 [CloudWatch API](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)。
您也可以使用 Rekognition 主控台來查看指定的時間期間的彙總指標。如需詳細資訊，請參閱 [練習 4：查看彙總指標 (主控台)](aggregated-metrics.md)。
## 使用適用於 Rekognition 的 CloudWatch 指標
要使用指標，您必須指定下列資訊：
+ 指標維度，或者無維度。*維度*是一組用來單獨辨識指標的名稱值組。Rekognition有一個維度，稱為*操作*。它提供特定操作的指標。如果您未指定維度，指標範圍將適用於帳號內的所有 Rekognition 操作。
+ 指標名稱，例如 `UserErrorCount`。
您可以使用 AWS 管理主控台、 AWS CLI或 CloudWatch API 來取得 Rekognition 的監控資料。您也可以透過其中一個 Amazon AWS 軟體開發套件 (SDK) 或 Amazon CloudWatch API 工具使用 CloudWatch API。主控台會根據 CloudWatch API 的原始資料顯示一系列圖形。根據需求，您可能偏好使用顯示於主控台中的圖形或自 API 擷取的圖形。
###
下列清單顯示一些常見的指標用途。這些是協助您開始的建議，而不是完整清單。
| 我要如何？ | 相關指標 |
| --- | --- |
| 我要如何追蹤辨識到的臉孔數量？ | 監控 `DetectedFaceCount` 指標的 `Sum` 統計資料。 |
| 我要如何得知我的應用程式已達每秒最高請求數量？ | 監控 `ThrottledCount` 指標的 `Sum` 統計資料。 |
| 我要如何監控請求錯誤？ | 使用 `UserErrorCount` 指標的 `Sum` 統計資料。 |
| 我要如何找到請求總數？ | 使用 `ResponseTime` 指標的 `ResponseTime` 與 `Data Samples` 統計資料。其中包括任何產生錯誤的請求。如果您只想要查看成功操作呼叫，請使用 `SuccessfulRequestCount` 指標。 |
| 我要如何監控 `Rekognition` 操作呼叫的延遲？ | 使用 `ResponseTime` 指標。 |
| 我要如何監控 `IndexFaces` 成功新增人臉到 Rekognition 集合的次數？ | 使用 `SuccessfulRequestCount` 指標與 `IndexFaces` 操作來監控 `Sum` 統計資料。使用 `Operation` 維度來選擇操作與指標。 |
您必須擁有適當的 CloudWatch 許可才可使用 CloudWatch 來監控 Rekognition。如需詳細資訊，請參閱 [Amazon CloudWatch 身分驗證與存取控制](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)。
## 存取 Rekognition 指標
下列範例示範如何使用 CloudWatch 主控台、 AWS CLI和 CloudWatch API 存取 Rekognition 指標。
**檢視指標 (主控台)**
1. 透過 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch) 開啟 CloudWatch 主控台。
1. 選擇 **Metrics** (指標)、選擇 **All Metrics** (所有指標) 標籤，然後選擇 **Rekognition**。
1. 選擇 **Metrics with no dimensions** (無維度的指標)，然後選擇一個指標。
例如，選擇 **DetectedFace** 指標來計算已偵測到幾個臉孔。
1. 選擇日期範圍的值。指標計數顯示於圖形中。
**若要查看一段時間內的成功指標 `DetectFaces` 操作呼叫 (CLI)。**
+ 開啟 AWS CLI 並輸入下列命令：
`aws cloudwatch get-metric-statistics --metric-name SuccessfulRequestCount --start-time 2017-1-1T19:46:20 --end-time 2017-1-6T19:46:57 --period 3600 --namespace AWS/Rekognition --statistics Sum --dimensions Name=Operation,Value=DetectFaces --region us-west-2`
此範例顯示在一段時間內執行的成功 `DetectFaces` 操作呼叫。如需詳細資訊，請參閱 [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/get-metric-statistics.html)。
**存取指標 (CloudWatch API)**
+ 呼叫 `[GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)`。如需詳細資訊，請參閱 [Amazon CloudWatch API 參考](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)。
## 建立警示
您可以建立 CloudWatch 警報，在警示變更狀態時傳送 Amazon Simple Notification Service (Amazon SNS) 訊息。警示會監看指定時段內的單一指標，並根據與多個時段內指定閾值相對的指標值來執行一或多個動作。此動作是傳送到 Amazon SNS 主題或 Auto Scaling 政策的通知。
警示僅會針對持續狀態變更調用動作。CloudWatch 警示不會只因為處於特定狀態而調用動作。狀態必須發生變更並維持一段指定的時間。
**若要設定警示 (主控台)**
1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。
1. 選擇**建立警示**。這會啟動 **Create Alarm Wizard (建立警示精靈)**。
1. 在 **Metrics with no dimensions** (無維度的指標) 指標清單中，選擇 **Rekognition Metrics** (Rekognition 指標)，然後選擇一個指標。
例如，選擇 **DetectedFaceCount** 來設定偵測到的臉孔之最高數量警示。
1. 在 **Time Range** (時間範圍) 區域內，選擇包含您已呼叫的人臉偵測操作之日期範圍值。選擇**下一步**
1. 填入 **Name** (名稱) 和 **Description** (說明)。對於 **Whenever** (每當) 選項，請選擇 **>=** 並輸入您所選擇的最大值。
1. 如果您希望 CloudWatch 在達到警示狀態時傳送電子郵件給您，請在**每當此警示：**中選擇**狀態為「警示」**。若要傳送警示到現有的 Amazon SNS 主題，請在**傳送通知至：**選項中選擇現有的 SNS 主題。若要設定新的電子郵件訂閱清單的名稱與電子郵件地址，請選擇**建立主題**，CloudWatch 將會儲存清單並顯示於欄位中，可提供未來設定警示時使用。
**注意**
如果您使用**建立主題**來建立新的 Amazon SNS 主題，電子郵件地址必須先經過驗證，目標收件人才可接收通知。Amazon SNS 只會在警示進入警示狀態時才會傳送電子郵件。如果此警示狀態在驗證電子郵件地址之前發生變更，目標收件人就不會收到通知。
1. 在 **Alarm Preview** (警示預覽) 區段中預覽警示。選擇**建立警示** 。
**設定警示 (AWS CLI)**
+ 開啟 AWS CLI 並輸入下列命令。變更 `alarm-actions` 參數值，以連結您之前建立的 Amazon SNS 主題。
`aws cloudwatch put-metric-alarm --alarm-name UserErrors --alarm-description "Alarm when more than 10 user errors occur" --metric-name UserErrorCount --namespace AWS/Rekognition --statistic Average --period 300 --threshold 10 --comparison-operator GreaterThanThreshold --evaluation-periods 2 --alarm-actions arn:aws:sns:us-west-2:111111111111:UserError --unit Count`
此範例說明如何建立警示，當 5 分鐘內發生超過 10 個使用者錯誤時通知。如需詳細資訊，請參閱 [put-metric-alarm](https://docs.aws.amazon.com/cli/latest/reference/put-metric-alarm.html)。
**使用 CloudWatch API 設定警示**
+ 呼叫 `[PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)`。如需詳細資訊，請參閱 *[Amazon CloudWatch API 參考](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)*。
## Rekognition CloudWatch 指標
本節包含有關可提供 Amazon Rekognition 使用的 Amazon CloudWatch 指標和*操作*維度資訊。
您也可以從 Rekognition 主控台查看 Rekognition 指標的彙總檢視。如需詳細資訊，請參閱 [練習 4：查看彙總指標 (主控台)](aggregated-metrics.md)。
### Rekognition CloudWatch 指標
下表顯示 Rekognition 指標摘要。
| 指標 | Description |
| --- | --- |
| SuccessfulRequestCount | 成功請求的數量。成功請求的回應碼範圍是 200 到 299。 單位：計數 有效的統計資訊：`Sum,Average` |
| ThrottledCount | 已調節的請求數目。Rekognition 會在收到的請求超過為您的帳戶每秒所設的交易上限時節制請求。如果經常超過為您的帳戶所設的限制，您可以請求提高上限。若要請求提高，請參閱 [AWS 服務限制](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)。 單位：計數 有效的統計資訊：`Sum,Average` |
| ResponseTime | 以毫秒為單位的時間，提供 Rekognition 來運算回應。 單位： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/rekognition/latest/dg/rekognition-monitoring.html) 有效的統計資訊：`Data Samples,Average` `ResponseTime` 指標不包含在 Rekognition 指標窗格中。 |
| DetectedFaceCount | 以 `IndexFaces` 或 `DetectFaces` 操作偵測到人臉的次數。 單位：計數 有效的統計資訊：`Sum,Average` |
| DetectedLabelCount | 以 `DetectLabels` 操作偵測到標籤的次數。 單位：計數 有效的統計資訊：`Sum,Average` |
| ServerErrorCount | 伺服器錯誤的次數。伺服器錯誤的回應碼範圍是 500 到 599。 單位：計數 有效的統計資訊：`Sum, Average` |
| UserErrorCount | 使用者錯誤次數 (無效參數、無效影像、無權限等)。使用者錯誤的回應碼範圍是 400 到 499。 單位：計數 有效的統計資訊：`Sum,Average` |
| MinInferenceUnit | StartProjectVersion 請求期間指定的推論單元數目下限。單位：計數有效的統計資訊：`Average` |
| MaxInferenceUnit | StartProjectVersion 請求期間指定的推論單元數目上限。單位：計數有效的統計資訊：`Average` |
| DesiredInferenceUnit | Rekognition 要增加或縮減的推論單位數目。 單位：計數 有效的統計資訊：`Average` |
| InServiceInferenceUnit | 模型正在使用的推論單位數。 單位：計數 有效的統計資訊：`Average` 建議您使用平均統計資料來取得使用多少執行個體處理的 1 分鐘平均值。 |
### Rekognition 串串流的 CloudWatch 指標
Rekognition 也有用於串串流作業的第二個命名空間，即「Rekognition 串串流」。下表顯示 Rekognition 指標摘要。
| 指標 | Description |
| --- | --- |
| SuccessfulRequestCount | 成功請求的數量。成功請求的回應碼範圍是 200 到 299。 單位：計數 有效的統計資訊：`Sum,Average` |
| CallCount | 在您的帳戶中執行的指定操作數目。 有效的統計資訊：`Sum,Average` |
| ThrottledCount | 已調節的請求數目。Rekognition 會在收到的請求超過為您的帳戶每秒所設的交易上限時節制請求。如果經常超過為您的帳戶所設的限制，您可以請求提高上限。若要請求提高，請參閱 [AWS 服務限制](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html)。 單位：計數 有效的統計資訊：`Sum,Average` |
| ServerErrorCount | 伺服器錯誤的次數。伺服器錯誤的回應碼範圍是 500 到 599。 單位：計數 有效的統計資訊：`Sum, Average` |
| UserErrorCount | 使用者錯誤次數 (無效參數、無效影像、無權限等)。使用者錯誤的回應碼範圍是 400 到 499。 單位：計數 有效的統計資訊：`Sum,Average` |
| ConcurrentSessions | 您的帳戶目前正在使用的並行工作階段數量。單位：計數有效的統計資訊：`Max,Average` |
### Rekognition 的 CloudWatch 維度
若要擷取特定操作的指標，請使用 `Rekognition` 命名空間並提供操作維度。
如需維度的詳細資訊，請參閱《Amazon CloudWatch 使用者指南》**中的[維度](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)。
### Rekognition 自訂標籤的 CloudWatch 維度
下表顯示可與 Rekognition 自訂標籤搭配使用的 CloudWatch 維度：
****
| 維度 | Description |
| --- | --- |
| ProjectName | 您使用 CreateProject 建立的 Rekognition 自訂標籤專案的名稱。 |
| VersionName | 您使用 CreateProjectVersion 建立的 Rekognition 自訂標籤專案版本的名稱。 |
如需維度的詳細資訊，請參閱《Amazon CloudWatch 使用者指南》**中的[維度](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)。