기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 성능 평가 실패 이벤트 모니터링
EventBridge 및 CloudWatch를 사용하여 자동화된 평가의 실패와 고객 응대 평가의 S3 내보내기를 모니터링할 수 있습니다. 이러한 이벤트를 사용하여 실패를 조사하고 수정할 수 있습니다. 다음 가이드는 성능 평가 실패 이벤트를 모니터링하기 위한 사용자 지정 EventBridge 규칙을 생성하는 프로세스를 안내합니다.
## Step-by-step 가이드
이 가이드는 AWS 콘솔에서 Amazon Connect 자동 평가 제출 실패 이벤트 및 고객 응대 평가의 S3 내보내기 실패를 로깅하는 EventBridge 규칙을 생성하는 방법에 대한 가이드입니다.
1. AWS 계정에 로그인하고 EventBridge 콘솔로 이동합니다. **버스** 섹션에서 **규칙을** 선택합니다.
![\[EventBridge 콘솔의 버스 섹션 아래에 있는 규칙 탭.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/perf-eval-eventbridge-rules-tab.png)
1. 기본 이벤트 버스가 선택된 **규칙 생성을** 선택합니다.
![\[기본 이벤트 버스가 선택된 규칙 생성 버튼.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/perf-eval-eventbridge-create-rule.png)
1. 규칙에 이름을 지정하고 **규칙 유형에 대한 이벤트 패턴이 있는** 규칙을 선택합니다. **다음**을 선택합니다.
![\[이벤트 패턴 옵션이 선택된 규칙 이름 및 규칙입니다.\]](http://docs.aws.amazon.com/ko_kr/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/ko_kr/connect/latest/adminguide/images/perf-eval-eventbridge-event-pattern.png)
1. 다음 단계에서는 일치하는 이벤트를 처리/수신하도록 대상(들)을 구성할 수 있습니다. 간소화를 위해 **대상** 선택에서 **CloudWatch 로그 그룹** 옵션을 선택하고 로그 그룹을 선택합니다.
1. **다음을** 선택하고 최종 **검토 및 생성** 단계로 이동합니다. **규칙 생성을** 한 번 더 선택하여 규칙 생성 프로세스를 완료합니다.
1. 이제 규칙이 **활성화됨** 상태이고 일치하는 이벤트가 발생하는 경우 메타데이터 섹션 아래의 관련 IDs와 데이터 섹션 아래의 실패 이유와 함께 해당 로그가 구성된 CloudWatch 로그 그룹에 표시되어야 합니다.
![\[일치하는 EventBridge 이벤트를 보여주는 CloudWatch 로그 그룹입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/perf-eval-cloudwatch-log-group.png)
![\[메타데이터 및 실패 이유를 보여주는 CloudWatch 로그 세부 정보입니다.\]](http://docs.aws.amazon.com/ko_kr/connect/latest/adminguide/images/perf-eval-cloudwatch-log-detail.png)
## 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\$1SUBMISSION\$1FAILED | 일부 질문에 답변할 수 없어 자동 고객 응대 평가 제출에 실패했습니다. 평가 양식 및/또는 Amazon Connect 규칙 구성을 확인하십시오. |
| ANALYSIS\$1FILE\$1ERROR | 분석 파일을 searching/retrieving/parsing 때 오류로 인해 자동 고객 응대 평가 제출이 실패했습니다. |
| INTERNAL\$1SERVER\$1ERROR | 내부 서버 오류로 인해 자동 고객 응대 평가 제출에 실패했습니다. 처리가 지연될 수 있습니다. |
| QUOTA\$1EXCEEDED\$1ERROR | Gen AI를 사용하여 고객 응대에 대한 평가 질문에 자동으로 답변하는 남은 할당량이 충분하지 않아 고객 응대 평가 자동 제출이 실패했습니다. |
### 평가 S3 내보내기 오류
| 오류 | 오류 메시지 |
| --- | --- |
| S3\$1BUCKET\$1ACCESS\$1DENIED | 권한이 부족하여 고객 응대 평가 JSON 내보내기에 실패했습니다. |
| S3\$1STORAGE\$1NOT\$1CONFIGURED | 내보내기 S3 버킷이 인스턴스에 대해 구성되지 않았습니다. |
| INTERNAL\$1SERVER\$1ERROR | 내부 서버 오류로 인해 고객 응대 평가 JSON 내보내기에 실패했습니다. 내보내기 파일의 전송이 지연될 수 있습니다. |