Step-by-stepガイド EventBridge ペイロードの例一般的なエラー

パフォーマンス評価の失敗イベントをモニタリングする

EventBridge と CloudWatch を使用して、自動評価の失敗と問い合わせ評価の S3 エクスポートをモニタリングできます。これらのイベントを使用して、障害を調査および修正できます。次のガイドは、パフォーマンス評価の失敗イベントをモニタリングするためのカスタム EventBridge ルールを作成するプロセスのウォークスルーです。

Step-by-stepガイド

これは、 AWS コンソールで Amazon Connect が失敗した自動評価送信イベントと問い合わせ評価の失敗した S3 エクスポートをログに記録する EventBridge ルールを作成する方法のガイドです。

AWS アカウントにログインし、EventBridge コンソールに移動します。「バス」セクションの「ルール」を選択します。
デフォルトのイベントバスを選択したルールの作成を選択します。
ルールに名前を付け、ルールタイプのイベントパターンを持つルールを選択します。[次へ] を選択します。
イベントで AWS イベントまたは EventBridge パートナーイベントを選択し、イベントパターンでパターンフォームを使用するオプションを選択します。ここでは、ルールのトリガーに一致するパターンを定義します。
AWS サービスドロップダウンで Amazon Connect と入力して選択し、イベントタイプを絞り込みます。以下のドロップダウンで目的のイベントタイプを選択します。パターンがセットアップされたら次へを選択します。

EventBridge イベントタイプにサブスクライブするには、次の条件を満たすカスタム EventBridge ルールを作成します。
- "source" = "aws.connect"
- "detail-type" の値は次のいずれかを指定できます。
  - "Contact Lens Automated Evaluation Submission Failed"
  - "Contact Lens Evaluation Export Failed"
次のステップでは、一致したイベントを処理/受信するようにターゲット (複数可) を設定できます。わかりやすくするために、「ターゲットの選択」のCloudWatch ロググループ」オプションを選択し、ロググループを選択します。
次へを選択し、最後のレビューと作成ステップに進みます。ルールの作成をもう一度選択して、ルールの作成プロセスを完了します。
これで、ルールが有効状態になり、一致するイベントが発生した場合、対応するログが、メタデータセクションの関連する IDs とデータセクションの失敗理由とともに、設定された CloudWatch ロググループに表示されます。

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_SUBMISSION_FAILED`	一部の質問に回答できなかったため、問い合わせ評価の自動送信に失敗しました。評価フォームまたは Amazon Connect ルール設定を確認してください。
`ANALYSIS_FILE_ERROR`	分析ファイルsearching/retrieving/parsing時にエラーが発生したため、問い合わせ評価の自動送信に失敗しました。
`INTERNAL_SERVER_ERROR`	内部サーバーエラーのため、問い合わせ評価の自動送信に失敗しました。処理の遅延が予想されます。
`QUOTA_EXCEEDED_ERROR`	Gen AI を使用して問い合わせの評価質問に自動的に回答するための残りのクォータが不十分であるため、問い合わせ評価の自動送信に失敗しました。

評価 S3 エクスポートエラー

エラー	エラーメッセージ
`S3_BUCKET_ACCESS_DENIED`	アクセス許可が不十分であるため、問い合わせ評価 JSON のエクスポートに失敗しました。
`S3_STORAGE_NOT_CONFIGURED`	エクスポート S3 バケットがインスタンス用に設定されていません。
`INTERNAL_SERVER_ERROR`	内部サーバーエラーのため、問い合わせ評価 JSON エクスポートに失敗しました。エクスポートファイルの配信が遅れることが予想されます。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

評価フォームの出力例

パフォーマンス評価のキャリブレーションセッション