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

# 데이터 소스 문제 해결
<a name="troubleshooting-data-sources"></a>

이 섹션에서는 Amazon Kendra 데이터 소스 커넥터를 구성하고 사용할 때 발생하는 일반적인 문제를 해결하는 데 도움이 될 수 있습니다.

## 내 문서가 인덱싱되지 않았습니다.
<a name="troubleshooting-data-sources-not-indexed"></a>

 Amazon Kendra 인덱스를 데이터 소스와 동기화하면 문서가 인덱싱되지 않는 문제가 발생할 수 있습니다. 인덱싱은 두 단계로 이루어져 있습니다. 먼저 데이터 소스에서 인덱스를 생성할 새 문서 및 업데이트된 문서가 있는지 확인하고 인덱스에서 제거할 문서를 찾습니다. 둘째, 문서 수준에서 각 문서에 액세스하고 인덱싱합니다.

두 단계 중 하나에서 오류가 발생할 수 있습니다. 데이터 소스 수준 오류는 콘솔의 데이터 소스 세부정보 페이지의 **동기화 실행 기록** 섹션에 보고됩니다. 동기화 작업의 상태는 **성공**, **미완료** 또는 **실패**일 수 있습니다. 또한 작업 중에 인덱싱되고 삭제된 문서 수를 볼 수 있습니다. 상태가 **실패**인 경우 **세부 정보** 열에 메시지가 표시됩니다.



문서 수준 오류는에 보고됩니다 Amazon CloudWatch Logs. CloudWatch 콘솔을 사용하여 오류를 확인할 수 있습니다.

문서 동기화 상태 보고서를 생성하려면 [내 문서에 대한 동기화 상태 보고서를 생성하고자 함](https://docs.aws.amazon.com/kendra/latest/dg/troubleshooting-data-sources.html#troubleshooting-data-sources-sync-status-manifest)을 참조하세요.

## 동기화 작업이 실패함
<a name="troubleshooting-data-sources-failed"></a>

동기화 작업은 일반적으로 인덱스 또는 데이터 소스에 구성 오류가 있는 경우 실패합니다. 콘솔의 세부 정보 열 아래에 있는 데이터 소스 **세부 정보** 페이지의 **동기화 실행 기록** 섹션에서 오류 메시지를 찾을 수 있습니다. 문서 수준 오류는 Amazon CloudWatch Logs에 보고됩니다. 오류 메시지는 무엇이 잘못되었는지에 대한 정보를 제공합니다. 문제는 일반적으로 인덱스 또는 데이터 소스에 적절한 IAM 권한이 없다는 것입니다. 오류 메시지에 누락된 권한이 설명되어 있습니다. 수신할 수 있는 몇 가지 오류 메시지는 다음과 같습니다.

`Failed to create log group for job. Please make sure that the IAM role provided has sufficient permissions.`

인덱스 역할에 사용 권한이 없는 경우 CloudWatch데이터 소스는 CloudWatch 로그를 생성할 수 없습니다. 이 오류가 발생하면 인덱스 역할에 CloudWatch 권한을 추가해야 합니다.

`Failed to access Amazon S3 file prefix (bucket name) while trying to crawl your metadata files. Please make sure the IAM role (ARN) provided has sufficient permissions. `

 Amazon S3 데이터 소스를 사용하는 경우 문서가 포함된 버킷에 액세스할 수 있는 권한이 있어야 Amazon Kendra 합니다. 가 데이터 소스 IAM 역할에 버킷 Amazon Kendra 을 읽을 수 있는 권한을 추가해야 합니다.

`The provided IAM role (ARN) could not be assumed. Please make sure Amazon Kendra is a trusted entity that is allowed to assume the role.`

Amazon Kendra 에는 인덱스 및 데이터 소스 IAM 역할을 수임할 수 있는 권한이 필요합니다. `sts:AssumeRole` 작업에 대한 권한이 있는 역할에 신뢰 정책을 추가해야 합니다.

데이터 소스를 인덱싱 Amazon Kendra 해야 하는 IAM 정책은 [IAM 역할을](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html) 참조하세요.

문서 동기화 상태 보고서를 생성하려면 [내 문서에 대한 동기화 상태 보고서를 생성하고자 함](https://docs.aws.amazon.com/kendra/latest/dg/troubleshooting-data-sources.html#troubleshooting-data-sources-sync-status-manifest)을 참조하세요.

## 동기화 작업이 완료되지 않음
<a name="troubleshooting-data-sources-sync-job-incomplete"></a>

데이터 소스 수준 프로세스를 완료했지만 문서 수준 프로세스에서 약간의 오류가 발생한 경우, 작업은 일반적으로 완료되지 않습니다. 작업이 완료되지 않은 경우 일부 문서의 인덱스가 제대로 생성되지 않았을 수 있습니다. Amazon S3 데이터 소스의 경우 미완료 작업은 일반적으로 다음과 같은 원인으로 발생합니다.
+ 하나 이상의 문서에 대한 메타데이터가 잘못되었습니다.
+ 인덱싱을 위해 문서를 제출했지만 하나 이상의 문서가 제출되지 않은 경우.
+ 인덱스에서 삭제하기 위해 문서를 제출했지만 하나 이상의 문서가 제출되지 않은 경우.

불완전한 동기화 작업 문제를 해결하려면 먼저 CloudWatch 로그를 찾습니다.

1. 세부 정보 열에서 세부 **정보 보기를 CloudWatch** 선택합니다.

1. 오류 메시지를 검토하여 문서 오류의 원인을 확인하세요.

문서 동기화 상태 보고서를 생성하려면 [내 문서에 대한 동기화 상태 보고서를 생성하고자 함](https://docs.aws.amazon.com/kendra/latest/dg/troubleshooting-data-sources.html#troubleshooting-data-sources-sync-status-manifest)을 참조하세요.

## 동기화 작업은 성공했지만 인덱싱된 문서가 없음
<a name="troubleshooting-data-sources-succeeded-no-indexed-docs"></a>

인덱스 동기화 작업 실행이 **성공**한 것으로 표시되지만 예상했던 인덱싱된 새 문서나 업데이트된 문서가 없는 경우가 있습니다. 가능한 이유는 다음과 같습니다.
+ `DocumentsSubmittedForIndexingFailed` 지표를 확인하여 CloudWatch 동기화에 실패한 문서가 있는지 확인합니다. 자세한 내용은 CloudWatch 로그를 확인하세요.
+  Amazon S3 데이터 소스의 경우 Amazon Kendra 잘못된 버킷 이름 또는 접두사를 지정했을 수 있습니다. 를 사용하는 버킷 Amazon Kendra 이 인덱싱할 문서가 포함된 버킷인지 확인합니다.
+ 이전 작업에서 인덱싱하지 못한 문서를 다시 인덱싱할 때는 문서 또는 관련 메타데이터 파일을 변경하지 않는 한, Amazon Kendra 가 인덱싱하지 않습니다.

문서 동기화 상태 보고서를 생성하려면 [내 문서에 대한 동기화 상태 보고서를 생성하고자 함](https://docs.aws.amazon.com/kendra/latest/dg/troubleshooting-data-sources.html#troubleshooting-data-sources-sync-status-manifest)을 참조하세요.

## 데이터 소스를 동기화하는 동안 파일 형식 문제가 발생함
<a name="troubleshooting-data-sources-file-format-issues"></a>

데이터 소스에 파일을 추가하거나 데이터 소스를 동기화하는 동안 파일 형식 문제가 발생하는 경우 문서 유형이 Amazon Kendra 를 지원하는지 확인하세요. 에서 지원하는 문서 유형 목록은 [문서 유형 또는 형식을](https://docs.aws.amazon.com/kendra/latest/dg/index-document-types.html) Amazon Kendra 참조하세요.

일반 텍스트 파일과 함께 `BatchPutDocument` API를 사용하는 경우 콘텐츠 유형으로 `PLAIN_TEXT`를 지정하세요.

## 내 문서에 대한 동기화 기록 보고서를 생성하고자 함
<a name="troubleshooting-data-sources-sync-status-manifest"></a>

**보고서 보기**를 선택하여 CloudWatch에서 데이터 소스 동기화 작업에 대한 문서 수준 동기화 실행 기록 보고서를 볼 수 있습니다. 동기화 실행 기록 보고서에는 동기화 작업의 각 문서에 대한 진행 상황 및 상태 관련 세부 정보가 나와 있습니다. 크롤링, 동기화 및 인덱스 단계에서 문서가 성공했는지, 실패했는지 또는 건너뛰었는지 여부를 표시합니다. 실패하거나 건너뛴 문서와 관련된 오류 메시지도 확인할 수 있습니다. 보고서에 진행 중인 동기화 작업의 결과가 나타나지 않으면 로그를 아직 사용할 수 없는 것일 수 있습니다. 나중에 동기화 프로세스 중에 이벤트가 발생할 때 데이터가 보고서로 전송되면 다시 확인하세요.

동기화 실행 기록 보고서에 액세스하려면 다음 단계를 수행합니다.

1. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)에서 Amazon Kendra 콘솔을 엽니다.

1. 왼쪽 탐색 메뉴의 **데이터 관리**에서 **데이터 소스**를 선택한 다음, 데이터 소스를 선택합니다.

1. 데이터 소스 요약 페이지에서 아래로 스크롤하여 **동기화 기록** 탭을 선택합니다.

1. **동기화 실행 기록**에서 **작업**을 선택합니다.

1. **작업**에서 **보고서 보기**를 선택합니다. CloudWatch 콘솔로 리디렉션되며, 여기에서 보고서에 액세스할 수 있습니다.

**참고**  
동기화 실행 기록은 연결된 ACL 및 메타데이터를 포함하여 수집 중에 모든 Amazon Kendra 지원 커넥터에 대해 문서가 성공적으로 인덱싱되었는지를 기록합니다.

**Amazon S3 커넥터를 사용하는 경우:**

CloudWatch의 문서 수준 동기화 실행 기록 보고서 외에도 Amazon S3 데이터 소스의 각 문서에 대한 동기화 기록 보고서를 생성하여 Amazon S3 버킷에 복사할 수 있습니다. 이 프로세스 중에 데이터는 AWS KMS 키를 사용하여 암호화되며 사용자만 볼 수 있습니다. 보고된 문서 상태는 **실패**, **완료** 또는 **성공(오류 있음)** 중 하나일 수 있습니다. Amazon S3용 동기화 상태 보고서를 생성하는 경우 먼저 다음을 수행해야 합니다.
+  Amazon S3 액세스 정책에 다음 Amazon Kendra 서비스 보안 주체 추가
+ 에 대한 액세스 권한이 있는 Amazon S3 버킷 생성 Amazon Kendra

콘솔을 사용하여 Amazon S3의 동기화 기록 보고서를 생성하려면 **데이터 소스 세부 정보** 페이지의 **동기화 기록 보고서 - *선택 사항*** 섹션에서 **보고서 생성** 옵션을 활성화하세요. 그런 다음 Amazon S3 버킷 위치를 입력하고 사용 가능한 구성 옵션 중에서 선택합니다. 보고서 생성을 활성화하면 다음번 동기화에서 보고서가 생성됩니다.

 Amazon S3 버킷을 삭제하면 로그 데이터가 손실되므로 새 동기화 보고서를 저장하도록 새 버킷을 설정해야 합니다.

**참고**  
동기화 기록 보고서는 Amazon S3 커넥터가 데이터를 성공적으로 크롤링하고 수집했는지에 대한 정보만 제공합니다.

## 데이터 소스를 동기화하는 데 시간이 얼마나 걸리나요?
<a name="troubleshooting-data-sources-sync-time"></a>

문서에 대한 업데이트가 없는 경우 Amazon Kendra 인덱스의 동기화 시간은 문서 수에 비례하여 선형적으로 증가합니다. 예를 들어 업데이트가 없는 문서 1,000개는 동기화하는 데 약 5분이 걸리고, 업데이트가 없는 문서 2,000개는 동기화하는 데 약 10분이 걸립니다. 문서가 업데이트된 경우 업데이트된 문서 수에 따라 동기화 시간이 늘어납니다.

## 데이터 소스를 동기화하는 데 드는 요금은 얼마인가요?
<a name="troubleshooting-data-sources-sync-charge"></a>

인덱스를 동기화할 때 워밍업하고 활성화하여 필요한 연결을 설정하는 Amazon EC2 데 2분이 걸립니다. 이 프로세스에는 요금이 청구되지 않습니다. 사용량 측정기는 동기화 작업이 시작된 후에만 시작됩니다. Amazon Kendra 요금에 대한 자세한 내용은 [https://aws.amazon.com/kendra/pricing/](https://aws.amazon.com/kendra/pricing/) 참조하세요.

## Amazon EC2 권한 부여 오류가 발생합니다.
<a name="troubleshooting-data-sources-ec2-error"></a>

Virtual Private Cloud(VPC) 데이터 소스에 대한 동기화 중에 Amazon EC2 무단 작업 오류가 발생하는 경우 VPC IAM 역할에 필요한 권한이 없을 수 있습니다. 데이터 소스에 사용하는 IAM 역할에 연결된 권한이 있는지 확인하세요. 자세한 내용은 [가상 프라이빗 클라우드 IAM 역할을](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-vpc) 참조하세요.

## 검색 인덱스 링크를 사용하여 Amazon S3 객체를 열 수 없음
<a name="troubleshooting-data-unable-to-open-s3-links"></a>

 Amazon Kendra 인덱스는 Amazon S3 데이터 소스가 액세스 권한을 부여하는 파일에만 액세스할 수 있습니다. 예를 들어, 객체가 퍼블릭 또는 암호화 대상인지 여부를 결정하는 Amazon S3 권한을 수정할 수 Amazon Kendra 없습니다. Amazon Kendra 또한 에는 Amazon S3 객체에 대해 서명된 링크를 생성하거나 반환할 수 있는 기본 권한이 없습니다. Amazon Kendra 인덱스의 Amazon S3 객체에 대해 서명된 연결을 활성화하려면 두 가지 옵션이 있습니다.
+ 결과를 검색 페이지에 반환하기 전에 소스 uri 객체를 사용하여 인덱스 쿼리 결과에 서명할 수 있습니다. 이 프로세스의 단계별 안내 지침은 [https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html)를 참조하세요.
+  Amazon S3 객체 메타데이터 소스 uri를 재정의하고 Amazon S3 버킷에 연결된 CloudFront 콘텐츠 전송 네트워크(CDN)를 통해 서비스를 사용할 수 있도록 할 수 있습니다. 또는 미리 서명된 URL을 반환하고 리디렉션하는 API Gateway 프록시 엔드포인트를 사용할 수 있습니다.

## SSL 인증서 파일 사용 시 액세스가 거부됨 오류 메시지가 나타남
<a name="troubleshooting-data-sources-ssl-certificate-access-denied"></a>

데이터 소스와 함께 SSL 인증서를 사용할 때 액세스 거부 오류가 발생하는 경우 IAM 역할에 지정된 위치의 SSL 인증서 파일에 액세스할 수 있는 권한이 있는지 확인합니다. 인증서가 AWS KMS 키로 암호화된 경우 IAM 역할에 AWS KMS 는 키를 사용하여 복호화할 수 있는 권한도 있어야 합니다. 자세한 내용은 [https://docs.aws.amazon.com/kms/latest/developerguide/control-access.html](https://docs.aws.amazon.com/kms/latest/developerguide/control-access.html)를 참조하세요.

## SharePoint 데이터 소스를 사용할 때 인증 오류가 발생함
<a name="troubleshooting-data-sources-sharepoint-authorization-error"></a>

인덱스를 SharePoint 데이터 소스와 동기화하는 동안 인증 오류가 발생하는 경우 SharePoint에서 사이트 관리자 역할을 할당 받았는지 확인하세요.

## 내 인덱스가 Confluence 데이터 소스의 문서를 크롤링하지 않음
<a name="troubleshooting-data-sources-confluence-document-crawling"></a>

동기화 프로세스 중에 Amazon Kendra 인덱스가 Confluence 데이터 소스에서 문서를 크롤링하지 않는 경우 Confluence의 관리자 그룹에 속해 있는지 확인합니다.