View a markdown version of this page

監控效能評估失敗事件 - Amazon Connect
Step-by-step指南EventBridge 承載範例常見錯誤

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

監控效能評估失敗事件

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

Step-by-step指南

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

  1. 登入 AWS 您的帳戶並導覽至 EventBridge 主控台。在匯流排區段下選擇規則。

    EventBridge 主控台中 Buss 區段下的規則索引標籤。

  2. 選擇已選取預設事件匯流排的建立規則。

    選取預設事件匯流排的建立規則按鈕。

  3. 為規則命名，並選取具有規則類型事件模式的規則。選擇下一步。

    選取事件模式選項的規則名稱和規則。

  4. 在事件下選取 AWS 事件或 EventBridge 合作夥伴事件時，選取事件模式下的使用模式表單選項。在這裡，您將定義要符合的模式來觸發規則。

  5. 在 AWS 服務下拉式清單下輸入並選取 Amazon Connect，縮小事件類型範圍。在下面的下拉式清單中選取所需的事件類型。設定模式後，請選擇下一步。

    若要訂閱 EventBridge 事件類型，請建立一個自訂 EventBridge 規則符合下列規則：

    • "source" = "aws.connect"

    • "detail-type" 可為下列其中之一：

      • "Contact Lens Automated Evaluation Submission Failed"

      • "Contact Lens Evaluation Export Failed"

    選取 Amazon Connect 做為 AWS 服務的事件模式。

  6. 下一個步驟可讓您設定目標來處理/接收相符的事件 (Target)。為了簡化，請在選取目標下選取 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 自動化聯絡人評估提交失敗，因為無法回答某些問題。請驗證評估表單和/或 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 匯出失敗。請預期匯出檔案的延遲交付。