本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用亚马逊监控 Rekognition CloudWatch
借助 CloudWatch，您可以获取单个 Rekognition 操作的指标或账户的全局 Rekognition 指标。您可以使用指标来跟踪基于 Rekognition 的解决方案的运行状况，并设置警报，以便在一个或多个指标超出定义的阈值时通知您。例如，您可以查看已发生的服务器错误数的指标或已检测到的人脸数的指标。您还可以查看特定 Rekognition 操作成功的次数的指标。要查看指标，您可以使用[亚马逊 CloudWatch](https://console.aws.amazon.com/cloudwatch/) 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`。
你可以使用、或 API 获取 Rekognition AWS 管理控制台的监控数据。 AWS CLI CloudWatch 您也可以通过其中一个 Amazon AWS 软件开发套件 (SDKs) 或 CloudWatch API 工具来使用 API。 CloudWatch 控制台根据来自 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 的身份验证和访问控制](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)。
## 访问 Rekognition 指标
以下示例展示了如何使用 CloudWatch 控制台、 AWS CLI和 API 访问 Rekognition 指标。 CloudWatch
**要查看指标（控制台）**
1. 打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/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 SNS) Simple Notification Service 消息。警报会每隔一段时间（由您指定）监控一个指标，并根据相对于给定阈值的指标值每隔若干个时间段执行一项或多项操作。操作是一个发送到 Amazon SNS 主题或 Auto Scaling 策略的通知。
警报仅针对持续的状态变化调用操作。 CloudWatch 警报不会仅仅因为它们处于特定状态就调用操作。该状态必须改变并在指定数量的时间段内一直保持。
**设置警报（控制台）**
1. 登录 AWS 管理控制台 并打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。
1. 选择**创建警报**。**创建警报向导**随即启动。
1. 在 **Metrics with no dimensions** 指标列表中，选择 **Rekognition Metrics**，然后选择指标。
例如，选择 **DetectedFaceCount** 以设置检测到的人脸的最大数目的警报。
1. 在 **Time Range** 区域中，选择一个日期范围值，其中包括已调用的人脸检测操作。选择**下一步**。
1. 填写**名称**和**描述**。对于**每当**，选择 **>=**，然后输入您选择的最大值。
1. 如果 CloudWatch 要在达到警报状态时向您发送电子邮件，请在 “**每当此警报:**” 中选择 “**状态为警报**”。要将警报发送到现有 Amazon SNS 主题，对于**发送通知到：**，请选择现有 SNS 主题。要为新的电子邮件订阅列表设置姓名和电子邮件地址，请选择 C **reate topic** 会 CloudWatch 保存列表并将其显示在字段中，这样您就可以用它来设置 future 警报。
**注意**
如果您使用**创建主题**创建一个新 Amazon SNS 主题，那么电子邮件地址在计划收件人接收通知之前必须通过验证。Amazon SNS 仅在警报进入警报状态时发送电子邮件。如果在验证电子邮件地址之前警报状态发生了变化，那么目标收件人不会接收到通知。
1. 预览**警报预览**部分中的警报。选择**创建警报**。
**设置警报 (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/)*。
## CloudWatch Rekognition 的指标
本节包含有关适用于亚马逊 Rekognition 的亚马逊 CloudWatch 指标和*操作*维度的信息。
您也可以从 Rekognition 控制台查看 Rekognition 指标的聚合视图。有关更多信息，请参阅 [练习 4：查看聚合指标（控制台）](aggregated-metrics.md)。
### CloudWatch Rekognition 的指标
下表汇总了 Rekognition 指标。
| 指标 | 说明 |
| --- | --- |
| 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_cn/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` |
| MinInferenceUnits | StartProjectVersion 请求期间指定的最小推理单位数。单位：个有效统计数据：`Average` |
| MaxInferenceUnits | StartProjectVersion 请求期间指定的最大推理单位数。单位：个有效统计数据：`Average` |
| DesiredInferenceUnits | Rekognition 要增加或缩减到的推理单位数。 单位：个 有效统计数据：`Average` |
| InServiceInferenceUnits | 模型正在使用的推理单元数。 单位：个 有效统计数据：`Average` 建议您使用平均值统计数据，获取实例使用数量的 1 分钟平均值。 |
### CloudWatch Rekognition 直播的指标
Rekognition 还有第二个用于流式处理操作的命名空间，即“Rekognition 流式处理”。下表汇总了 Rekognition 流式处理指标。
| 指标 | 说明 |
| --- | --- |
| 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` |
### CloudWatch Rekognition 的维度
要检索操作特定的指标，请使用 `Rekognition` 命名空间并提供操作维度。
有关尺寸的更多信息，请参阅 *Amazon CloudWatch 用户指南*中的[尺寸](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)。
### CloudWatch Rekognition 自定义标签的尺寸
下表显示了可用于 Rekognition 自定义标签的 CloudWatch 尺寸：
****
| 维度 | 说明 |
| --- | --- |
| ProjectName | 您使用 CreateProject 创建的 Rekognition Custom Labels 项目的名称。 |
| VersionName | 您使用 CreateProjectVersion 创建的 Rekognition Custom Labels 项目版本的名称。 |
有关尺寸的更多信息，请参阅 *Amazon CloudWatch 用户指南*中的[尺寸](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)。