Amazon Redshift는 패치 198부터 새 Python UDF 생성을 더 이상 지원하지 않습니다. 기존 Python UDF는 2026년 6월 30일까지 계속 작동합니다. 자세한 내용은 [블로그 게시물](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)을 참조하세요.
# Amazon Redshift Serverless에 대한 감사 로깅
연결, 사용자 및 사용자 활동 로그 데이터를 Amazon CloudWatch Logs의 로그 그룹으로 내보내도록 Amazon Redshift Serverless를 구성할 수 있습니다. Amazon CloudWatch Logs를 통해 로그 데이터에 대한 실시간 분석을 수행할 수 있고, CloudWatch를 사용하여 경보를 만들고 지표를 볼 수 있습니다. CloudWatch Logs를 사용하여 내구성이 우수한 스토리지에 로그 레코드를 저장할 수 있습니다.
Amazon Redshift 콘솔을 사용하여 지표를 추적하는 CloudWatch 경보를 생성할 수 있습니다. 경보 생성에 대한 자세한 내용은 [경보 관리](https://docs.aws.amazon.com/redshift/latest/mgmt/performance-metrics-alarms.html)를 참조하세요.
생성된 로그 데이터를 Amazon CloudWatch Logs로 내보내려면 콘솔의 Amazon Redshift Serverless 구성 설정에서 내보낼 각 로그를 선택해야 합니다. **보안 및 암호화**에서 **네임스페이스 구성** 설정을 선택하여 이 작업을 수행할 수 있습니다.
## CloudWatch의 로그 이벤트
내보낼 Redshift 로그를 선택한 후 Amazon CloudWatch Logs에서 이벤트를 모니터링할 수 있습니다. Amazon Redshift Serverless에 대한 새 로그 그룹이 자동으로 생성됩니다. 여기서 `log_type`은 로그 유형을 나타냅니다.
```
/aws/redshift//
```
첫 번째 작업 그룹과 네임스페이스를 만들 때 *기본값*은 네임스페이스 이름입니다. 로그 그룹 이름은 네임스페이스의 이름에 따라 달라집니다.
예를 들어 연결 로그를 내보내면 로그 데이터는 다음 로그 그룹에 저장됩니다.
```
/aws/redshift/default/connectionlog
```
로그 이벤트는 서버리스 로그 스트림을 사용하여 로그 그룹으로 내보내집니다. 다음 조건 중 어디에 해당하는지에 따라 달라집니다.
+ **지정된 이름의 로그 그룹이 존재합니다.** Redshift는 기존 로그 그룹을 사용하여 로그 데이터를 내보냅니다. **AWS CloudFormation**에서 제공하는 것과 같은 자동 구성을 사용하여 미리 정의된 로그 보존 기간, 지표 필터 및 고객 액세스 권한이 있는 로그 그룹을 생성할 수 있습니다.
+ **지정된 이름의 로그 그룹이 존재하지 않습니다.** 인스턴스의 로그에서 일치하는 로그 항목이 감지되면 Amazon Redshift Serverless는 Amazon CloudWatch Logs에 새 로그 그룹을 자동으로 생성합니다. 이 로그 그룹에는 기본 로그 보존 기간인 *만료되지 않음(Never Expire)*이 사용됩니다. 로그 보존 기간을 변경하려면 Amazon CloudWatch Logs 콘솔, AWS CLI 또는 Amazon CloudWatch Logs API를 사용합니다. CloudWatch Logs의 로그 보존 기간 변경에 대한 자세한 내용은 [로그 그룹 및 로그 스트림 작업](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)의 *로그 데이터 보존 변경*을 참조하세요.
로그 이벤트 내에서 정보를 검색하려면 CloudWatch Logs 콘솔, AWS CLI 또는 Amazon CloudWatch Logs API를 사용합니다. 로그 데이터 검색 및 필터링에 대한 자세한 내용은 [로그 데이터 검색 및 필터](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/MonitoringLogData.html)를 참조하세요.
## CloudWatch 지표
Amazon Redshift Serverless 지표는 컴퓨팅 지표와 데이터 및 스토리지 지표로 나뉘며, 각각 작업 그룹 및 네임스페이스 차원 세트에 속합니다. 작업 그룹 및 네임스페이스에 대한 자세한 내용은 [작업 그룹 및 네임스페이스](https://docs.aws.amazon.com/redshift/latest/mgmt/serverless-workgroups-and-namespaces.html)를 참조하세요.
CloudWatch 컴퓨팅 지표는 다음과 같습니다.
| 지표 이름 | 단위 | 설명 | 차원 세트 |
| --- | --- | --- | --- |
| QueriesCompletedPerSecond | 쿼리 수 | 초당 완료된 쿼리 수입니다. | {Database, LatencyRange, Workgroup}, {LatencyRange, Workgroup} |
| QueryDuration | 마이크로초 | 쿼리를 완료하는 데 걸리는 평균 시간입니다. | {Database, LatencyRange, Workgroup}, {LatencyRange, Workgroup} |
| QueriesRunning | 쿼리 수 | 특정 시점에 실행 중인 쿼리의 수입니다. | {Database, QueryType, Workgroup}, {QueryType, Workgroup} |
| QueriesQueued | 쿼리 수 | 특정 시점에 대기열에 있는 쿼리의 수입니다. | {Database, QueryType, Workgroup}, {QueryType, Workgroup} |
| DatabaseConnections | 연결 수 | 특정 시점에 데이터베이스의 연결 수입니다. | {Database, Workgroup}, {Workgroup} |
| QueryRuntimeBreakdown | 밀리초 | 쿼리 단계에서 실행한 총 쿼리 시간입니다. | {Database, Stage, Workgroup}, {Stage, Workgroup} |
| ComputeCapacity | RPU | 지난 30분간 할당된 평균 컴퓨팅 단위 수로, 가장 가까운 정수로 반올림됩니다. | {Workgroup} |
| ComputeSeconds | RPU-seconds | 지난 30분간 사용된 누적 컴퓨팅 단위(초)입니다. | {Workgroup} |
| QueriesSucceeded | 쿼리 수 | 지난 5분간 성공한 쿼리 수입니다. | {Database, QueryType, Workgroup}, {QueryType, Workgroup} |
| QueriesFailed | 쿼리 수 | 지난 5분간 실패한 쿼리 수입니다. | {Database, QueryType, Workgroup}, {QueryType, Workgroup} |
| UsageLimitAvailable | RPU 시간 또는 TB | UsageType에 따라 UsageLimitAvailable은 다음을 반환합니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/serverless-audit-logging.html) | {UsageLimitId, UsageType, Workgroup} |
| UsageLimitConsumed | RPU 시간 또는 TB | UsageType에 따라 UsageLimitConsumed는 다음을 반환합니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/serverless-audit-logging.html) | {UsageLimitId, UsageType, Workgroup} |
| ExtraComputeForAutomaticOptimizationChargedSeconds | RPU-seconds | 지난 30분 동안 자동 최적화 작업에 대해 청구된 컴퓨팅 단위 초 수입니다. | {Workgroup} |
CloudWatch 데이터 및 스토리지 지표는 다음과 같습니다.
| 지표 이름 | 단위 | 설명 | 차원 세트 |
| --- | --- | --- | --- |
| TotalTableCount | 테이블 수 | 특정 시점에 존재하는 사용자 테이블의 수입니다. 이 합계에는 Amazon Redshift Spectrum 테이블이 포함되지 않습니다. | {Database, Namespace} |
| DataStorage | MB | 디스크 또는 스토리지 공간에서 Redshift 데이터에 사용된 메가바이트 수입니다. | {Namespace} |
`SnapshotStorage` 지표는 네임스페이스 및 작업 그룹에 구애받지 않습니다. CloudWatch의 `SnapshotStorage` 지표는 다음과 같습니다.
| 지표 이름 | 단위 | 설명 | 차원 세트 |
| --- | --- | --- | --- |
| SnapshotStorage | MB | 디스크 또는 스토리지 공간에서 스냅샷에 사용된 메가바이트 수입니다. | {} |
차원 세트는 지표에 적용되는 그룹화 차원입니다. 이러한 차원 그룹을 사용하여 통계 검색 방법을 지정할 수 있습니다.
다음 표에서는 특정 지표에 대한 차원 및 차원 값에 대해 자세히 설명합니다.
| 측정 기준 | 설명 및 값 |
| --- | --- |
| DatabaseName | 데이터베이스의 이름입니다. 사용자 지정 값입니다. |
| Latency | 가능한 값은 다음과 같습니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/serverless-audit-logging.html) |
| QueryType | 가능한 값은 INSERT, DELETE, UPDATE, UNLOAD, LOAD, SELECT, CTAS, OTHER입니다. |
| stage | 쿼리 실행 단계 가능한 값은 다음과 같습니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/serverless-audit-logging.html) |
| Namespace | 네임스페이스의 이름입니다. 사용자 지정 값입니다. |
| Workgroup | 작업 그룹의 이름입니다. 사용자 지정 값입니다. |
| UsageLimitId | 사용량 한도의 식별자입니다. |
| UsageType | 제한되는 Amazon Redshift Serverless 기능입니다. 가능한 값은 다음과 같습니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/serverless-audit-logging.html) |