本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 监控 Amazon Translate
监控是维护 Amazon Translate 和您的解决方案的可靠性、可用性和性能的重要组成部分。 AWS 提供了可用于监控 Amazon Translate 的各种工具。您可以配置其中的一些工具来为您监控解决方案。建议您尽可能实现监控任务自动化。
Amazon Translate 提供了预配置图表，可向您展示对您的解决方案最重要的指标。每个图表提供一个了解您的解决方案性能的窗口。要获取您的解决方案随着时间的推移如何表现的不同视角，您可以更改这些图表显示的时间范围。
您也可以使用亚马逊 CloudWatch 来监控 Amazon Translate。借 CloudWatch助，您可以自动监控解决方案的特定指标。只要某个指标超出您设定的阈值，您就会收到一条通知。您还可以使用 CloudWatch API 创建适合您需求的自定义监控应用程序。有关更多信息，请参阅《[亚马逊 CloudWatch 用户指南》 CloudWatch中的 “什么是](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html)*亚马逊*”。
下表介绍了 Amazon Translate 提供的每个预配置图表。
| 图表 | 说明 |
| --- | --- |
| ![\[显示成功请求计数的图表。\]](http://docs.aws.amazon.com/zh_cn/translate/latest/dg/images/metric-successful-request-count.png) | 成功请求计数 指定时间段内向 Amazon Translate 发出的成功请求数。 |
| ![\[显示受限制的请求计数的图表。\]](http://docs.aws.amazon.com/zh_cn/translate/latest/dg/images/metric-throttled-request-count.png) | 受限请求计数指定时间段内 Amazon Translate 收到的受限请求数。使用此信息确定您的应用程序是否太快向 Amazon Translate 发送请求。 |
| ![\[该图显示了平均响应时间。\]](http://docs.aws.amazon.com/zh_cn/translate/latest/dg/images/metric-average-response-time.png) | 平均响应时间 指定时间段内 Amazon Translate 处理您的请求所花费的平均时长。 |
| ![\[显示字符数的图表。\]](http://docs.aws.amazon.com/zh_cn/translate/latest/dg/images/metric-character-count.png) | 字符计数指定时间段内您发送给 Amazon Translate 的字符总数。这是您要支付的字符数。 |
| ![\[显示用户错误计数的图表。\]](http://docs.aws.amazon.com/zh_cn/translate/latest/dg/images/metric-user-error-count.png) | 用户错误计数指定时间段内发生的用户错误数。用户错误位于 HTTP 错误代码范围 400-499。 |
| ![\[显示系统错误计数的图表。\]](http://docs.aws.amazon.com/zh_cn/translate/latest/dg/images/metric-system-error-count.png) | 系统错误计数指定时间段内发生的系统错误数。系统错误位于 HTTP 错误代码范围 500-599。 |
## 监控 Amazon Translate
通过亚马逊 CloudWatch，您可以获取各个亚马逊翻译业务的指标或您账户的全球亚马逊翻译指标。使用指标跟踪 Amazon Translate 解决方案的运行状况并设置警报，以便在一个或多个指标超出定义的阈值时通知您。例如，您可以监控在特定的时间段内发送给 Amazon Translate 的请求数量、查看请求的延迟，或在错误数超出阈值时发出警报。
### 了解 Amazon T CloudWatch ranslate 的指标
要获取 Amazon Translate 操作的指标，请指定以下信息：
+ 指标维度。*维度* 是用来标识指标的一组名称/值对。Amazon Translate 有两个维度：
+ `Operation`
+ `Language pair`
+ 指标名称，如 `SuccessfulRequestCount` 或 `RequestCharacters`。要获得指标的完整列表，请参阅 [CloudWatch Amazon Translate 的指标](translate-cloudwatch.md#translate-cloudwatch-metrics)。
您可以通过 AWS 管理控制台、或 CloudWatch API 获取 Amazon Trans AWS CLI late 的指标。您可以通过其中一个 Amazon AWS 软件开发套件 (SDKs) 或 CloudWatch API 工具来使用 API。 CloudWatch
下表列出了 CloudWatch 指标的一些常见用途。这些是入门建议，并不全面。
| 如何？ | 监控此指标 |
| --- | --- |
| 跟踪成功请求数 | SuccessfulRequestCount 指标的 sum 统计数据 |
| 了解应用程序是否已达到其最大吞吐量 | ThrottledCount 指标的 sum 统计数据 |
| 查找应用程序的响应时间 | ResponseTime 指标的 average 统计数据 |
| 查找应用程序的错误数 | ServerErrorCount 和 UserErrorCount 指标的 sum 统计数据 |
| 查找计费字符数 | CharacterCount 指标的 sum 统计数据 |
您必须拥有相应的 CloudWatch 权限才能监控 Amazon Translate。 CloudWatch 有关更多信息，请参阅亚马逊* CloudWatch 用户指南 CloudWatch中的亚马逊*[身份验证和访问控制](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)。
### 查看 Amazon Translate 指标
在 CloudWatch 控制台中查看 Amazon Translate 指标。
**查看指标（CloudWatch 控制台）**
1. 登录 AWS 管理控制台 并打开 CloudWatch 控制台，网址为[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)。
1. 依次选择**指标**、**全部指标**和 **AWS/Translate**。
1. 选择维度、指标名称，然后选择**添加到图表**。
1. 选择日期范围的值。指定日期范围的指标计数将显示在该图表中。
# 使用记录 Amazon Translate API 调用 AWS CloudTrail
Amazon Translate 与 AWS CloudTrail一项服务集成，该服务提供 IAM 实体或 AWS 服务在 Amazon Translate 中采取的操作的记录。 CloudTrail 将 Amazon Translate 的所有 API 调用捕获为事件。这包含来自 Amazon Translate 控制台的调用和对 Amazon Translate API 操作的代码调用。如果您创建 CloudTrail 跟踪，则可以将 CloudTrail 事件（包括 Amazon Translate 的事件）持续传输到亚马逊简单存储服务 (Amazon S3) 存储桶。如果您未配置跟踪，您仍然可以在 CloudTrail 控制台的 “事件**历史记录” 中查看最新的事件**。您可以使用收集的信息 CloudTrail 来确定向 Amazon Translate 发出的请求、发出请求的 IP 地址、谁提出了请求、何时提出请求以及其他详细信息。
要了解更多信息 CloudTrail，请参阅《[AWS CloudTrail 用户指南》](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。
**Topics**
+ [Amazon Translate 中的信息 CloudTrail](#translate-info-in-cloudtrail)
+ [了解 Amazon Translate 日志文件条目](#understanding-translate-entries)
## Amazon Translate 中的信息 CloudTrail
CloudTrail 在您创建 AWS 账户时已在您的账户上启用。当 Amazon Translate 中发生活动时，该活动会与其他 AWS 服务 CloudTrail 事件一起记录在**事件历史**记录中。您可以在自己的 AWS 账户中查看、搜索和下载最近发生的事件。有关更多信息，请参阅[使用事件历史记录查看 CloudTrail 事件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)。
要持续记录您的 AWS 账户中的事件，包括 Amazon Translate 的事件，请创建跟踪。*跟踪*允许 CloudTrail 将日志文件传输到 Amazon S3 存储桶。默认情况下，在使用控制台创建跟踪时，此跟踪应用于所有 AWS 区域。跟踪记录 AWS 分区所有区域的事件，将日志文件传送至指定的 S3 存储桶。您可以配置其他 AWS 服务，以进一步分析和处理 CloudTrail 日志中收集的事件数据。有关更多信息，请参阅下列内容：
+ [创建跟踪记录概述](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [ CloudTrail 支持的服务和集成](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [配置 Amazon SNS 通知 CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [接收来自多个区域的 CloudTrail 日志文件和接收](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)[来自多个账户的 CloudTrail 日志文件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
所有 Amazon Translate 操作均由 [API 参考部分](https://docs.aws.amazon.com/translate/latest/dg/API_Operations.html)记录 CloudTrail 并记录在案。例如，调用`ImportTerminology`和`TranslateText`操作会在 CloudTrail 日志文件中生成条目。`DeleteTerminology`
每个事件或日志条目都包含有关生成请求的人员信息。此信息可帮助您确定以下内容：
+ 请求是使用根用户凭证还是根用户凭证发出的
+ 请求是使用角色还是联合用户的临时安全凭证发出的
+ 请求是否由其他 AWS 服务发出
有关更多信息，请参阅 [CloudTrail userIdentity 元素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)。
## 了解 Amazon Translate 日志文件条目
*跟踪*是一种配置，允许将事件作为日志文件传输到您指定的 Amazon S3 存储桶。 CloudTrail 日志文件包含一个或多个日志条目。事件代表来自任何来源的单个请求，包括有关请求的操作、操作的日期和时间、请求参数等的信息。 CloudTrail 日志文件不是公共 API 调用的有序堆栈跟踪，因此它们不会按任何特定的顺序出现。
以下示例显示了演示该`TranslateText`操作的 CloudTrail 日志条目。
```
{
"eventVersion": "1.05",
"userIdentity": {
"type": "IAMUser",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::111122223333:user/Administrator",
"accountId": "111122223333",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"userName": "Administrator"
},
"eventTime": "2019-09-03T20:32:50Z",
"eventSource": "translate.amazonaws.com",
"eventName": "TranslateText",
"awsRegion": "us-west-2",
"sourceIPAddress": "192.0.2.0",
"userAgent": "aws-cli/1.16.207 Python/3.4.7 Linux/4.9.184-0.1.ac.235.83.329.metal1.x86_64 botocore/1.12.197",
"requestParameters": {
"text": "HIDDEN_DUE_TO_SECURITY_REASONS",
"sourceLanguageCode": "en",
"targetLanguageCode": "fr"
},
"responseElements": {
"translatedText": "HIDDEN_DUE_TO_SECURITY_REASONS",
"sourceLanguageCode": "en",
"targetLanguageCode": "fr"
},
"requestID": "f56da956-284e-4983-b6fc-59befa20e2bf",
"eventID": "1dc75278-84d7-4bb2-861a-493d08d67391",
"eventType": "AwsApiCall",
"recipientAccountId": "111122223333"
}
```
# CloudWatch Amazon Translate 的指标和维度
要监控解决方案的性能，请使用 Amazon Translate 的亚马逊 CloudWatch 指标和维度。
## CloudWatch Amazon Translate 的指标
| 指标 | 说明 |
| --- | --- |
| CharacterCount | 请求中的计费字符数。 有效维度：语言对、操作 有效统计数据：平均值、最大值、最小值、总计 单位：个 |
| ResponseTime | 响应请求所花费的时间。 有效维度：语言对、操作 有效统计数据：数据采样、平均值 单位：对于数据采样，计数。对于平均值统计数据，毫秒。 |
| ServerErrorCount | 服务器错误的数量。服务器错误的 HTTP 响应代码范围为 500 到 599。 有效维度：操作 有效统计数据：Average、Sum 单位：个 |
| SuccessfulRequestCount | 成功翻译请求数。成功请求的响应代码为 200 至 299。 有效维度：操作 有效统计数据：Average、Sum 单位：个 |
| ThrottledCount | 遭受节流的请求数。使用 `ThrottledCount` 确定您的应用程序向 Amazon Translate 发送请求的速度是否比您的账户被配置为接受请求的速度更快。有关更多信息，请参阅 [https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_amazon_translate](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_amazon_translate)* 中的Amazon Web Services 一般参考 Amazon Translate 限制*。 有效维度：操作 有效统计数据：Average、Sum 单位：个 |
| UserErrorCount | 发生的用户错误数。用户错误的 HTTP 响应代码范围为 400 到 499。 有效维度：操作 有效统计数据：Average、Sum 单位：个 |
## CloudWatch Amazon Translate 的尺寸
使用以下维度可筛选 Amazon Translate 指标。指标按源语言和目标语言分组。
| 维度 | 说明 |
| --- | --- |
| LanguagePair | 仅限包含指定语言的指标。 |
| Operation | 仅限包含指定操作的指标。 |
# 使用亚马逊监控 Amazon Translate 事件 EventBridge
Amazon Trans EventBridge late 与亚马逊集成，可通知您有关影响您的翻译任务和并行数据资源的更改。来自 AWS 服务的事件几乎实时 EventBridge 地传送到。您可以编写简单规则来指示您关注的事件，并指示要在事件匹配规则时执行的自动化操作。例如，可自动启动的操作包括：
+ 调用函数 AWS Lambda
+ 调用 AWS Systems Manager 运行命令
+ 将事件中继到 Amazon Kinesis Data Streams
+ 激活 AWS Step Functions 状态机
+ 通知 Amazon SNS 主题或 Amazon SQS 队列
有关更多信息，请参阅[ EventBridge 《亚马逊* EventBridge 用户指南》中的创建对事件做出反应的亚马逊*规则](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)。
## Amazon Translate 事件
以下是来自 Amazon Translate 的示例事件。
### 批量翻译任务的事件
您可以使用 Amazon Translate 控制台或[StartTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_StartTextTranslationJob.html)操作来运行批量翻译作业。在这些作业完成时，无论成功还是失败，Amazon Translate 都会发送事件。这些事件与以下示例类似。
```
{
"version": "0",
"id": "CWE-event-id",
"detail-type": "Translate TextTranslationJob State Change",
"source": "aws.translate",
"account": "111122223333",
"time": "2017-04-22T03:31:47Z",
"region": "us-east-1",
"resources": [],
"detail": {
"jobId": "01234567-0123-0123-0123-012345678901",
"jobStatus": "STATUS"
}
}
```
`jobStatus` 属性的值取决于接收 Amazon Translate 所发送事件的任务状态。`jobStatus` 值为：
+ `COMPLETED` – 作业已成功完成，并且输出可用。
+ `COMPLETED_WITH_ERROR` – 作业已完成，但出现错误。您可以在作业的输出中分析错误。
+ `STOPPED` – 任务已停止。
+ `FAILED` – 任务未完成。要获取详细信息，请使用[DescribeTextTranslationJob](https://docs.aws.amazon.com/translate/latest/APIReference/API_DescribeTextTranslationJob.html)操作。
### 并行数据资源的事件
在您使用 Amazon Translate 创建或更新并行数据资源时，该服务会发送一个事件来指示操作是成功还是失败。
您可以使用 Amazon Translate 控制台或[CreateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_CreateParallelData.html)操作创建并行数据资源。在您执行此操作时，Amazon Translate 会发送如下所示的事件。
```
{
"version": "0",
"id": "CWE-event-id",
"detail-type": "Translate Parallel Data State Change",
"source": "aws.translate",
"account": "111122223333",
"time": "2017-04-22T03:31:47Z",
"region": "us-east-1",
"resources": [arn:aws:translate:us-east-1:111122223333:parallel-data/ExampleParallelData],
"detail": {
"operation": "CreateParallelData",
"name": "ExampleParallelData",
"status": "STATUS"
}
}
```
`status` 属性的值为：
+ `ACTIVE` – `CreateParallelData ` 操作成功，资源已准备就绪，可供您使用。
+ `FAILED` – `CreateParallelData` 操作失败。
您可以使用 Amazon Translate 控制台或[UpdateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_UpdateParallelData.html)操作来更新并行数据资源。在您执行此操作时，Amazon Translate 会发送如下所示的事件。
```
{
"version": "0",
"id": "CWE-event-id",
"detail-type": "Translate Parallel Data State Change",
"source": "aws.translate",
"account": "111122223333",
"time": "2017-04-22T03:31:47Z",
"region": "us-east-1",
"resources": [arn:aws:translate:us-east-1:111122223333:parallel-data/ExampleParallelData],
"detail": {
"operation": "UpdateParallelData",
"name": "ExampleParallelData",
"status": "STATUS",
"latestUpdateAttemptStatus": "STATUS",
"latestUpdateAttemptAt": "2017-04-22T03:31:47Z"
}
}
```
`status` 属性提供并行数据资源先前版本的状态，该版本正在通过更新替换。值为：
+ `ACTIVE` – 先前版本已成功创建或更新。
+ `FAILED` – 创建或更新先前版本失败。
`latestUpdateAttemptStatus` 属性提供并行数据资源新版本的状态，该版本正在通过更新创建。值为：
+ `ACTIVE` – `UpdateParallelData` 操作成功，更新后的资源已准备就绪，可供您使用。
+ `FAILED` – `UpdateParallelData` 操作失败。