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

# 监控性能评估失败事件
<a name="performance-evaluation-events"></a>

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

## Step-by-step 指南
<a name="performance-evaluation-events-guide"></a>

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

1. 登录您的 AWS 帐户并导航到 EventBridge 控制台。在 “**公交车**” 部分下选择 “**规则**”。  
![\[EventBridge 控制台中 “总线” 部分下的 “规则” 选项卡。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/perf-eval-eventbridge-rules-tab.png)

1. 选择**创建规则**，并选择默认事件总线。  
![\[在选择默认事件总线的情况下使用创建规则按钮。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/perf-eval-eventbridge-create-rule.png)

1. 为规则命名，然后为**规则类型选择带有事件模式**的规则。选择**下一步**。  
![\[规则名称和选中事件模式选项的规则。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/perf-eval-eventbridge-rule-name.png)

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

1. 在 **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 服务的事件模式。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/perf-eval-eventbridge-event-pattern.png)

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

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

1. 现在，如果规则处于 “**启用”** 状态并且发生了匹配的事件，则相应的日志应显示在配置的 CloudWatch 日志组中，相关日志应显示在元数据部分 IDs 下，失败原因显示在数据部分下。  
![\[CloudWatch 显示匹配 EventBridge 事件的日志组。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/perf-eval-cloudwatch-log-group.png)  
![\[CloudWatch 显示元数据和失败原因的日志详细信息。\]](http://docs.aws.amazon.com/zh_cn/connect/latest/adminguide/images/perf-eval-cloudwatch-log-detail.png)

## EventBridge 有效载荷示例
<a name="performance-evaluation-events-payload"></a>

以下是匹配规则时的 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."
    }  
  }  
}
```

## 常见错误
<a name="performance-evaluation-events-errors"></a>

当系统在多次重试后最终无法处理评估时，可能会出现以下错误。

### 自动评估提交错误
<a name="automated-evaluation-submission-errors"></a>


| 错误 | 错误消息 | 
| --- | --- | 
| AUTOMATED\$1SUBMISSION\$1FAILED | 由于某些问题无法回答，自动提交联系人评估失败。请验证评估表 and/or 中的 Amazon Connect 规则配置。 | 
| ANALYSIS\$1FILE\$1ERROR | 由于分析文件出现错误，自动提交联系searching/retrieving/parsing人评估失败。 | 
| INTERNAL\$1SERVER\$1ERROR | 由于服务器内部错误，自动提交联系人评估失败。预计处理会延迟。 | 
| QUOTA\$1EXCEEDED\$1ERROR | 由于使用世代 AI 自动回答联系人评估问题的剩余配额不足，因此自动提交联系人评估失败。 | 

### 评估 S3 导出错误
<a name="evaluation-s3-export-errors"></a>


| 错误 | 错误消息 | 
| --- | --- | 
| S3\$1BUCKET\$1ACCESS\$1DENIED | 由于权限不足，联系人评估 JSON 导出失败。 | 
| S3\$1STORAGE\$1NOT\$1CONFIGURED | 未为您的实例配置导出 S3 存储桶。 | 
| INTERNAL\$1SERVER\$1ERROR | 由于内部服务器错误，联系人评估 JSON 导出失败。预计导出文件会延迟交付。 |