使用 CloudWatch Rekognition 度量存取 Rekognition 手段建立警示 CloudWatchRekognition 度量

使用亞馬遜監控 Rekognition 要手段 CloudWatch

同 CloudWatch，您可以取得個別 Rekognition 作業的指標或帳戶的全域 Rekognition 指標，您可以使用指標追蹤 Rekognition 解決方案的健康狀態，並設定警示以在一或多個指標落在定義的閾值之外時通知您。例如，您可以查看發生的伺服器錯誤次數指標，或者偵測到的臉孔數量指標。您也可以查看特定 Rekognition 作業成功次數的量度。要查看指標，您可以使用亞馬遜 CloudWatch,亞馬遜AWS Command Line Interface，或CloudWatch API。

您也可以使用 Rekognition 主控台查看所選期間內的彙總量度。如需詳細資訊，請參閱練習 4：查看彙總指標 (主控台)。

使用 CloudWatch Rekognition 度量

要使用指標，您必須指定下列資訊：

指標維度，或者無維度。維度是一組用來單獨辨識指標的名稱值組。Rekognition 具有一個維度，已命名操作。它提供特定操作的指標。如果您未指定維度，則量度的範圍會限制在您帳戶內的所有 Rekognition 作業。
指標名稱，例如 UserErrorCount。

您可以使用以下方式取得 Rekognition 的監視資料AWS Management Console，該AWS CLI，或 CloudWatch API。您也可以 CloudWatch 透過其中一個 Amazon AWS 軟體開發套件 (SDK) 或 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 使用以監視 Rekognition 的權限 CloudWatch。(如需詳細資訊，請參閱 Amazon CloudWatch 的身分驗證和存取控制)。

存取 Rekognition 手段

下列範例說明如何使用 CloudWatch 控制台，AWS CLI，以及 CloudWatchAPI。

檢視指標 (主控台)

開啟手段 CloudWatch 控制台https://console.aws.amazon.com/cloudwatch/。
選擇 Metrics (指標)、選擇 All Metrics (所有指標) 標籤，然後選擇 Rekognition。
選擇 Metrics with no dimensions (無維度的指標)，然後選擇一個指標。

例如，選擇DetectedFace測量已偵測到多少張臉孔的度量。
選擇日期範圍的值。指標計數顯示於圖形中。

若要查看一段時間內的成功指標 `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。

若要存取量度 (CloudWatch API)

呼叫 GetMetricStatistics。如需詳細資訊，請參閱亞馬遜 CloudWatch API 參考資料。

建立警示

您可以建立 CloudWatch 警示狀態變更時，會傳送 Simple Notification Service (Amazon SNS) 訊息的警示。警示會監看指定時段內的單一指標，並根據與多個時段內指定閾值相對的指標值來執行一或多個動作。此動作是傳送到 Amazon SNS 主題或 Auto Scaling 政策的通知。

警示僅會針對持續狀態變更呼叫動作。 CloudWatch 警報不會僅僅因為它們處於特定狀態所不可或缺。狀態必須發生變更並維持一段指定的時間。

若要設定警示 (主控台)

登入AWS Management Console並打開 CloudWatch 控制台https://console.aws.amazon.com/cloudwatch/。
選擇 Create Alarm (建立警示)。這會啟動 Create Alarm Wizard (建立警示精靈)。
在 Metrics with no dimensions (無維度的指標) 指標清單中，選擇 Rekognition Metrics (Rekognition 指標)，然後選擇一個指標。

例如，選擇DetectedFaceCount以設定偵測到的臉孔數目上限的警示。
在 Time Range (時間範圍) 區域內，選擇包含您已呼叫的臉部偵測操作之日期範圍值。選擇 Next (下一步)
填入 Name (名稱) 和 Description (說明)。對於 Whenever (每當) 選項，請選擇 >= 並輸入您所選擇的最大值。
如果你想 CloudWatch 當達到警報狀態時，向您發送電子郵件，每當這個警報：，選擇狀態為「警報」。若要將警示傳送至現有的 Amazon SNS 主題，傳送通知至：中，選擇現有的 SNS 主題。若要設定新電子郵件訂閱清單的名稱和電子郵件地址，請選擇建立主題 CloudWatch 保存列表並將其顯示在字段中，以便您可以使用它來設置將 future 的警報。

注意
如果您使用建立主題若要建立新 Amazon SNS 主題，必須先驗證電子郵件地址，預定收件者才能收到通知。Amazon SNS 只會在警示進入警示狀態時傳送電子郵件。如果此警示狀態在驗證電子郵件地址之前發生變更，目標收件人就不會收到通知。
在 Alarm Preview (警示預覽) 區段中預覽警示。選擇 Create Alarm (建立警示)。

設定警示 (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。

若要設定鬧鐘 (CloudWatch API)

呼叫 PutMetricAlarm。如需詳細資訊，請參閱亞馬遜 CloudWatch API 參考資料。

CloudWatchRekognition 度量

本節包含亞馬遜的相關資訊 CloudWatch 度量和操作維度可用於 Amazon Rekognition。

您也可以從 Rekognition 主控台查看 Rekognition 量度的彙總檢視。如需詳細資訊，請參閱練習 4：查看彙總指標 (主控台)。

CloudWatch Rekognition 度量

下表摘要「Rekognition 要手段」測量結果。

指標	描述
SuccessfulRequestCount	成功請求的數量。成功請求的回應碼範圍是 200 到 299。單位：計數有效的統計資訊：`Sum,Average`
ThrottledCount	已調節的請求數目。Rekognition 會在收到的要求數量超過您帳戶設定的每秒交易限制時，將會調節要求。如果經常超過為您的帳戶所設的限制，您可以請求提高上限。若要請求提高，請參閱 AWS Service Limits。單位：計數有效的統計資訊：`Sum,Average`
ResponseTime	Rekognition 計算回應的時間 (以毫秒為單位)。單位： `Data Samples` 統計資料的計數 `Average` 統計資料的毫秒有效的統計資訊：`Data Samples,Average` 注意該`ResponseTime`「Rekognition」度量窗格中不包含量度。
DetectedFaceCount	以 `IndexFaces` 或 `DetectFaces` 操作偵測到臉部的次數。單位：計數有效的統計資訊：`Sum,Average`
DetectedLabelCount	以 `DetectLabels` 操作偵測到標籤的次數。單位：計數有效的統計資訊：`Sum,Average`
ServerErrorCount	伺服器錯誤的次數。伺服器錯誤的回應碼範圍是 500 到 599。單位：計數有效的統計資訊：`Sum, Average`
UserErrorCount	使用者錯誤次數 (無效參數、無效影像、無權限等)。使用者錯誤的回應碼範圍是 400 到 499。單位：計數有效的統計資訊：`Sum,Average`
MinInferenceUnits	期間所指定的推論單位數下限。`StartProjectVersion`請求。單位：計數有效的統計資訊：`Average`
MaxInferenceUnits	期間所指定的推論單元數上限。`StartProjectVersion` 請求。單位：計數有效的統計資訊：`Average`
DesiredInferenceUnits	Rekognition 要向上或縮減的推論單位數目。單位：計數有效的統計資訊：`Average`
InServiceInferenceUnits	模型正在使用的推論單位數。單位：計數有效的統計資訊：`Average` 建議您使用「平均」統計資料來取得使用多少執行處理的 1 分鐘平均值。

CloudWatch Rekognition 串流的量度

Rekognition 也有用於串流作業的第二個命名空間，即「Rekognition 串流」。下表摘要「重要手段串流」測量結果。

指標	描述
SuccessfulRequestCount	成功請求的數量。成功請求的回應碼範圍是 200 到 299。單位：計數有效的統計資訊：`Sum,Average`
CallCount	在您的帳戶中執行的指定操作數目。有效的統計資訊：`Sum,Average`
ThrottledCount	已調節的請求數目。Rekognition 會在收到的要求數量超過您帳戶設定的每秒交易限制時，將會調節要求。如果經常超過為您的帳戶所設的限制，您可以請求提高上限。若要請求提高，請參閱 AWS Service Limits。單位：計數有效的統計資訊：`Sum,Average`
ServerErrorCount	伺服器錯誤的次數。伺服器錯誤的回應碼範圍是 500 到 599。單位：計數有效的統計資訊：`Sum, Average`
UserErrorCount	使用者錯誤次數 (無效參數、無效影像、無權限等)。使用者錯誤的回應碼範圍是 400 到 499。單位：計數有效的統計資訊：`Sum,Average`

CloudWatch 重要手段

若要擷取特定操作的指標，請使用 Rekognition 命名空間並提供操作維度。

如需維度的更多資訊，請參閱尺寸在亞馬遜 CloudWatch 使用者指南。

CloudWatch Rekognition 自訂標籤的維度

下表顯示 CloudWatch 可與 Rekognition 自訂標籤搭配使用的維度：

維度	描述
ProjectName	您使用建立的 Rekognition 自訂標籤專案的名稱`CreateProject`。
VersionName	您使用建立的 Rekognition 自訂標籤專案版本名稱`CreateProjectVersion`。