View a markdown version of this page

监控性能评估失败事件 - Amazon Connect
Step-by-step 指南EventBridge 有效载荷示例常见错误

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

监控性能评估失败事件

您可以使用和监控自动评估的失败以及 S3 导出的联系人评估 CloudWatch。 EventBridge 您可以使用这些事件来调查和修复故障。以下指南详细介绍了创建用于监控性能评估失败事件的自定义 EventBridge 规则的过程。

Step-by-step 指南

本指南介绍了如何创建 EventBridge 规则，以便在 AWS 控制台中记录 Amazon Connect 自动评估提交失败的事件和 S3 失败的联系人评估导出。

  1. 登录您的 AWS 帐户并导航到 EventBridge 控制台。在 “公交车” 部分下选择 “规则”。

    EventBridge 控制台中 “总线” 部分下的 “规则” 选项卡。

  2. 选择创建规则，并选择默认事件总线。

    在选择默认事件总线的情况下使用创建规则按钮。

  3. 为规则命名，然后为规则类型选择带有事件模式的规则。选择下一步。

    规则名称和选中事件模式选项的规则。

  4. 在 “活动” 下选择 AWS 活动或 EventBridge 合作伙伴活动后，选择 “事件模式” 下的 “使用模式” 表单选项。在这里，您将定义要匹配的模式以触发规则。

  5. 在 AWS 服务下拉列表中键入并选择 A mazon Connect 以缩小事件类型的范围。在下面的下拉列表中选择所需的事件类型。模式设置完成后，选择 “下一步”。

    要订阅 EventBridge 事件类型，请创建与以下内容匹配的自定义 EventBridge 规则：

    • "source" = "aws.connect"

    • "detail-type" 的值可以是以下值之一：

      • "Contact Lens Automated Evaluation Submission Failed"

      • "Contact Lens Evaluation Export Failed"

    Amazon Connect 被选为 AWS 服务的事件模式。

  6. 下一步允许您为匹配的事件配置目标。 process/receive 为简单起见，请选择 “选择目标” 下的CloudWatch 日志组选项，然后选择一个日志组。

  7. 选择 “下一步”，进入最后的 “查看并创建” 步骤。再次选择 “创建规则” 以完成规则创建过程。

  8. 现在，如果规则处于 “启用” 状态并且发生了匹配的事件，则相应的日志应显示在配置的 CloudWatch 日志组中，相关日志应显示在元数据部分 IDs 下，失败原因显示在数据部分下。

    CloudWatch 显示匹配 EventBridge 事件的日志组。
    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 由于某些问题无法回答，自动提交联系人评估失败。请验证评估表 and/or 中的 Amazon Connect 规则配置。
ANALYSIS_FILE_ERROR 由于分析文件出现错误，自动提交联系searching/retrieving/parsing人评估失败。
INTERNAL_SERVER_ERROR 由于服务器内部错误，自动提交联系人评估失败。预计处理会延迟。
QUOTA_EXCEEDED_ERROR 由于使用世代 AI 自动回答联系人评估问题的剩余配额不足，因此自动提交联系人评估失败。

评估 S3 导出错误

错误 错误消息
S3_BUCKET_ACCESS_DENIED 由于权限不足，联系人评估 JSON 导出失败。
S3_STORAGE_NOT_CONFIGURED 未为您的实例配置导出 S3 存储桶。
INTERNAL_SERVER_ERROR 由于内部服务器错误，联系人评估 JSON 导出失败。预计导出文件会延迟交付。