本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
借助 CloudWatch，您可以获取个别 Amazon Textract 操作的指标，也可以获取账户的全局 Amazon Textract 指标。您可以使用指标跟踪基于 Amazon TExtractt 的解决方案的运行状况并设置警报，以便在一个或多个指标超出定义的阈值时通知您。例如，您可以查看已发生的服务器错误数的指标。您还可以查看特定 Amazon Textract 操作成功的次数的指标。要查看指标，您可以使用Amazon CloudWatch
将 CloudWatch 指标用于 Amazon Textract
要使用指标，您必须指定以下信息：
-
指标维度或无维度。维度 是帮助您对某指标进行唯一标识的名称/值对。Amazon Textract 有一个名为的维度运算. 它提供了特定操作的指标。如果您未指定维度，则指标的范围限定为账户内的所有 Amazon Textract 操作。
-
指标名称，如
UserErrorCount。
您可 Amazon Textract 用AWS Management Console，AWS CLI，或 CloudWatch API。您还可以通过某个 Amazon AWS 软件开发工具包 (SDK) 或 CloudWatch API 工具来使用 CloudWatch API。控制台将根据来自 CloudWatch API 的原始数据显示一系列图表。根据您的需求差异，您可能倾向于使用控制台中显示的图表，也可能倾向于检索自 API 的图表。
下面的列表显示这些指标的一些常见用途。这些是入门建议，并不全面。
| 如何？ | 相关指标 |
|---|---|
|
如何获知我的应用程序是否已达到每秒最大请求数？ |
监控 |
|
如何监控请求错误？ |
使用 |
|
如何查找请求总数？ |
使用 |
|
如何监控 Amazon Textract 操作调用的延迟？ |
使用 |
您必须具有适当的 CloudWatch 权限才能使用 CloudWatch 监控 Amazon Textract。有关更多信息，请参阅 Amazon CloudWatch 的身份验证和访问控制。
访问 Amazon Textract 指标
以下示例显示如何通过 CloudWatch 控制台（AWS CLI和 CloudWatch API。
要查看指标（控制台）
-
访问 https://console.aws.amazon.com/cloudwatch/
，打开 CloudWatch 控制台。 -
选择指标，选择所有指标选项卡，然后选择Amazon Textract.
-
选择按操作，然后选择指标。
例如，选择StartDocumentAnalysis衡量异步文档分析启动的次数的指标。
-
选择日期范围的值。图表中显示指标计数。
查看成功的指标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。
访问指标 (CloudWatch API)
-
调用
GetMetricStatistics。有关更多信息，请参阅 。Amazon CloudWatch API 参考.
创建警报
您可以创建在警报改变状态时发送 Amazon Simple Notification Service (Amazon SNS) 消息的 CloudWatch 警报。告警会监控您指定的时间段内的某个指标。它在多个时间段内根据相对于给定阈值的指标值，执行一项或多项操作。操作是一个发送到 Amazon SNS 主题或 Auto Scaling 策略的通知。
警报只会调用操作进行持续的状态变更。CloudWatch 警报不会仅仅因为处于特定状态而调用操作。该状态必须改变并在指定数量的时间段内一直保持。
设置警报 (控制台)
-
登录AWS Management Console并打开 CloudWatch 控制台，网址为 https://console.aws.amazon.com/cloudwatch/
。 在导航窗格中，选择Alarms，然后选择创建警报. 此操作将打开创建警报向导.
选择选择指标。
在所有指标选项卡上，选择Textract.
-
选择按操作，然后选择指标。
例如，选择StartDocumentAnalysis以针对最大数目的异步文档分析操作设置警报。
选择 Graphed metrics（已绘制图表指标）选项卡。
对于 Statistic (统计数据)，选择 Sum (总计)。
选择选择指标。
-
填写 Name 和 Description。对于 Whenever，选择 >=，然后输入您选择的最大值。
-
如果您希望 CloudWatch 在达到警报状态时向您发送电子邮件，请为无论何时发出警报：，选择状态是警报. 要将警报发送到现有 Amazon SNS 主题，请为发送通知到：中，选择一个现有 SNS 主题。要为新的电子邮件订阅列表设置名称和电子邮件地址，请选择新清单. CloudWatch 会保存列表并将其显示在字段中，以便您可使用它来设置将来的警报。
注意
如果您使用新清单要创建一个新的 Amazon SNS 主题，必须先验证电子邮件地址，然后目标收件人才能接收通知。Amazon SNS 仅在警报进入警报状态时发送电子邮件。如果在验证电子邮件地址之前此警报状态发生了变化，那么目标收件人不会接收到通知。
-
选择 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。
设置警报 (CloudWatch API)
-
调用
PutMetricAlarm。有关更多信息，请参阅 。Amazon CloudWatch API 参考.
