View a markdown version of this page

성능 평가 실패 이벤트 모니터링 - Amazon Connect
Step-by-step 가이드EventBridge 페이로드 예제일반적인 오류

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

성능 평가 실패 이벤트 모니터링

EventBridge 및 CloudWatch를 사용하여 자동화된 평가의 실패와 고객 응대 평가의 S3 내보내기를 모니터링할 수 있습니다. 이러한 이벤트를 사용하여 실패를 조사하고 수정할 수 있습니다. 다음 가이드는 성능 평가 실패 이벤트를 모니터링하기 위한 사용자 지정 EventBridge 규칙을 생성하는 프로세스를 안내합니다.

Step-by-step 가이드

이 가이드는 AWS 콘솔에서 Amazon Connect 자동 평가 제출 실패 이벤트 및 고객 응대 평가의 S3 내보내기 실패를 로깅하는 EventBridge 규칙을 생성하는 방법에 대한 가이드입니다.

  1. AWS 계정에 로그인하고 EventBridge 콘솔로 이동합니다. 버스 섹션에서 규칙을 선택합니다.

    EventBridge 콘솔의 버스 섹션 아래에 있는 규칙 탭.

  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. 다음 단계에서는 일치하는 이벤트를 처리/수신하도록 대상(들)을 구성할 수 있습니다. 간소화를 위해 대상 선택에서 CloudWatch 로그 그룹 옵션을 선택하고 로그 그룹을 선택합니다.

  7. 다음을 선택하고 최종 검토 및 생성 단계로 이동합니다. 규칙 생성을 한 번 더 선택하여 규칙 생성 프로세스를 완료합니다.

  8. 이제 규칙이 활성화됨 상태이고 일치하는 이벤트가 발생하는 경우 메타데이터 섹션 아래의 관련 IDs와 데이터 섹션 아래의 실패 이유와 함께 해당 로그가 구성된 CloudWatch 로그 그룹에 표시되어야 합니다.

    일치하는 EventBridge 이벤트를 보여주는 CloudWatch 로그 그룹입니다.
    메타데이터 및 실패 이유를 보여주는 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 내보내기에 실패했습니다. 내보내기 파일의 전송이 지연될 수 있습니다.