翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Translate のモニタリング
モニタリングは、Amazon Translate と ソリューションの信頼性、可用性、パフォーマンスを維持する上で重要な部分です。 は、Amazon Translate のモニタリングに使用できるさまざまなツール AWS を提供します。こうしたツールをいくつか設定することで、ソリューションのモニタリングをカスタマイズできます。モニタリングタスクをできるだけ自動化することをお勧めします。
Amazon Translate はソリューションでもっとも重要なメトリクスを表示する事前設定済みのグラフを提供します。各グラフはソリューションのパフォーマンス概要を示しています。ソリューションパフォーマンスの経時的な違いを見るためには、グラフで表示する時間範囲を変更できます。
また、Amazon CloudWatch を使用して、Amazon Translate をモニタリングすることもできます。CloudWatch を使用すると、ソリューションの特定のメトリクスのモニタリングを自動化できます。メトリクスが設定したしきい値の外にある場合は通知が届きます。CloudWatch API を使用して、ご自分のニーズに合わせたカスタムモニタリングアプリケーションを作成できます。詳細については、[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatch.html)の「*Amazon CloudWatch とは*」を参照してください。
次の表は Amazon Translate が提供する事前設定済みのグラフをそれぞれ説明したものです。
| グラフ | 説明 |
| --- | --- |
| ![\[成功したリクエスト数を示すグラフ。\]](http://docs.aws.amazon.com/ja_jp/translate/latest/dg/images/metric-successful-request-count.png) | 成功したリクエストカウント 指定した期間中に成功した Amazon Translate へのリクエスト数です。 |
| ![\[スロットリングされたリクエスト数を示すグラフ。\]](http://docs.aws.amazon.com/ja_jp/translate/latest/dg/images/metric-throttled-request-count.png) | 調整済みリクエストカウント指定した期間中に調整した Amazon Translate へのリクエスト数です。この情報を使用してアプリケーションが Amazon Translate にリクエストを送信するのが早すぎるか判断します。 |
| ![\[平均応答時間を示すグラフ。\]](http://docs.aws.amazon.com/ja_jp/translate/latest/dg/images/metric-average-response-time.png) | 平均応答時間 Amazon Translate が指定期間中にリクエストを処理した平均時間です。 |
| ![\[文字数を示すグラフ。\]](http://docs.aws.amazon.com/ja_jp/translate/latest/dg/images/metric-character-count.png) | 文字数カウント指定した指定期間中に Amazon Translate へ送信した文字数の合計です。この合計数が請求されます。 |
| ![\[ユーザーエラー数を示すグラフ。\]](http://docs.aws.amazon.com/ja_jp/translate/latest/dg/images/metric-user-error-count.png) | ユーザーエラーカウント指定した期間中に発生したユーザーエラーの数です。ユーザーエラーは、HTTP エラーコード 400～499 の範囲内です。 |
| ![\[システムエラー数を示すグラフ。\]](http://docs.aws.amazon.com/ja_jp/translate/latest/dg/images/metric-system-error-count.png) | システムエラーカウント指定した期間中に発生したシステムエラーの数です。システムエラーは、HTTP エラーコード 500～599 の範囲内です。 |
## Amazon Translate のモニタリング
Amazon CloudWatch では、アカウントの個別の Amazon Translate オペレーションまたはグローバルな Amazon Translate メトリクスのメトリクスを取得できます。メトリクスを使用すると、Amazon Translate ソリューションの状態をトラッキングし、定義されているしきい値を 1 つ以上のメトリクスが超えた場合に通知するようにアラームをセットアップできます。たとえば、指定期間中に Amazon Translate に送信されたリクエスト数をモニタリングして、リクエストのレイテンシーを確認し、エラー数がしきい値を超えた場合はアラームを生成できます。
### Amazon Translate の CloudWatch メトリクスの概要
Amazon Translate オペレーションのメトリクスを取得するには、以下の情報を指定する必要があります。
+ メトリクスディメンション。*ディメンション*は、メトリクスを識別するための名前と値のペアのセットです。Amazon Translate には 2 つのディメンションがあります。
+ `Operation`
+ `Language pair`
+ メトリクス名 (`SuccessfulRequestCount`、`RequestCharacters` など)。メトリクスの一覧については、「[Amazon Translate の CloudWatch メトリクス](translate-cloudwatch.md#translate-cloudwatch-metrics)」を参照してください。
Amazon Translate のメトリクスは、 AWS マネジメントコンソール、、 AWS CLIまたは CloudWatch API を使用して取得できます。CloudWatch API は、いずれかの Amazon AWS Software Development Kit (SDK) または Amazon CloudWatch API ツールでも使用できます。
以下の表は、CloudWatch メトリクスの一般的な利用方法をいくつか示しています。ここで紹介するのは使用開始するための提案事項であり、総括的な一覧ではありません。
| どうすればよいか? | モニタリング対象のメトリクス |
| --- | --- |
| 成功したリクエストの数をトラッキングします | SuccessfulRequestCount のメトリクスの sum 統計 |
| アプリケーションが最大しきい値に到達した場合に通知します | ThrottledCount のメトリクスの sum 統計 |
| アプリケーションの応答時間を検索します | ResponseTime のメトリクスの average 統計 |
| アプリケーションのエラー数を見つけます | ServerErrorCount と UserErrorCount のメトリクスの sum 統計をモニタリングします。 |
| 請求可能な文字の数を検索します | CharacterCount のメトリクスの sum 統計 |
CloudWatch で Amazon Translate をモニタリングするには、CloudWatch への適切なアクセス許可が必要です。詳細については、*Amazon CloudWatch ユーザーガイド*の「[Amazon CloudWatch に対する認証とアクセスコントロール](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)」を参照してください。
### Amazon Translate メトリクスの表示
Amazon Translate コンソールにメトリクスを表示します。
**メトリクスを表示する方法 (CloudWatch コンソール)**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) で CloudWatch コンソールを開きます。
1. [**Metrics**] で、[**All Metrics**]、[**AWS/Translate**] の順に選択します。
1. ディメンションを選択して、メトリクスの名前を選び [**Add to graph**] を選択します。
1. 日付範囲の値を選択します。指定した日付範囲のメトリクスカウントがグラフに表示されます。
# を使用した Amazon Translate API コールのログ記録 AWS CloudTrail
Amazon Translate は AWS CloudTrail、Amazon Translate の IAM エンティティまたはサービスによって実行されたアクションを記録する AWS サービスである Amazon Translate と統合されています。CloudTrail は、Amazon Translate へのすべての API コールをイベントとしてキャプチャします。これには、Amazon Translate コンソールからのコールと、Amazon Translate API オペレーションへのコードコールが含まれます。CloudTrail 追跡を作成すると、Amazon Simple Storage Service (Amazon S3) バケットへの Amazon Translate イベントなど、CloudTrail のイベントの継続的な配信が可能になります。証跡を設定しない場合でも、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 の情報
CloudTrail は、 AWS アカウントの作成時にアカウントで有効になります。Amazon Translate でアクティビティが発生すると、そのアクティビティはイベント**履歴**の他の AWS サービスイベントとともに CloudTrail イベントに記録されます。 AWS アカウントで最近のイベントを表示、検索、ダウンロードできます。詳細については、[CloudTrail イベント履歴でのイベントの表示](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)を参照してください。
Amazon Translate のイベントなど、 AWS アカウント内のイベントの継続的な記録については、証跡を作成します。*証跡*により、CloudTrail はログファイルを Amazon S3 バケットに配信できます。デフォルトでは、コンソールで作成した証跡がすべての AWS リージョンに適用されます。証跡では、 AWS パーティションのすべてのリージョンからのイベントがログに記録され、指定した S3 バケットにログファイルが配信されます。CloudTrail ログで収集されたイベントデータをさらに分析して処理するように、他の AWS サービスを設定できます。詳細については、次を参照してください:
+ [追跡を作成するための概要](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)
Amazon Translate のすべてのアクションは CloudTrail によってログとして記録され、[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 ログファイルエントリの概要
「トレイル」は、指定した Simple Storage Service (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 Translate の Amazon CloudWatch メトリクスとディメンションを使用します。
## Amazon Translate の CloudWatch メトリクス
| メトリクス | 説明 |
| --- | --- |
| CharacterCount | リクエスト内の請求可能な文字の数を検索します。 有効なディメンション: 言語ペア、オペレーション 有効な統計: 平均、最大、平均、合計 単位: 数 |
| ResponseTime | リクエストに応答するまでにかかった時間です。 有効なディメンション: 言語ペア、オペレーション 有効な統計: データサンプル、平均 単位: データサンプルの場合は個。平均統計の場合はミリ秒。 |
| ServerErrorCount | サーバーエラーの数。サーバーエラーの HTTP レスポンスコード範囲は 500〜599 です。 有効なディメンション: オペレーション 有効な統計: 合計、平均 単位: 数 |
| SuccessfulRequestCount | 成功した翻訳リクエストの数です。成功したリクエストのレスポンスコードは 200〜299 です。 有効なディメンション: オペレーション 有効な統計: 合計、平均 単位: 数 |
| ThrottledCount | スロットリングリクエスト件名の数です。`ThrottledCount` を使用して、アプリケーションによる Amazon Translate へのリクエストの送信速度が、アカウントでの受信設定よりも早いかどうかを判断します。詳細は「[Amazon Translate Limits](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 メトリクスをフィルターすることができます。メトリクスはソース言語とターゲット言語でグループ化されます。
| ディメンション | 説明 |
| --- | --- |
| LanguagePair | 特定の言語だけを含むようにメトリクスを制限します。 |
| Operation | 特定のオペレーションを使用するものだけにメトリクスを制限します。 |
# Amazon EventBridge による Amazon Translate イベントのモニタリング
Amazon Translate は Amazon EventBridge と統合されており、翻訳ジョブや並列データリソースに影響する変更に関する通知が行われます。 AWS サービスからのイベントは、ほぼリアルタイムで EventBridge に配信されます。簡単なルールを記述して、注目するイベントと、イベントがルールに一致した場合に自動的に実行するアクションを指定できます。たとえば、自動的に開始できるアクションには以下のようなものがあります。
+ AWS Lambda 関数の呼び出し
+ AWS Systems Manager Run Command の呼び出し
+ Amazon Kinesis Data Streams へのイベントの中継
+ AWS Step Functions ステートマシンのアクティブ化
+ Amazon SNS トピックまたは Amazon SQS キューの通知
EventBridge ルールの作成の詳細については、*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` オペレーションは失敗しました。