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/)을 참조하세요.

# 쿼리 및 데이터베이스 모니터링
<a name="metrics-enhanced-query-monitoring"></a>

이 문서에서는 Amazon Redshift 프로비저닝된 클러스터 또는 서버리스 작업 그룹과 이에 대해 실행되는 쿼리의 성능을 분석하는 AWS Management Console 기능인 쿼리 및 데이터베이스 모니터링 페이지를 설명합니다.

쿼리 및 데이터베이스 모니터링 페이지를 사용하여 다음 시나리오를 조사할 수 있습니다.
+ 지정된 기간 동안 데이터 웨어하우스 지표 모니터링
+ 쿼리가 데이터 웨어하우스의 전체 성능에 미치는 영향
+ 쿼리 실행 시간을 잠금 대기 시간, 컴파일 시간, 실행 시간과 같은 수명 주기 이벤트로 구분하여 확인
+ 지정된 기간 동안 가장 리소스 집약적인 쿼리를 실행하는 사용자
+ 패치 이벤트가 쿼리 성능에 미치는 영향 모니터링

**Topics**
+ [권한](#metrics-enhanced-query-monitoring-permissions)
+ [쿼리 및 데이터베이스 모니터링 콘솔](#metrics-enhanced-query-monitoring-console)

## 권한
<a name="metrics-enhanced-query-monitoring-permissions"></a>

콘솔에 액세스하는 데 사용하는 AWS 계정의 권한은 **쿼리 및 데이터베이스 모니터링** 페이지에 표시되는 쿼리에 영향을 줍니다. 기본적으로 자신의 쿼리만 볼 수 있습니다. 다른 사용자가 소유한 쿼리를 보려면 계정에 `SYS:MONITOR` 역할을 부여하세요. 사용자가 **쿼리 및 데이터베이스 모니터링** 페이지에서 실행 중인 쿼리를 종료하도록 허용하려면 사용자에게 `SYS:OPERATOR` 권한을 부여하세요.

Amazon Redshift Serverless 또는 프로비저닝됨에 대한 IAM 사용자 또는 역할에 `sys:monitor` 역할을 자동으로 할당하려면 다음 명령을 실행하세요.

```
create role monitor;
grant role sys:monitor to role monitor;
```

쿼리 모니터링에 사용되는 IAM 역할을 업데이트하려면 다음을 수행하세요.

1. **태그** 탭을 선택합니다.

1. **태그 관리**를 선택합니다.

1. **RedshiftDbRoles** 키와 **monitor** 값을 사용하여 태그를 추가합니다.

1. 변경 내용을 저장합니다.

사용자에게 데이터베이스 자격 증명을 추가하려면 다음 명령을 실행하세요.

```
grant role sys:monitor to <username>
```

GRANT 명령 사용에 대한 자세한 내용은 *Amazon Redshift 데이터베이스 개발자 안내서*의 [GRANT](https://docs.aws.amazon.com/redshift/latest/dg/r_GRANT.html)를 참조하세요.

쿼리 모니터링을 사용하려면 IAM 사용자에게 Amazon Redshift 데이터 플레인에 액세스할 수 있는 권한이 필요합니다. IAM 사용자의 권한 정책에 다음 권한이 있는지 확인해야 합니다.

```
{
    "Sid": "DataAPIPermissions",
    "Action": [
        "redshift-data:ExecuteStatement",
        "redshift-data:CancelStatement",
        "redshift-data:GetStatementResult",
        "redshift-data:DescribeStatement",
        "redshift-data:ListDatabases"
    ],
    "Effect": "Allow",
    "Resource": "arn:aws:redshift-serverless:us-west-2:123456789012:workgroup/01234567-89ab-cdef-0123-456789abcdef"
},
```

### IAM 자격 증명을 사용한 임시 자격 증명
<a name="metrics-enhanced-query-monitoring-permissions-temp-iam"></a>

이 옵션은 클러스터에 연결할 때만 사용할 수 있습니다. 이 방법을 사용하면 쿼리 및 데이터베이스 모니터링이 사용자 이름을 IAM ID에 매핑하고 IAM ID로 데이터베이스에 연결하기 위한 임시 암호를 생성합니다. 이 메서드를 사용하여 연결하는 사용자에게는 `redshift:GetClusterCredentialsWithIAM`에 대한 IAM 권한이 허용되어야 합니다. 사용자가 이 메서드를 사용하지 못하도록 하려면 IAM 사용자 또는 역할을 수정하여 이 권한을 거부합니다.

## 쿼리 및 데이터베이스 모니터링 콘솔
<a name="metrics-enhanced-query-monitoring-console"></a>

이 섹션에서는 쿼리 및 데이터베이스 모니터링 콘솔 페이지 사용에 대해 설명합니다.

쿼리 및 데이터베이스 모니터링 콘솔을 사용하여 데이터 웨어하우스의 성능 개요를 빠르게 확인할 수 있습니다. 시간 경과에 따른 데이터 웨어하우스의 성능을 모니터링하고 데이터 웨어하우스의 프로비저닝된 클러스터 또는 개별 쿼리의 성능을 조사하여 병목 현상과 기타 개선할 영역을 효과적으로 식별할 수 있습니다.

**쿼리 및 데이터베이스 모니터링** 페이지에는 다음과 같은 기능이 있습니다.
+ **보안 강화** - 다른 사용자의 쿼리를 모니터링하려면 높은 권한이 필요합니다. 자세한 내용은 [권한](#metrics-enhanced-query-monitoring-permissions) 섹션을 참조하세요.
+ **7일 쿼리 기록** - 7일간의 쿼리 기록에 대한 액세스를 보장합니다.
+ **쿼리 모니터링** - 사용자 쿼리 수준에서 프로비저닝된 클러스터 및 서버리스 작업 그룹의 쿼리를 모니터링할 수 있습니다.
+ **쿼리 추세 분석** - 지정된 기준과 일치하는 유사한 쿼리들의 성능을 비교할 수 있습니다.

쿼리 및 데이터베이스 모니터링 페이지에 액세스하려면 다음을 수행합니다.

1. [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)에서 Amazon Redshift에 로그인합니다.

1. 탐색 창에서 **쿼리 및 데이터베이스 모니터링**을 선택합니다.

**쿼리 및 데이터베이스 모니터링** 콘솔 페이지는 다음과 같이 나타납니다.

![\[Query and database monitoring dashboard showing data warehouse overview, performance summary, and profiler sections.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/metrics_eqm_homepage.png)


**쿼리 및 데이터베이스 모니터링** 페이지에는 다음과 같은 구성 요소가 있습니다.
+ **데이터 웨어하우스 개요** - 프로비저닝된 클러스터와 서버리스 작업 그룹의 평균 쿼리 성능을 모니터링합니다. 이 페이지에 있는 통계에서 스파이크 또는 활동량이 많은 기간을 조사하여 특정 클러스터 또는 작업 그룹의 성능 문제를 빠르게 확인할 수 있습니다.
+ **쿼리 성능 요약** - 특정 프로비저닝된 클러스터 또는 서버리스 작업 그룹의 평균 쿼리 성능을 모니터링합니다. **데이터 웨어하우스 개요** 목록에서 클러스터 또는 작업 그룹 중 하나를 클릭하여 **쿼리 성능 요약** 페이지에 액세스할 수도 있습니다.

**Topics**
+ [쿼리 성능 요약](#metrics-enhanced-query-monitoring-console-summary)
+ [쿼리 세부 정보](#metrics-enhanced-query-monitoring-console-query-details)
+ [쿼리 패턴](#metrics-enhanced-query-monitoring-console-query-pattern)

### 쿼리 성능 요약
<a name="metrics-enhanced-query-monitoring-console-summary"></a>

**쿼리 및 데이터베이스 모니터링** 페이지에서 **쿼리 성능 요약**을 선택하거나 **데이터 웨어하우스 개요** 페이지에서 클러스터 또는 작업 그룹을 선택하면 콘솔에 개별 프로비저닝된 클러스터 또는 서버리스 작업 그룹의 성능 요약이 표시됩니다.

![\[Query and database monitoring interface showing performance graph and query history for redshift-클러스터-1.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/metrics_eqm_clusterdetails.png)


이 페이지에는 다음과 같은 구성 요소가 있습니다.
+ **클러스터 또는 작업 그룹 드롭다운** - 분석하려는 클러스터 또는 작업 그룹을 선택합니다.
+ **데이터 웨어하우스 성능** - 이 창에는 지정된 기간 내 클러스터 또는 작업 그룹의 기록이 표시되며 쿼리의 각 단계에 소요된 시간이 나타납니다. 앞의 그래픽에서 1월 20일에 계획 및 실행 시간이 늘어나는 것과 같이 특정 쿼리 단계에서 스파이크가 나타나는 경우 이 정보를 사용하여 쿼리 성능과 관련된 문제를 식별할 수 있습니다. 표시되는 기본 기간은 지난 7일이지만 분석 요구 사항에 따라 기간을 조정할 수 있습니다.
+ **쿼리 기록** - 이 창에는 지정된 필터 내에서 실행된 모든 쿼리의 성능 기록이 표시됩니다. 이 정보를 사용하여 개별 쿼리의 성능 문제를 해결할 수 있습니다. 특정 쿼리를 추가로 분석하려면 이 그래프 또는 **데이터 웨어하우스 성능** 그래프에서 쿼리를 선택합니다.

  차트의 데이터 포인트 위로 마우스를 가져가면 팝업이 나타납니다. 이 팝업에는 해당 데이터 포인트에 대한 시간 지표의 분석 정보가 표시됩니다. 데이터 포인트에 쿼리 데이터가 포함된 경우 **드릴다운**을 선택하여 차트의 시간 범위를 데이터 포인트의 다음으로 작은 시간 단위로 업데이트할 수 있습니다. 이러한 시간 단위는 다음과 같습니다.
  + 일
  + 시간
  + 15분
  + 5분
  + 1분

  예를 들어 데이터 포인트에서 **드릴다운**을 선택하면 그래프 범위가 1일로 변경됩니다. **드릴다운**을 다시 선택하면 그래프 범위가 1시간으로 변경됩니다.
+ **쿼리 프로파일러** - 쿼리 성능을 모니터링하기 위한 그래픽 도구입니다. 자세한 내용은 [쿼리 프로파일러](using-query-plan-profiler.md) 섹션을 참조하세요.

### 쿼리 세부 정보
<a name="metrics-enhanced-query-monitoring-console-query-details"></a>

클러스터 또는 작업 그룹 세부 정보 페이지의 **데이터 웨어하우스 성능** 또는 **쿼리 기록** 창에서 쿼리를 선택하면 **쿼리 세부 정보** 페이지가 열립니다.

![\[Query details page showing query information, elapsed time breakdown, and SQL details.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/metrics_eqm_querydetails.png)


**쿼리 세부 정보** 페이지에 대한 자세한 내용은 [쿼리 세부 정보 페이지](using-query-plan-profiler.md#using-query-plan-profiler-ui-query-details) 섹션을 참조하세요.

### 쿼리 패턴
<a name="metrics-enhanced-query-monitoring-console-query-pattern"></a>

**쿼리 성능 요약** 페이지의 **쿼리 기록** 창에서 **쿼리 패턴 보기** 버튼을 선택하여 동일한 패턴의 쿼리에 대한 기록을 볼 수 있습니다. **쿼리 패턴** 페이지에는 지정한 SQL 문으로 검색된 지난 주의 모든 쿼리가 표시됩니다.

![\[Query pattern page showing performance trend graph and history table of queries.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/metrics_eqm_querypattern.png)


**쿼리 패턴** 페이지에는 다음과 같은 구성 요소가 있습니다.
+ **쿼리 패턴** - 분석 중인 쿼리를 검색하는 SQL 문입니다.
+ **쿼리 성능 추세 분석** - 쿼리 패턴에서 선택된 모든 쿼리의 경과 시간을 보여주는 막대 그래프입니다. 결과는 일별로 그룹화됩니다.
+ **동일한 패턴의 쿼리 기록** - 쿼리 패턴에서 선택된 쿼리의 각 단계에 소요된 시간입니다.

**쿼리 패턴** 페이지에서는 다음과 같은 인사이트를 얻을 수 있습니다.
+ 매일 특정 시간에 실행되는 쿼리에 관한 추세
+ 데이터 웨어하우스에 대해 정기적으로 실행되는 쿼리의 실행 시간 급증