本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 监控 Amazon Textract
借助 CloudWatch，您可以获取个别 Amazon Textract 操作的指标，也可以获取账户的全局 Amazon Textract 指标。您可以使用指标跟踪基于 Amazon TExtractt 的解决方案的运行状况并设置警报，以便在一个或多个指标超出定义的阈值时通知您。例如，您可以查看已发生的服务器错误数的指标。您还可以查看特定 Amazon Textract 操作成功的次数的指标。要查看指标，您可以使用[Amazon CloudWatch](https://console.aws.amazon.com/cloudwatch/)，[AWS CLI](https://docs.aws.amazon.com/AmazonCloudWatch/latest/cli/)，或者[CloudWatch API](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).
## 将 CloudWatch 指标用于 Amazon Textract
要使用指标，您必须指定以下信息：
+ 指标维度或无维度。*维度* 是帮助您对某指标进行唯一标识的名称/值对。Amazon Textract 有一个名为的维度*运算*. 它提供了特定操作的指标。如果您未指定维度，则指标的范围限定为账户内的所有 Amazon Textract 操作。
+ 指标名称，如 `UserErrorCount`。
您可 Amazon Textract 用AWS 管理控制台，AWS CLI，或 CloudWatch API。您还可以通过某个 Amazon AWS 软件开发工具包 (SDK) 或 CloudWatch API 工具来使用 CloudWatch API。控制台将根据来自 CloudWatch API 的原始数据显示一系列图表。根据您的需求差异，您可能倾向于使用控制台中显示的图表，也可能倾向于检索自 API 的图表。
###
下面的列表显示这些指标的一些常见用途。这些是入门建议，并不全面。
| 如何？ | 相关指标 |
| --- | --- |
| 如何获知我的应用程序是否已达到每秒最大请求数？ | 监控 `ThrottledCount` 指标的 `Sum` 统计数据。 |
| 如何监控请求错误？ | 使用 `UserErrorCount` 指标的 `Sum` 统计数据。 |
| 如何查找请求总数？ | 使用 `ResponseTime` 指标的 `SampleCount` 统计数据。这包括任何导致错误的请求。如果您希望仅查看成功的操作调用，请使用 `SuccessfulRequestCount` 指标。 |
| 如何监控 Amazon Textract 操作调用的延迟？ | 使用 `ResponseTime` 指标。 |
您必须具有适当的 CloudWatch 权限才能使用 CloudWatch 监控 Amazon Textract。有关更多信息，请参阅 [Amazon CloudWatch 的身份验证和访问控制](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)。
## 访问 Amazon Textract 指标
以下示例显示如何通过 CloudWatch 控制台（AWS CLI和 CloudWatch API。
**要查看指标（控制台）**
1. 访问 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch)，打开 CloudWatch 控制台。
1. 选择**指标**，选择**所有指标**选项卡，然后选择**Amazon Textract**.
1. 选择**按操作**，然后选择指标。
例如，选择**StartDocumentAnalysis**衡量异步文档分析启动的次数的指标。
1. 选择日期范围的值。图表中显示指标计数。
**查看成功的指标`StartDocumentAnalysis`在一段时间内发出的操作调用 (CLI)**
+ 打开 AWS CLI 并输入以下命令：
```
aws cloudwatch get-metric-statistics \
--metric-name SuccessfulRequestCount \
--start-time 2019-02-01T00:00:00Z \
--period 3600 \
--end-time 2019-03-01T00:00:00Z \
--namespace AWS/Textract \
--dimensions Name=Operation,Value=StartDocumentAnalysis \
--statistics Sum
```
此示例显示一段时间内成功的 `StartDocumentAnalysis` 操作调用。有关更多信息，请参阅 [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/).
## 创建警报
您可以创建在警报改变状态时发送 Amazon Simple Notification Service (Amazon SNS) 消息的 CloudWatch 警报。告警会监控您指定的时间段内的某个指标。它在多个时间段内根据相对于给定阈值的指标值，执行一项或多项操作。操作是一个发送到 Amazon SNS 主题或 Auto Scaling 策略的通知。
警报只会调用操作进行持续的状态变更。CloudWatch 警报不会仅仅因为处于特定状态而调用操作。该状态必须改变并在指定数量的时间段内一直保持。
**设置警报 (控制台)**
1. 登录AWS 管理控制台并打开 CloudWatch 控制台，网址为 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。
1. 在导航窗格中，选择**Alarms**，然后选择**创建警报**. 此操作将打开**创建警报向导**.
1. 选择**选择指标**。
1. 在**所有指标**选项卡上，选择**Textract**.
1. 选择**按操作**，然后选择指标。
例如，选择**StartDocumentAnalysis**以针对最大数目的异步文档分析操作设置警报。
1. 选择 **Graphed metrics**（已绘制图表指标）选项卡。
1. 对于 **Statistic (统计数据)**，选择 **Sum (总计)**。
1. 选择**选择指标**。
1. 填写 **Name** 和 **Description**。对于 **Whenever**，选择 **>=**，然后输入您选择的最大值。
1. 如果您希望 CloudWatch 在达到警报状态时向您发送电子邮件，请为**无论何时发出警报：**，选择**状态是警报**. 要将警报发送到现有 Amazon SNS 主题，请为**发送通知到：**中，选择一个现有 SNS 主题。要为新的电子邮件订阅列表设置名称和电子邮件地址，请选择**新清单**. CloudWatch 会保存列表并将其显示在字段中，以便您可使用它来设置将来的警报。
**注意**
如果您使用**新清单**要创建一个新的 Amazon SNS 主题，必须先验证电子邮件地址，然后目标收件人才能接收通知。Amazon SNS 仅在警报进入警报状态时发送电子邮件。如果在验证电子邮件地址之前此警报状态发生了变化，那么目标收件人不会接收到通知。
1. 选择 **Create Alarm（创建告警）**。
**设置警报 (AWS CLI)**
+ 打开 AWS CLI 并输入以下命令。更改的值`alarm-actions`参数以引用您之前创建的 Amazon SNS 主题。
```
aws cloudwatch put-metric-alarm \
--alarm-name StartDocumentAnalysisUserErrors \
--alarm-description "Alarm when more than 10 StartDocumentAnalysys user errors occur within 5 minutes" \
--metric-name UserErrorCount \
--namespace AWS/Textract \
--statistic Sum \
--period 300 \
--threshold 10 \
--comparison-operator GreaterThanThreshold \
--evaluation-periods 1 \
--unit Count \
--dimensions Name=Operation,Value=StartDocumentAnalysis \
--alarm-actions arn:aws:sns:us-east-1:111111111111:alarmtopic
```
此示例显示如何为 5 分钟内出现 10 个以上的用户错误的情况创建警报，以便通过`StartDocumentAnalysis`. 有关更多信息，请参阅 [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/)*.