本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 監控 Amazon Translate
監控是維護 Amazon Translate 和 解決方案可靠性、可用性和效能的重要部分。 AWS 提供各種工具，可讓您用來監控 Amazon Translate。您可以設定其中一些工具，為您監控解決方案。建議您盡可能自動化監控任務。
Amazon Translate 提供預先設定的圖表，顯示解決方案最重要的指標。每個圖形都會提供一個視窗，顯示您解決方案的效能。若要取得您的解決方案如何隨時間執行的不同檢視，您可以變更圖形顯示的時間範圍。
您也可以使用 Amazon CloudWatch 來監控 Amazon Translate。使用 CloudWatch，您可以自動化監控解決方案的特定指標。每當您設定的指標超出閾值，就會收到通知。您也可以使用 CloudWatch API 來建立適合您需求的自訂監控應用程式。如需詳細資訊，請參閱《*Amazon CloudWatch 使用者指南*》中的[什麼是 Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html)。
下表說明 Amazon Translate 提供的每個預先設定圖形。
| 圖表 | Description |
| --- | --- |
| ![\[顯示成功請求計數的圖表。\]](http://docs.aws.amazon.com/zh_tw/translate/latest/dg/images/metric-successful-request-count.png) | 成功請求計數 在指定期間內對 Amazon Translate 提出的成功請求數量。 |
| ![\[顯示調節請求計數的圖表。\]](http://docs.aws.amazon.com/zh_tw/translate/latest/dg/images/metric-throttled-request-count.png) | 已調節請求計數在指定期間內對 Amazon Translate 限流的請求數量。使用此資訊來判斷您的應用程式是否太快將請求傳送至 Amazon Translate。 |
| ![\[顯示平均回應時間的圖表。\]](http://docs.aws.amazon.com/zh_tw/translate/latest/dg/images/metric-average-response-time.png) | 平均回應時間 Amazon Translate 在指定期間內處理您的請求所需的平均時間長度。 |
| ![\[顯示字元計數的圖形。\]](http://docs.aws.amazon.com/zh_tw/translate/latest/dg/images/metric-character-count.png) | 字元計數您在指定期間內傳送至 Amazon Translate 的字元總數。這是您將付費的字元數。 |
| ![\[顯示使用者錯誤計數的圖表。\]](http://docs.aws.amazon.com/zh_tw/translate/latest/dg/images/metric-user-error-count.png) | 使用者錯誤計數在指定時段發生的使用者錯誤數目。使用者錯誤位於 HTTP 錯誤碼範圍 400-499 內。 |
| ![\[顯示系統錯誤計數的圖表。\]](http://docs.aws.amazon.com/zh_tw/translate/latest/dg/images/metric-system-error-count.png) | 系統錯誤計數在指定時段發生的系統錯誤數目。系統錯誤位於 HTTP 錯誤碼範圍 500-599 內。 |
## 監控 Amazon Translate
使用 Amazon CloudWatch，您可以取得個別 Amazon Translate 操作的指標或帳戶的全域 Amazon Translate 指標。使用指標來追蹤 Amazon Translate 解決方案的運作狀態，並設定警示，在一或多個指標超出定義的閾值時通知您。例如，您可以監控在特定期間內對 Amazon Translate 提出的請求數量、查看請求的延遲，或在錯誤超過閾值時發出警示。
### 了解 Amazon Translate 的 CloudWatch 指標
若要取得 Amazon Translate 操作的指標，請指定下列資訊：
+ 指標維度。*維度*是一組用來識別指標的名稱與數值對。Amazon Translate 有兩個維度：
+ `Operation`
+ `Language pair`
+ 指標名稱，例如 `SuccessfulRequestCount` 或 `RequestCharacters`。如需指標的完整清單，請參閱[Amazon Translate 的 CloudWatch 指標](translate-cloudwatch.md#translate-cloudwatch-metrics)。
您可以使用 AWS 管理主控台、 AWS CLI或 CloudWatch API 取得 Amazon Translate 的指標。您可以透過其中一個 Amazon AWS 軟體開發套件 (SDKs) 或 CloudWatch API 工具來使用 CloudWatch API。
下表列出 CloudWatch 指標的一些常見用途。這些是協助您開始的建議，而不是完整清單。
| 運作方式？ | 監控此指標 |
| --- | --- |
| 追蹤成功請求的數目 | SuccessfulRequestCount 指標的 sum 統計資料 |
| 了解我的應用程式是否已經達到最大傳輸量 | ThrottledCount 指標的 sum 統計資料 |
| 尋找應用程式的回應時間 | ResponseTime 指標的 average 統計資料 |
| 尋找應用程式的錯誤數目 | ServerErrorCount 和 UserErrorCount 指標的 sum 統計資料 |
| 尋找應計費字元數目 | CharacterCount 指標的 sum 統計資料 |
您必須擁有適當的 CloudWatch 許可，以使用 CloudWatch 監控 Amazon Translate 如需詳細資訊，請參閱《[Amazon CloudWatch 使用者指南》中的 Amazon CloudWatch 的身分驗證和存取控制](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)。 *Amazon CloudWatch *
### 檢視 Amazon Translate 指標
在 CloudWatch 主控台中檢視 Amazon Translate 指標。
**若要檢視指標 (CloudWatch 主控台)**
1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) 開啟 CloudWatch 主控台。
1. 選擇 **Metrics (指標)**、選擇 **All Metrics (所有指標)**，然後選擇 **AWS/Translate (AWS/翻譯)**。
1. 選擇維度、選擇指標名稱，然後選擇 **Add to graph (新增至圖形)**。
1. 選擇日期範圍的值。所指定日期範圍的指標計數會顯示在圖形中。
# 使用 記錄 Amazon Translate API 呼叫 AWS CloudTrail
Amazon Translate 已與 整合 AWS CloudTrail，此服務提供 Amazon Translate 中 IAM 實體 AWS 或服務所採取動作的記錄。CloudTrail 會將 Amazon Translate 的所有 API 呼叫擷取為事件。這包括從 Amazon Translate 主控台進行的呼叫，以及對 Amazon Translate API 操作的程式碼呼叫。如果您建立 CloudTrail 追蹤，您可以啟用 CloudTrail 事件持續交付至 Amazon Simple Storage Service (Amazon S3) 儲存貯體，包括 Amazon Translate 的事件。即使您未設定追蹤，依然可以透過 CloudTrail 主控台中的**事件歷史記錄**檢視最新事件。您可以使用 CloudTrail 收集的資訊來判斷對 Amazon Translate 提出的請求、提出請求的 IP 地址、提出請求的人員、提出請求的時間，以及其他詳細資訊。
若要進一步了解 CloudTrail，請參閱[「AWS CloudTrail 使用者指南」](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。
**Topics**
+ [CloudTrail 中的 Amazon Translate 資訊](#translate-info-in-cloudtrail)
+ [了解 Amazon Translate 日誌檔案項目](#understanding-translate-entries)
## CloudTrail 中的 Amazon Translate 資訊
當您建立 AWS 帳戶時，會在您的帳戶上啟用 CloudTrail。當 Amazon Translate 中發生活動時，該活動會與**事件歷史記錄**中的其他 AWS 服務事件一起記錄在 CloudTrail 事件中。您可以在 AWS 帳戶中檢視、搜尋和下載最近的事件。如需詳細資訊，請參閱《使用 CloudTrail 事件歷史記錄檢視事件》[https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html](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)
+ [設定 CloudTrail 的 Amazon SNS 通知](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)
CloudTrail 會記錄所有 Amazon Translate 動作，並記錄在 [API 參考區段](https://docs.aws.amazon.com/translate/latest/dg/API_Operations.html)中。例如，對 `DeleteTerminology`、`ImportTerminology` 和 `TranslateText` 動作發出的呼叫會在 CloudTrail 記錄檔案中產生專案。
每一筆事件或日誌專案都會包含產生請求者的資訊。此資訊可協助您判斷下列事項：
+ 是否使用根使用者登入資料提出請求
+ 提出該請求時，是否使用了特定角色或聯合身分使用者的臨時安全憑證
+ 請求是否由其他 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"
}
```
# Amazon Translate 的 CloudWatch 指標和維度
若要監控解決方案的效能，請使用 Amazon CloudWatch 指標和 Amazon Translate 的維度。
## Amazon Translate 的 CloudWatch 指標
| 指標 | Description |
| --- | --- |
| CharacterCount | 請求中的計費字元數。 有效維度：語言對、操作 有效統計資料：平均、最大值、最小值、總和 單位：計數 |
| ResponseTime | 回應請求所花費的時間。 有效維度：語言對、操作 有效統計資料：資料範例、平均 單位：對於資料範例，計數。對於平均統計資料，毫秒。 |
| ServerErrorCount | 伺服器錯誤的次數。伺服器錯誤的 HTTP 回應碼範圍為 500 到 599。 有效維度：操作 有效的統計資訊：平均、總和 單位：計數 |
| SuccessfulRequestCount | 成功轉譯請求的數量。成功請求的回應碼為 200 到 299。 有效維度：操作 有效的統計資訊：平均、總和 單位：計數 |
| ThrottledCount | 需要限流的請求數量。使用 `ThrottledCount` 來判斷您的應用程式向 Amazon Translate 傳送請求的速度是否比您的帳戶設定接受請求的速度更快。如需詳細資訊，請參閱[《》中的 Amazon Translate 限制](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_amazon_translate)*Amazon Web Services 一般參考*。 有效維度：操作 有效的統計資訊：平均、總和 單位：計數 |
| UserErrorCount | 發生的使用者錯誤數目。使用者錯誤的 HTTP 回應碼範圍是 400 到 499。 有效維度：操作 有效的統計資訊：平均、總和 單位：計數 |
## Amazon Translate 的 CloudWatch 維度
使用以下維度篩選 Amazon Translate 指標。指標會依來源語言和目標語言分組。
| 維度 | Description |
| --- | --- |
| LanguagePair | 將指標限制為僅包含指定語言的指標。 |
| Operation | 將指標限制為只有具有指定操作的指標。 |
# 使用 Amazon EventBridge 監控 Amazon Translate 事件 EventBridge
Amazon Translate 與 Amazon EventBridge 整合，以通知您影響翻譯任務和平行資料資源的變更。來自 AWS 服務的事件會以近乎即時的方式交付至 EventBridge。您可編寫簡單的規則，來指示您在意的事件，以及當事件符合規則時所要自動執行的動作。例如，可自動啟動的動作包括：
+ 叫用 AWS Lambda 函數
+ 叫用 AWS Systems Manager Run 命令
+ 將事件轉傳至 Amazon Kinesis Data Streams
+ 啟用 AWS Step Functions 狀態機器
+ 通知 Amazon SNS 主題或 Amazon SQS 佇列
如需詳細資訊，請參閱*「Amazon EventBridge 使用者指南」*中的[建立對事件做出反應的 Amazon 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`操作失敗。