本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 監控效能評估失敗事件
<a name="performance-evaluation-events"></a>

您可以使用 EventBridge 和 CloudWatch 監控自動化評估的失敗，以及聯絡人評估的 S3 匯出。您可以使用這些事件來調查和修正失敗。下列指南逐步解說如何建立自訂 EventBridge 規則以監控效能評估失敗事件的程序。

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

本指南說明如何建立 EventBridge 規則，在 AWS 主控台中記錄 Amazon Connect 失敗的自動評估提交事件和失敗的聯絡評估 S3 匯出。

1. 登入 AWS 您的帳戶並導覽至 EventBridge 主控台。在**匯流排**區段下選擇**規則**。  
![\[EventBridge 主控台中 Buss 區段下的規則索引標籤。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/perf-eval-eventbridge-rules-tab.png)

1. 選擇已選取預設事件匯流排的**建立規則**。  
![\[選取預設事件匯流排的建立規則按鈕。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/perf-eval-eventbridge-create-rule.png)

1. 為規則命名，並選取**具有規則類型事件模式**的規則。選擇**下一步**。  
![\[選取事件模式選項的規則名稱和規則。\]](http://docs.aws.amazon.com/zh_tw/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/zh_tw/connect/latest/adminguide/images/perf-eval-eventbridge-event-pattern.png)

1. 下一個步驟可讓您設定目標來處理/接收相符的事件 (Target)。為了簡化，請在選取**目標下選取** **CloudWatch 日誌群組**選項，然後選擇日誌群組。

1. 選擇**下一步**並前往最終**檢閱和建立**步驟。再次選擇**建立規則**以完成規則建立程序。

1. 現在，如果規則處於**已啟用**狀態且發生相符事件，對應的日誌應該會顯示在設定的 CloudWatch 日誌群組中，中繼資料區段下的相關 IDs和資料區段下的失敗原因。  
![\[CloudWatch 日誌群組顯示相符的 EventBridge 事件。\]](http://docs.aws.amazon.com/zh_tw/connect/latest/adminguide/images/perf-eval-cloudwatch-log-group.png)  
![\[CloudWatch 日誌詳細資訊，顯示中繼資料和失敗原因。\]](http://docs.aws.amazon.com/zh_tw/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 | 自動化聯絡人評估提交失敗，因為無法回答某些問題。請驗證評估表單和/或 Amazon Connect 規則組態。 | 
| ANALYSIS\$1FILE\$1ERROR | 由於searching/retrieving/parsing分析檔案時發生錯誤，自動提交聯絡人評估失敗。 | 
| INTERNAL\$1SERVER\$1ERROR | 由於內部伺服器錯誤，自動聯絡人評估提交失敗。請預期延遲處理。 | 
| QUOTA\$1EXCEEDED\$1ERROR | 自動化聯絡人評估提交失敗，因為使用 Gen AI 自動回答聯絡人評估問題的剩餘配額不足。 | 

### 評估 S3 匯出錯誤
<a name="evaluation-s3-export-errors"></a>


| 錯誤 | 錯誤訊息 | 
| --- | --- | 
| S3\$1BUCKET\$1ACCESS\$1DENIED | 由於許可不足，聯絡人評估 JSON 匯出失敗。 | 
| S3\$1STORAGE\$1NOT\$1CONFIGURED | 您的執行個體未設定匯出 S3 儲存貯體。 | 
| INTERNAL\$1SERVER\$1ERROR | 由於內部伺服器錯誤，聯絡人評估 JSON 匯出失敗。請預期匯出檔案的延遲交付。 |