翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# パフォーマンス評価の失敗イベントをモニタリングする
EventBridge と CloudWatch を使用して、自動評価の失敗と問い合わせ評価の S3 エクスポートをモニタリングできます。これらのイベントを使用して、障害を調査および修正できます。次のガイドは、パフォーマンス評価の失敗イベントをモニタリングするためのカスタム EventBridge ルールを作成するプロセスのウォークスルーです。
## Step-by-stepガイド
これは、 AWS コンソールで Amazon Connect が失敗した自動評価送信イベントと問い合わせ評価の失敗した S3 エクスポートをログに記録する EventBridge ルールを作成する方法のガイドです。
1. AWS アカウントにログインし、EventBridge コンソールに移動します。「バス」セクションの**「ルール**」を選択します。 ****
![\[EventBridge コンソールのバスセクションのルールタブ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/perf-eval-eventbridge-rules-tab.png)
1. デフォルトのイベントバスを選択した**ルールの作成**を選択します。
![\[デフォルトのイベントバスが選択されたルールの作成ボタン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/perf-eval-eventbridge-create-rule.png)
1. ルールに名前を付け、**ルールタイプのイベントパターンを持つ**ルールを選択します。[**次へ**] を選択します。
![\[ルール名とイベントパターンオプションが選択されたルール。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/perf-eval-eventbridge-rule-name.png)
1. イベントで **AWS イベントまたは EventBridge パートナーイベント**を選択し、**イベント**パターンでパターン**フォームを使用する**オプションを選択します。 ****ここでは、ルールのトリガーに一致するパターンを定義します。
1. **AWS サービス**ドロップダウンで **Amazon Connect** と入力して選択し、イベントタイプを絞り込みます。以下のドロップダウンで目的のイベントタイプを選択します。パターンがセットアップされたら**次へ**を選択します。
EventBridge イベントタイプにサブスクライブするには、次の条件を満たすカスタム EventBridge ルールを作成します。
+ `"source"` = `"aws.connect"`
+ `"detail-type"` の値は次のいずれかを指定できます。
+ `"Contact Lens Automated Evaluation Submission Failed"`
+ `"Contact Lens Evaluation Export Failed"`
![\[Amazon Connect が AWS サービスとして選択されたイベントパターン。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/perf-eval-eventbridge-event-pattern.png)
1. 次のステップでは、一致したイベントを処理/受信するようにターゲット (複数可) を設定できます。わかりやすくするために、**「ターゲット**の選択」の**CloudWatch ロググループ**」オプションを選択し、ロググループを選択します。
1. **次**へを選択し、最後の**レビューと作成**ステップに進みます。**ルールの作成**をもう一度選択して、ルールの作成プロセスを完了します。
1. これで、ルールが有効****状態になり、一致するイベントが発生した場合、対応するログが、メタデータセクションの関連する IDs とデータセクションの失敗理由とともに、設定された CloudWatch ロググループに表示されます。
![\[一致した EventBridge イベントを示す CloudWatch ロググループ。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/perf-eval-cloudwatch-log-group.png)
![\[メタデータと失敗の理由を示す CloudWatch ログの詳細。\]](http://docs.aws.amazon.com/ja_jp/connect/latest/adminguide/images/perf-eval-cloudwatch-log-detail.png)
## EventBridge ペイロードの例
ルールが一致する EventBridge ペイロードの例を次に示します。
```
{
"version": "0",
"id": "00005435-d12d-c93b-d9d2-b64cba85fbb6",
"detail-type": "Contact Lens Automated Evaluation Submission Failed",
"source": "aws.connect",
"account": "Your AWS account ID",
"time": "2025-10-02T10:34:56Z",
"region": "us-west-2",
"resources": [],
"detail": {
"version": "1.0.0",
"metadata": {
"contactId": "4266f8e9-8420-4ee7-96cd-515d2edae1f2",
"instanceId": "d9b0b09d-7dab-47e5-9f82-d6787fbc068c",
"formId": "8b1365bd-1415-41a9-a491-af226e1bda4e"
},
"data": {
"reasonCode": "ANALYSIS_FILE_ERROR",
"message": "Automated contact evaluation submission failed due to an error when searching/retrieving/parsing the analysis file."
}
}
}
```
## 一般的なエラー
複数回の再試行後にシステムが最終的に評価の処理に失敗すると、次のエラーが発生する可能性があります。
### 自動評価送信エラー
| エラー | エラーメッセージ |
| --- | --- |
| AUTOMATED\$1SUBMISSION\$1FAILED | 一部の質問に回答できなかったため、問い合わせ評価の自動送信に失敗しました。評価フォームまたは Amazon Connect ルール設定を確認してください。 |
| ANALYSIS\$1FILE\$1ERROR | 分析ファイルsearching/retrieving/parsing時にエラーが発生したため、問い合わせ評価の自動送信に失敗しました。 |
| INTERNAL\$1SERVER\$1ERROR | 内部サーバーエラーのため、問い合わせ評価の自動送信に失敗しました。処理の遅延が予想されます。 |
| QUOTA\$1EXCEEDED\$1ERROR | Gen AI を使用して問い合わせの評価質問に自動的に回答するための残りのクォータが不十分であるため、問い合わせ評価の自動送信に失敗しました。 |
### 評価 S3 エクスポートエラー
| エラー | エラーメッセージ |
| --- | --- |
| S3\$1BUCKET\$1ACCESS\$1DENIED | アクセス許可が不十分であるため、問い合わせ評価 JSON のエクスポートに失敗しました。 |
| S3\$1STORAGE\$1NOT\$1CONFIGURED | エクスポート S3 バケットがインスタンス用に設定されていません。 |
| INTERNAL\$1SERVER\$1ERROR | 内部サーバーエラーのため、問い合わせ評価 JSON エクスポートに失敗しました。エクスポートファイルの配信が遅れることが予想されます。 |