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

# 의 분석 로깅 AWS Clean Rooms
<a name="query-logs"></a>

*분석 로깅*은의 기능입니다 AWS Clean Rooms. [공동 작업을 생성하고](create-collaboration.md) **분석 로깅**을 켜면 멤버는 쿼리의 관련 로그 또는 Amazon CloudWatch Logs의 작업 로그를 저장할 수 있습니다.

쿼리 로그 및 작업 로그를 통해 구성원은 쿼리가 분석 규칙을 준수하고 공동 작업 계약에 부합하는지 확인할 수 있습니다. 또한 쿼리 로그는 감사를 지원하는 데 도움이 됩니다.

 AWS Clean Rooms 콘솔에서 **분석 로깅** 옵션을 켜면 쿼리 로그에 다음이 포함됩니다.
+ `analysisRule`— 구성된 테이블의 분석 규칙.
+ `analysisTemplateArn`— 실행된 분석 템플릿(분석 규칙에 따라 표시됨).
+ `collaborationId`— 쿼리가 실행된 공동 작업의 고유 식별자입니다.
+ `configuredTableID`— 쿼리에서 참조되는 구성 테이블의 고유 식별자입니다.
+ `directQueryAnalysisRulePolicy.custom.allowedAnalysis`— 구성된 테이블에서 실행할 수 있는 분석 템플릿(분석 규칙에 따라 표시됨).
+ `directQueryAnalysisRulePolicy.v1.custom.allowedAnalysisProviders`— 쿼리 생성을 허용한 쿼리 제공자(분석 규칙에 따라 표시됨).
+ `errorCode` — 쿼리가 제대로 실행되지 않은 경우의 오류 코드입니다.
+ `errorMessage` — 쿼리가 제대로 실행되지 않은 경우의 오류 메시지입니다.
+ `eventID` – 쿼리 실행의 고유 식별자입니다. 2023년 8월 31일 이후에는 고유 식별자가 `protectedQueryID`와 동일합니다.
+ `eventTimestamp`— 쿼리 실행 시간.
+ `parameters.parametervalue`— 매개 변수 값(쿼리 텍스트에 따라 표시됨).
+ `queryText`— 쿼리 실행의 SQL 정의. 매개변수가 있는 경우 `:parametervalue`와 같이 레이블이 지정됩니다.
+ `queryValidationErrors`— 쿼리 검증 시 쿼리 오류가 발생했습니다.
+ `schemaName`— 쿼리에서 참조되는 구성된 테이블 연결의 이름입니다.
+ `status` — 쿼리의 실행 상태입니다.

# 쿼리 및 작업 로그 수신
<a name="receiving-query-logs"></a>

쿼리 로그 및 작업 로그를 설정 AWS Clean Rooms 하기 위해 외부에서 작업을 수행할 필요가 없습니다. AWS Clean Rooms 는 각 공동 작업 구성원이 [멤버십을 생성한 후 공동 작업을 위한 로그 그룹을 생성합니다](create-membership.md).

쿼리할 수 있는 멤버, 쿼리 및 작업을 실행할 수 있는 멤버, 결과를 받을 수 있는 멤버, 쿼리에서 구성 테이블이 참조되는 멤버는 쿼리 로그 또는 작업 로그를 받게 됩니다.

쿼리할 수 있는 구성원과 결과를 받을 수 있는 구성원은 쿼리에서 참조되는 각 구성 테이블에 대한 쿼리 로그를 받게 됩니다. 구성된 테이블을 소유하지 않으면 구성된 테이블 ID(`configuredTableID`)를 볼 수 없습니다.

쿼리 및 작업을 실행할 수 있는 구성원과 결과를 받을 수 있는 구성원은 작업에서 참조되는 구성된 각 테이블에 대한 작업 로그를 수신합니다. 구성된 테이블을 소유하지 않으면 구성된 테이블 ID(`configuredTableID`)를 볼 수 없습니다.

쿼리에서 참조되는 구성된 테이블 연결이 여러 개 있는 구성원이 있는 경우 구성원은 구성된 각 테이블에 대한 쿼리 로그를 받게 됩니다.

멤버가 작업에서 여러 개의 구성된 테이블 연결을 참조하는 경우 구성된 각 테이블에 대한 작업 로그를 받게 됩니다.

 AWS Clean Rooms에서 지원되지 않는 SQL과 지원되는 SQL이 포함된 쿼리에 대한 로그가 생성됩니다. 자세한 내용은 [AWS Clean Rooms SQL 참조](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html)를 참조하세요.

쿼리 또는 작업이 공동 작업과 연결되지 않은 구성된 테이블을 참조할 때도 로그가 생성됩니다.

로그에는 잘못된 SQL에 대한 정보가 포함될 수 있습니다.

쿼리 및 작업 로그는 쿼리의 상태를 나타내지만 쿼리 출력이 전달되었는지 여부는 보고하지 않습니다. 쿼리할 수 있는 구성원이 쿼리 또는 작업을 제출했는지 확인합니다. 또한 쿼리 로그는 쿼리에에서 지원되는 SQL이 포함되어 있고 공동 작업 AWS Clean Rooms 과 연결된 구성된 테이블을 참조하는지 확인합니다.

**Example**  
예를 들어 분석 규칙 준수 여부를 AWS Clean Rooms 확인한 후 쿼리 처리 중에 쿼리가 취소된 경우 로그가 생성되지 않습니다.

로그 그룹을 삭제하는 경우 동일한 로그 그룹 이름(공동 작업의 공동 작업 ID)을 사용하여 로그 그룹을 수동으로 다시 만들어야 합니다. 또는 멤버십에서 로그오프 및 로그온을 해제할 수 있습니다.

분석 로깅을 켜는 방법에 대한 자세한 내용은 섹션을 참조하세요[공동 작업 생성](create-collaboration.md).

Amazon CloudWatch Logs에 대한 자세한 내용은 [Amazon CloudWatch Logs 사용자 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html)를 참조하세요.

# 쿼리 및 작업 로그에 대한 권장 작업
<a name="using-query-logs"></a>

회원은 정기적으로 다음 조치를 취하는 것이 좋습니다.
+ 쿼리와 작업이 공동 작업에 대해 합의된 사용 사례 또는 쿼리와 일치하는지 확인하려면 공동 작업에서 실행되는 쿼리와 작업을 검토합니다.

  최근 쿼리를 보는 방법에 대한 자세한 내용은 [최근 쿼리 보기](https://docs.aws.amazon.com/clean-rooms/latest/userguide/query-data.html#view-queries-console)를 참조하세요.

  최근 작업을 보는 방법에 대한 자세한 내용은 섹션을 참조하세요[최근 작업 보기](view-recent-jobs.md).
+ 구성된 테이블 열이 공동 작업에 대해 합의된 내용과 일치하는지 확인하려면 공동 작업 구성원의 분석 규칙 및 쿼리에 사용되는 구성된 테이블 열을 검토하세요.

  구성된 열을 보는 방법에 대한 자세한 내용은 [테이블 및 분석 규칙 보기](https://docs.aws.amazon.com/clean-rooms/latest/userguide/manage-configured-tables.html#view-tables)를 참조하세요.