기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# CloudWatch Logs를 사용하여 Amazon Quick 모니터링
[Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html)를 사용하여 분석할 수 있도록 Amazon Quick에서 채팅 대화, 사용자 피드백, 에이전트 시간 사용량 및 인덱스 스토리지 사용량을 제공할 수 있습니다. 이러한 로그는 CloudWatch, Amazon S3 또는 Amazon Data Firehose(표준 요금 적용)와 같은 여러 대상으로 전송할 수 있습니다.
**중요**
Amazon Quick AI 기능을 활성화한 직후 판매 로그 전송을 설정합니다. 로그는 소급 적용되지 않습니다. 전송이 구성된 후에 발생하는 이벤트만 수신합니다.
다음은 Amazon Quick의 로그로 완료할 수 있는 작업의 예입니다.
+ 채팅 메시지 콘텐츠를 검토하여 일반적인 사용자 쿼리와 문제를 식별합니다.
+ `feedbackReason`와 같은 지표를 확인하여 응답 품질을 모니터링합니다.
+ 설명 및 유용성 등급을 포함한 피드백 데이터를 분석하여 사용자 감정과 만족도를 이해합니다.
+ 사용자 지정 대시보드 및 보고서를 생성하여 시간 경과에 따른 주요 지표 및 추세를 추적할 수 있습니다.
+ 채팅에서 응답이 반환되지 않았거나 사용자 쿼리가 차단된 사례를 식별하고 분석합니다.
+ 에이전트 시간 사용량을 모니터링합니다.
+ 지식 기반 및 스페이스에서 인덱스 스토리지 사용량을 추적합니다.
+ 지식 기반 동기화 작업을 추적하고 문서 크롤링 또는 인덱싱 실패를 식별합니다.
**중요**
대화의 로그에는 채팅에서 전달되는 민감한 데이터 또는 개인 식별 데이터가 포함될 수 있습니다. 로그 구독을 설정할 때 로그에서이 정보를 필터링할 수 있습니다. 또는 CloudWatch Logs 마스킹 정책을 사용하여 로그에서 이 데이터를 마스킹할 수 있습니다. 자세한 내용은 [Help protect sensitive log data with masking](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/mask-sensitive-log-data.html)을 참조하세요.
## 지원되는 로그 대상
Amazon Quick은 다음 대상으로 로그를 전송할 수 있습니다.
+ **Amazon CloudWatch Logs** - 실시간 모니터링 및 분석용
+ **Amazon S3** - 장기 스토리지 및 배치 처리용
+ **Amazon Data Firehose** - 스트리밍 분석 및 데이터 변환용
## 사전 조건
로깅을 활성화하려면 먼저 다음이 있어야 합니다.
+ Enterprise 또는 Professional 구독이 있는 활성 Amazon Quick 인스턴스
+ 로그 전송을 구성하기 위한 적절한 IAM 권한
+ 로그에 대해 구성된 대상(CloudWatch Logs, Amazon S3 버킷 또는 Firehose)
## 로깅 구성
Amazon Quick 채팅 및 피드백에 대한 로깅을 활성화하려면 IAM 권한을 구성하고, 전송 소스 및 대상을 생성하고, 로그 전송을 확인합니다.
**Topics**
+ [IAM 권한 설정](#quicksuite-chat-feedback-setup-iam-permissions)
+ [로그 구독 구성](#quicksuite-chat-feedback-configure-log-subscription)
+ [로그 전송 확인](#quicksuite-chat-feedback-verify-log-delivery)
### IAM 권한 설정
Amazon Quick용 CloudWatch Logs를 설정하려면 다음 IAM 정책 예제를 사용하여 필요한 권한을 부여합니다.
```
{
"Version": "2012-10-17" ,
"Statement": [{
"Sid": "QuicksightLogDeliveryPermissions",
"Effect": "Allow",
"Action": "quicksight:AllowVendedLogDeliveryForResource",
"Resource": "arn:aws:quicksight:region:account-id:account/account-id"
}]
}
```
또한 고객 관리형 AWS KMS 키 정책에서 `delivery.logs.amazonaws.com` 서비스 보안 주체를 허용해야 합니다.
```
{
"Effect": "Allow" ,
"Principal": {
"Service": "delivery.logs.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"kms:EncryptionContext:SourceArn": "arn:partition:logs:region:account-id:*"
}
}
}
```
### 로그 구독 구성
특정 로깅 대상에 필요한 모든 권한이 있는 IAM 정책의 예는 *Amazon CloudWatch Logs 사용 설명서*의 [AWS 서비스에서 로깅 활성화](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html)를 참조하세요.
[PutDeliverySource](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html) CloudWatch Logs API 작업을 사용하여 전송 소스를 생성합니다. 전송 소스에 이름을 지정하고 `resourceArn`에 대해 애플리케이션의 ARN을 지정합니다. 의 경우 `CHAT_LOGS`, `logType`, `AGENT_HOURS_LOGS``AGENT_METADATA_LOGS`, `FEEDBACK_LOGS`, 또는 `INDEX_USAGE_LOGS`를 지정합니다`KB_FILE_SYNC_LOGS`.
```
{
"logType": "CHAT_LOGS",
"name": "my-quick-suite-delivery-source",
"resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```
```
{
"logType": "FEEDBACK_LOGS",
"name": "my-quick-suite-delivery-source",
"resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```
```
{
"logType": "AGENT_HOURS_LOGS",
"name": "my-quick-suite-delivery-source",
"resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```
```
{
"logType": "INDEX_USAGE_LOGS",
"name": "my-quick-index-usage-delivery-source",
"resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```
```
{
"logType": "KB_FILE_SYNC_LOGS",
"name": "my-quick-kb-file-sync-delivery-source",
"resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```
```
{
"logType": "AGENT_METADATA_LOGS",
"name": "my-quick-agent-metadata-delivery-source",
"resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}
```
CloudWatch Logs API 작업을 사용하여 사용자 대화 로깅을 활성화하려면 , `PutDeliverySource` `PutDeliveryDestination`및 `CreateDelivery` API 작업을 호출합니다.
**참고**
벤딩 로그 전송은 리전별로 이루어집니다. 각 전송은의에 의해 지정된 리전에서 발생하는 활동만 캡처`resourceArn`합니다`PutDeliverySource`. 여러 리전에서 로그를 수신하려면 각 리전에서 별도의 전송을 구성합니다.
### 로그 전송 확인
로그 전송을 구성한 후 로그가 대상으로 전송되고 있는지 확인합니다.
+ **설정 확인:** CloudWatch Logs의 `DescribeDeliveries` API를 사용하여 계정에서 생성된 전송 목록을 확인합니다.
+ **CloudWatch Logs**: 지정된 로그 그룹에 새 로그 스트림이 있는지 확인합니다.
+ **Amazon S3**: 버킷에서 새 로그 파일을 모니터링합니다.
+ **Firehose**: 데이터가 전송 스트림을 통해 흐르는지 확인합니다.
## 로그 스키마 및 형식
Amazon Quick 로그는 모든 로그 유형에서 공유되는 공통 필드와 채팅 및 피드백 로그에 대한 특정 필드가 있는 구조화된 스키마를 따릅니다.
### 공통 필드
모든 로그 이벤트에는 다음과 같은 공통 필드가 포함됩니다.
+ `resource_arn` - Amazon Quick 계정의 리소스 ARN(예: `arn:aws:quicksight:us-east-1:111122223333:account/111122223333:`)
+ `event_timestamp` - 밀리초 단위의 Unix epoch 시간(예: `1763532110061`)
+ `logType` - 로그 유형(예: `CHAT_LOGS` 또는 `FEEDBACK_LOGS`)
+ `accountId` – AWS 계정 ID(예: `123456789012`)
+ `user_arn` - 이벤트와 연결된 Amazon Quick 사용자 ARN(예: `"arn:aws:quicksight:us-west-2:111122223333:user/default/user"`)
### 채팅 로그
채팅 로그는 대화 상호 작용을 캡처합니다.
**참고**
기록 및 메모리에서 제외된 임시 대화는 여전히 채팅 로그로 전달됩니다. 각 레코드에는 대화를 시작한 `user_type` 사용자의 `user_arn` 및가 포함됩니다.
+ `user_arn` - 이벤트와 연결된 Amazon Quick 사용자 ARN
+ `user_type` - 이벤트와 연결된 Amazon Quick 사용자 유형(예: `ADMIN_PRO`)
+ `status_code` - 채팅 요청 상태(예: , `success``request_blocked`, `no_answer_found`)
+ `conversation_id` - 사용자 대화의 고유 ID
+ `system_message_id` - 시스템 생성 메시지 ID
+ `message_scope` - 메시지 범위(예: , `all_resources``specific_resources`, `no_resources`)
+ `user_message_id` - 사용자 메시지의 고유 ID
+ `user_message` - 대화의 사용자 메시지
+ `agent_id` - 채팅 에이전트의 고유 ID 또는 기본 에이전트의 `SYSTEM` 고유 ID
+ `flow_id` - Amazon Quick Flow의 고유 ID 또는 흐름 호출이 아닌 `-` 경우
+ `system_text_message` - 대화의 시스템 응답
+ `user_selected_resources` - 사용자가 선택한 리소스 목록
+ `action_connectors` - 대화에서 사용할 수 있는 작업 커넥터 목록
+ `cited_resource` - 인용된 리소스 목록
+ `file_attachment` - 사용자가 첨부한 파일 목록
+ `resource_arn` - Amazon Quick 계정의 리소스 ARN
+ `event_timestamp` - 이벤트의 타임스탬프
+ `logType` – `CHAT_LOGS`
+ `accountId` – AWS 계정 ID
다음은 채팅 로그의 예입니다.
```
{
"user_arn": "arn:aws:quicksight:us-east-1:111122223333:user/default/johndoe",
"user_type": "ADMIN_PRO",
"status_code": "success",
"conversation_id": "c11ba72c-ff18-4213-9686-1952bb547c19",
"system_message_id": "42a37690-1804-442b-8368-3d34570dd2cd",
"message_scope": "all_resources",
"user_message_id": "5ec45e03-bf22-40c7-b32a-d69eb015f86b",
"user_message": "What is in this document?",
"agent_id": "SYSTEM",
"flow_id": "-",
"system_text_message": "Here is a summary of the attached document.",
"user_selected_resources": [{"resourceId": "ALL", "resourceType": "space"}],
"action_connectors": [{"actionConnectorId": "quicksuite-documentation"}, {"actionConnectorId": "quicksuite-websearch"}],
"cited_resource": [{"citedResourceType": "document", "citedResourceId": null, "citedResourceName": "example-document.html"}],
"file_attachment": [{"fileAttachmentType": "html", "fileAttachmentName": "example-document.html"}],
"resource_arn": "arn:aws:quicksight:us-east-1:111122223333:account/111122223333",
"event_timestamp": 1787185484508,
"logType": "CHAT_LOGS",
"accountId": "111122223333"
}
```
### 피드백 로그
피드백 로그는 채팅 응답에 대한 사용자 피드백을 캡처합니다.
+ `user_arn` - 이벤트와 연결된 Amazon Quick 사용자 ARN
+ `user_type` - 이벤트와 연결된 Amazon Quick 사용자 유형(예: `ADMIN_PRO`)
+ `status_code` - 이벤트 전송 상태
+ `conversation_id` - 대화의 고유 ID
+ `system_message_id` - 시스템 생성 메시지 ID
+ `user_message_id` - 사용자 메시지의 고유 ID
+ `feedback_type` - 피드백 유형(예: , `Not Useful``Useful`)
+ `feedback_reason` - 사용자가 선택한 피드백 이유
+ `feedback_details` - (선택 사항) 사용자가 제공하는 추가 세부 정보
+ `resource_arn` - Amazon Quick 계정의 리소스 ARN
+ `event_timestamp` - 이벤트의 타임스탬프
+ `logType` – `FEEDBACK_LOGS`
+ `accountId` – AWS 계정 ID
다음은 피드백 로그의 예입니다.
```
{
"user_arn": "arn:aws:quicksight:us-east-1:111122223333:user/default/johndoe",
"user_type": "ADMIN_PRO",
"status_code": "success",
"conversation_id": "c11ba72c-ff18-4213-9686-1952bb547c19",
"system_message_id": "42a37690-1804-442b-8368-3d34570dd2cd",
"user_message_id": "5ec45e03-bf22-40c7-b32a-d69eb015f86b",
"feedback_type": "Not Useful",
"feedback_reason": "Too wordy",
"feedback_details": "The answer included too much background information.",
"resource_arn": "arn:aws:quicksight:us-east-1:111122223333:account/111122223333",
"event_timestamp": 1787185500123,
"logType": "FEEDBACK_LOGS",
"accountId": "111122223333"
}
```
## 에이전트 시간 로그
이 로그 유형은 요금에 사용되는 Quick 계정 내의 다양한 에이전트에 대한 사용 로그를 캡처합니다.
+ `user_arn` - 이벤트와 연결된 Amazon Quick 사용자 ARN
+ `subscription_type` - 사용자의 구독 계층입니다. 값: `ENTERPRISE`, `PROFESSIONAL`.
+ `reporting_service` - 에이전트 시간을 소비한 빠른 표면입니다. 현재 값에는 `FLOW`, 및 `AUTOMATION`가 포함됩니다`RESEARCH`. 추가 빠른 기능이 에이전트 시간 측정을 시작하면 새 값이 표시될 수 있습니다.
+ `usage_group` - 사용량이 구독 권한에 포함되는지 아니면 초과 요금으로 청구되는지 여부입니다. 값:
+ `Included` - 구독 계층에 대한 일일 권한 부여 내의 사용량입니다. 증분 요금은 없습니다.
+ `Extra` - 일일 권한 부여를 초과합니다. 사용량에 따라 요금이 청구됩니다.
+ `usage_hours` -이 레코드에 사용된 에이전트 시간을 나타내는 소수 값
+ `service_resource_arn` - 시간을 소비한 리소스의 ARN(예: 흐름, 자동화 또는 연구 세션)
+ `resource_arn` - Amazon Quick 계정의 리소스 ARN
+ `event_timestamp` - 이벤트의 타임스탬프
+ `logType` – `AGENT_HOURS_LOGS`
+ `accountId` – AWS 계정 ID
다음은 에이전트 시간 로그의 예입니다.
```
{
"user_arn": "arn:aws:quicksight:us-east-1:111122223333:user/default/johndoe",
"subscription_type": "ENTERPRISE",
"reporting_service": "RESEARCH",
"usage_group": "Included",
"usage_hours": 0.0928,
"service_resource_arn": "arn:aws:quicksight::111122223333:research/a11b2bbc-c123-3abc-a12b-12a34b5c678d",
"resource_arn": "arn:aws:quicksight:us-east-1:111122223333:account/111122223333",
"event_timestamp": 1787183715000,
"logType": "AGENT_HOURS_LOGS",
"accountId": "111122223333"
}
```
## 에이전트 메타데이터 로그
에이전트 메타데이터 로그는 생성, 업데이트, 권한 변경 및 삭제를 포함하여 채팅 에이전트의 수명 주기 이벤트를 캡처합니다. 에이전트 작업당 하나의 레코드가 생성됩니다.
+ `user_arn` - 이벤트와 연결된 Amazon Quick 사용자 ARN입니다.
+ `event_name` - 에이전트 수명 주기 작업입니다. 값에는 새 작업이 추가될 때 `CreateAgent`, `UpdateAgent``DeleteAgent`, `UpdateAgentPermissions`, 등이 포함됩니다.
+ `event_version` - 로그 레코드의 스키마 버전입니다.
+ `agent_id` - 에이전트의 UUID입니다.
+ `agent_arn` - 에이전트의 전체 ARN입니다.
+ `agent_name` - 에이전트의 이름을 표시합니다.
+ `agent_status` - 에이전트의 현재 상태(예: `ACTIVE`).
+ `request_id` - 작업의 요청 식별자입니다.
+ `description` - 에이전트 설명 텍스트입니다.
+ `spaces` - 에이전트에 연결된 공백의 JSON 배열입니다.
+ `permissions_granted` -이 작업에 추가된 권한입니다.
+ `permissions_revoked` -이 작업에서 제거된 권한입니다.
+ `permissions_state` - 작업 후 현재 권한입니다.
+ `update_action` - 수행된 업데이트 작업입니다.
+ `version` - 에이전트 버전 번호입니다.
+ `icon_id` - 에이전트의 아이콘 식별자입니다.
+ `magic_builder_query` - 빌더를 통해 에이전트를 생성하는 데 사용되는 자연어 쿼리입니다.
+ `instructions` - 에이전트 지침입니다.
+ `failed_to_add_spaces` - 연결할 수 없는 공백입니다.
+ `failed_to_remove_spaces` - 분리할 수 없는 공간입니다.
+ `draft_discarded` - 초안이 삭제되었는지 여부입니다.
+ `custom_prompt_input` - 에이전트에 대해 구성된 사용자 지정 프롬프트 입력입니다.
+ `welcome_message` - 에이전트 사용자에게 표시되는 환영 메시지입니다.
+ `starter_prompts` - 에이전트 사용자에게 제안되는 스타터 프롬프트입니다.
+ `resource_arn` - Amazon Quick 계정의 리소스 ARN입니다.
+ `event_timestamp` - 이벤트의 타임스탬프입니다.
+ `log_type` – `AGENT_METADATA_LOGS`.
+ `account_id` – AWS 계정 ID.
**참고**
`custom_prompt_input`, `welcome_message`및 `starter_prompts` 필드에는 민감한 콘텐츠가 포함되어 있습니다. 전송을 위해 고객 관리형 AWS KMS 키를 구성하면 이러한 필드가 암호화됩니다. 키가 없으면 일반 텍스트로 전달됩니다.
다음은 `CreateAgent` 이벤트에 대한 에이전트 메타데이터 로그의 예입니다.
```
{
"user_arn": "arn:aws:quicksight:us-east-1:111122223333:user/default/johndoe",
"event_version": "1.0",
"event_name": "CreateAgent",
"agent_id": "12345678-90ab-cdef-1234-567890abcdef",
"request_id": "fedcba98-7654-3210-fedc-ba9876543210",
"agent_arn": "arn:aws:quicksight:us-east-1:111122223333:agent/12345678-90ab-cdef-1234-567890abcdef",
"agent_name": "Project Status Assistant",
"agent_status": "ACTIVE",
"description": "An agent that helps track project status and find relevant documentation.",
"spaces": "[{\"Arn\": \"arn:aws:quicksight:us-east-1:111122223333:space/11112222-3333-4444-5555-666677778888\"}]",
"resource_arn": "arn:aws:quicksight:us-east-1:111122223333:account/111122223333",
"event_timestamp": 1787185396000,
"log_type": "AGENT_METADATA_LOGS",
"account_id": "111122223333"
}
```
## 인덱스 사용 로그
인덱스 사용 로그는 지식 기반 및 스페이스에 대한 소스별 스토리지 지표를 캡처합니다. 이벤트는 변경(생성, 업데이트, 동기화 또는 삭제)이 발생할 때마다 게시됩니다.
+ `user_arn` - 이벤트와 연결된 Amazon Quick 사용자 ARN
+ `consumed_index_size` - 전체 인덱스에서 사용된 총 크기(바이트)
+ `source_type` - 소스 유형: `SPACE` 또는 `KB`
+ `source_name` - 스페이스 또는 지식 기반의 표시 이름
+ `source_arn` - 소스의 전체 ARN
+ `consumed_source_size` -이 개별 소스에서 사용하는 크기(바이트)
+ `consumed_source_doc_count` -이 소스의 문서 수
+ `resource_arn` - Amazon Quick 계정의 리소스 ARN
+ `event_timestamp` - 이벤트의 타임스탬프
+ `log_type` – `INDEX_USAGE_LOGS`
+ `account_id` – AWS 계정 ID
다음은 인덱스 사용 로그의 예입니다.
```
{
"account_id": "111122223333",
"event_timestamp": 1774911984257,
"log_type": "INDEX_USAGE_LOGS",
"user_arn": "arn:aws:quicksight::111122223333:user/default/user",
"resource_arn": "arn:aws:quicksight:us-west-2:111122223333:account/111122223333",
"consumed_index_size": 500000,
"source_type": "SPACE",
"source_name": "my-space",
"source_arn": "arn:aws:quicksight:us-west-2:111122223333:space/2744af89-31b2-423b-93a2-69b0cd0d7fa1",
"consumed_source_size": 244436,
"consumed_source_doc_count": 2
}
```
**참고**
이벤트는 소스별로 변경 시 게시됩니다. 모든 소스가 매일 이벤트를 내보내는 것은 아닙니다. 현재 상태를 재구성하려면 당 가장 최근 이벤트를 사용합니다`source_arn`.
대시보드 구축 및 인덱스 사용 로그에 대한 쿼리 실행에 대한 자세한 내용은 섹션을 참조하세요[인덱스 스토리지 사용량 모니터링](index-usage-monitoring.md).
## 지식 기반 파일 동기화 로그
지식 기반 파일 동기화 로그는 문서별 동기화 상태 이벤트를 캡처합니다. 동기화 실행당 문서당 하나의 로그 레코드가 생성됩니다.
+ `document_id` - URL 또는 파일 경로와 같은 원본 문서 식별자입니다.
+ `document_title` - 문서 제목입니다.
+ `document_status` - 터미널 문서 상태입니다. 값: `ADDED`, `MODIFIED`, `UNMODIFIED`, `DELETED`, `SKIPPED`, `FAILED`.
+ `sync_result` - 높은 수준의 가용성 결과입니다. 값: `AVAILABLE` 또는 `UNAVAILABLE`.
+ `sync_id` - 작업 실행 ID를 동기화합니다.
+ `data_source_id` - 지식 기반이 연결된 데이터 소스의 식별자입니다.
+ `source_uri` - 문서의 소스 URL입니다.
+ `error_message` - 상태가 `FAILED` 또는 인 경우 오류 설명입니다`SKIPPED`.
+ `error_mitigation` - 오류 해결을 위한 실행 가능한 지침입니다.
+ `error_type` - 상태가 `FAILED` 또는 인 경우 오류 코드입니다`SKIPPED`.
+ `knowledge_base_id` - 로그를 생성한 지식 기반의 UUID입니다.
다음 표에서는 `document_status` 값과 해당에 대해 설명합니다`sync_result`.
| document\_status | sync\_result | 의미 |
| --- | --- | --- |
| ADDED | AVAILABLE | 새 문서가 성공적으로 인덱싱되었습니다. |
| MODIFIED | AVAILABLE | 변경 사항으로 다시 인덱싱된 기존 문서 |
| UNMODIFIED | AVAILABLE | 문서 콘텐츠 변경되지 않음, 재인덱싱 필요 없음 |
| DELETED | UNAVAILABLE | 인덱스에서 제거된 문서 |
| SKIPPED | UNAVAILABLE | robots.txt 또는 크기 제한을 기준으로 크롤링 중에 필터링된 문서 |
| FAILED | UNAVAILABLE | 크롤링 또는 인덱싱 중 실패한 문서 |
다음 예제는 지식 기반에 문서가 추가된 성공적인 지식 기반 파일 동기화 로그를 보여줍니다.
```
{
"resource_arn": "arn:aws:quicksight:us-west-2:111122223333:account/111122223333",
"event_timestamp": 1781296858575,
"log_type": "KB_FILE_SYNC_LOGS",
"account_id": "111122223333",
"document_id": "https://docs.aws.amazon.com/quick/latest/userguide/monitoring-cloudwatch-logs.html",
"document_title": "Monitoring Amazon QuickSight usage using CloudWatch Logs",
"document_status": "ADDED",
"sync_result": "AVAILABLE",
"sync_id": "86a70a9a-cad9-4fc6-8881-e3909c8954d2",
"data_source_id": "56225744-18bc-4373-a91f-861dd1c3d566",
"source_uri": "https://docs.aws.amazon.com/quick/latest/userguide/monitoring-cloudwatch-logs.html",
"knowledge_base_id": "b0bd0a47-8095-439d-9dff-c64bd5fe3fa3"
}
```
다음 예제는 검증 오류로 인해 크롤링을 건너뛰었던 건너뛴 문서 로그를 보여줍니다.
```
{
"resource_arn": "arn:aws:quicksight:us-west-2:111122223333:account/111122223333",
"event_timestamp": 1781296492951,
"log_type": "KB_FILE_SYNC_LOGS",
"account_id": "111122223333",
"document_id": "https://docs.aws.amazon.com/quick/latest/userguide/blocked-page.html",
"document_title": "Blocked Page",
"document_status": "SKIPPED",
"sync_result": "UNAVAILABLE",
"sync_id": "86a70a9a-cad9-4fc6-8881-e3909c8954d2",
"data_source_id": "56225744-18bc-4373-a91f-861dd1c3d566",
"source_uri": "https://docs.aws.amazon.com/quick/latest/userguide/blocked-page.html",
"error_message": "This URL wasn't crawled because crawling isn't allowed by its robots.txt file.",
"error_mitigation": "Contact the website administrator for assistance.",
"error_type": "VALIDATION_ERROR",
"knowledge_base_id": "b0bd0a47-8095-439d-9dff-c64bd5fe3fa3"
}
```
## 보안 고려 사항
+ **암호화** - 민감한 데이터에 고객 관리형 AWS KMS 키를 사용합니다.
+ **액세스 제어** - 최소 권한 IAM 정책을 구현합니다.
+ **데이터 보존** - 규정 준수 요구 사항에 적합한 보존 정책을 구성합니다.