View a markdown version of this page

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

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

监控性能评估失败事件

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

Step-by-step 指南

本指南介绍如何创建 EventBridge 规则，在 AWS 控制台中记录 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"

    选择亚马逊连接作为 AWS 服务的事件模式。

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

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

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

    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 由于某些问题无法回答，自动提交联系人评估失败。请验证评估表或 “连接客户” 规则配置。
ANALYSIS_FILE_ERROR 由于 searching/retrieving /解析分析文件时出错，自动联系人评估提交失败。
INTERNAL_SERVER_ERROR 由于内部服务器错误，自动提交联系人评估失败。请预计会延迟处理。
QUOTA_EXCEEDED_ERROR 自动提交联系人评估失败，因为使用生成式 AI 自动回答联系人评估问题的剩余配额不足。

评估 S3 导出错误

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