# 쿼리별 및 데이터베이스 카운터 세부 지표 활성화 및 비활성화 Database Insights 고급 모드를 선택하면 쿼리별 및 데이터베이스 카운터 세부 지표가 기본적으로 활성화됩니다. Database Insights 표준 모드를 선택하면 DB 인스턴스 또는 다중 AZ DB 클러스터를 생성할 때 이를 활성화하고 나중에 콘솔에서 DB 인스턴스를 수정하여 비활성화할 수 있습니다. 쿼리별 및 데이터베이스 카운터 세부 지표를 활성화할 때는 가동 중지 시간, 재부팅 또는 장애 조치가 발생하지 않습니다. **참고** 성능 스키마는 Amazon RDS for MariaDB 또는 Amazon RDS for MySQL에서 사용하는 선택적 성능 도구입니다. 성능 스키마를 켜거나 끄면 재부팅해야 합니다. 하지만 쿼리별 및 데이터베이스 카운터 세부 지표를 활성화하거나 비활성화하는 경우 재부팅이 필요 없습니다. 자세한 내용은 [Amazon RDS for MariaDB 또는 MySQL Database Insights의 성능 스키마 개요](USER_PerfInsights.EnableMySQL.md) 섹션을 참조하세요. Database Insights 에이전트는 DB 호스트에서 제한된 CPU 및 메모리를 사용합니다. DB 로드가 높을 경우 에이전트는 데이터 수집 빈도를 줄여 성능에 미치는 영향을 제한합니다. ------ #### [ Console ] 콘솔에서 DB 인스턴스 또는 다중 AZ DB 클러스터를 생성하거나 수정할 때 Database Insights 표준 모드 적용 시 쿼리별 및 데이터베이스 카운터 세부 지표가 수집되도록 설정할 수 있습니다. **DB 인스턴스 또는 다중 AZ DB 클러스터를 생성할 때 쿼리별 및 데이터베이스 카운터 세부 지표 활성화 또는 비활성화** 새 DB 인스턴스 또는 다중 AZ DB 클러스터를 만든 후 Amazon RDS는 기본적으로 쿼리별 및 데이터베이스 카운터 세부 지표를 활성화합니다. 이를 비활성화하려면 **Database Insights – 표준** 옵션을 선택하고 **쿼리별 및 데이터베이스 카운터 세부 지표 수집 활성화** 옵션을 선택 취소합니다. 자세한 내용은 다음 항목을 참조하세요. + DB 인스턴스를 생성하려면 [Amazon RDS DB 인스턴스 생성](USER_CreateDBInstance.md)의 DB 엔진에 대한 지침을 따르십시오. + DB 클러스터를 만들려면 [Amazon RDS용 다중 AZ DB 클러스터 생성](create-multi-az-db-cluster.md) 섹션의 지침을 따르세요. 다음 이미지는 **Database Insights** 섹션의 스크린샷입니다. ![DB 인스턴스 생성 페이지의 Database Insights 섹션(세부 데이터베이스 지표를 활성화하는 옵션 포함).](https://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/UserGuide/images/db_insights_enabling.png) **쿼리별 및 데이터베이스 카운터 세부 지표 수집 활성화**를 선택하면 다음과 같은 옵션을 사용할 수 있습니다. + **보존** – Database Insights 데이터를 유지할 시간입니다. 보존 설정은 **기본값(7일)**입니다. 성능 데이터를 더 오래 보존하려면 1\~24개월을 지정하십시오. 보존 기간에 대한 자세한 내용은 [Database Insights의 요금 및 데이터 보존](USER_PerfInsights.Overview.cost.md) 섹션을 참조하세요. + **AWS KMS key** – 을(를) 지정합니다..AWS KMS key Database Insights는 KMS 키를 사용하여 잠재적으로 민감한 데이터를 모두 암호화합니다. 데이터는 암호화된 상태로 전송 및 저장됩니다. 자세한 내용은 [Database Insights에 대한 KMS 키 정책 변경](USER_PerfInsights.access-control.cmk-policy.md)을 참조하세요. **DB 인스턴스 또는 다중 AZ DB 클러스터를 수정할 때 쿼리별 및 데이터베이스 카운터 세부 지표 활성화 또는 비활성화** 콘솔에서 DB 인스턴스 또는 다중 AZ DB 클러스터를 수정하여 Database Insights의 쿼리별 및 데이터베이스 카운터 세부 지표를 관리할 수 있습니다. **콘솔을 사용하여 DB 인스턴스 또는 다중 AZ DB 클러스터에 대한 쿼리별 및 데이터베이스 카운터 세부 지표를 관리하려면** 1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)에서 Amazon RDS 콘솔을 엽니다. 1. **데이터베이스**를 선택합니다. 1. DB 인스턴스 또는 다중 AZ DB 클러스터를 선택하고 **수정**을 선택합니다. 1. **쿼리별 및 데이터베이스 카운터 세부 지표 수집 활성화**를 선택하여 활성화합니다. 에 대해 이를 비활성화하려면 **Database Insights – 표준** 옵션을 선택하고 **쿼리별 및 데이터베이스 카운터 세부 지표 수집 활성화** 옵션을 선택 취소합니다. **쿼리별 및 데이터베이스 카운터 세부 지표 수집 활성화**를 선택하면 다음과 같은 옵션을 사용할 수 있습니다. + **보존** – Database Insights 데이터를 유지할 시간입니다. 보존 설정은 **기본값(7일)**입니다. 성능 데이터를 더 오래 보존하려면 1\~24개월을 지정하십시오. 보존 기간에 대한 자세한 내용은 [Database Insights의 요금 및 데이터 보존](USER_PerfInsights.Overview.cost.md) 섹션을 참조하세요. + **AWS KMS key** - KMS 키를 지정합니다. Database Insights는 KMS 키를 사용하여 잠재적으로 민감한 데이터를 모두 암호화합니다. 데이터는 암호화된 상태로 전송 및 저장됩니다. 자세한 내용은 [Amazon RDS 리소스 암호화](Overview.Encryption.md) 섹션을 참조하세요. ![DB 인스턴스 수정 페이지의 Database Insights 섹션(세부 데이터베이스 지표를 활성화하는 옵션 포함).](https://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/UserGuide/images/db_insights_enabling.png) 1. **Continue(계속)**를 선택합니다. 1. **Scheduling of Modifications(수정 사항 예약)**에 대해 Apply immediately(즉시 적용)를 선택합니다. 예약된 다음 유지 관리 기간에 적용을 선택하면 인스턴스에서 이 설정을 무시하고 쿼리별 및 데이터베이스 카운터 세부 지표 수집을 즉시 활성화합니다. 1. **Modify Instance(인스턴스 수정)**를 선택합니다. ------ #### [ AWS CLI ] [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) AWS CLI 명령을 사용하는 경우, `--enable-performance-insights`를 지정하고 `--database-insights-mode`를 `advanced` 또는 `standard`로 설정하여 쿼리별 및 데이터베이스 카운터 세부 지표를 활성화합니다. 이를 비활성화하려면 `--no-enable-performance-insights`를 지정하고 `database-insights-mode`를 `standard`로 설정합니다. 다음 AWS CLI 명령을 사용해 다음 값을 지정할 수도 있습니다. + [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) + [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) + [create-db-instance-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html) + [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) + [restore-db-instance-from-s3](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-instance-from-s3.html) CLI에서 쿼리별 및 데이터베이스 카운터 세부 지표를 활성화하는 경우 `--performance-insights-retention-period` 옵션을 사용하여 데이터를 유지할 일수를 선택적으로 지정할 수 있습니다. `7`, {{월}} \* 31({{월}}은 1\~23 사이의 숫자여야 함) 또는 `731`이라고 지정할 수 있습니다. 예를 들어 성능 데이터를 3개월 동안 보존하려면 3에 31을 곱한 `93`을 지정하면 됩니다. 기본값은 `7`일입니다. 보존 기간에 대한 자세한 내용은 [Database Insights의 요금 및 데이터 보존](USER_PerfInsights.Overview.cost.md) 섹션을 참조하세요. 다음 예시에서는 `sample-db-cluster`에 대한 쿼리별 및 데이터베이스 카운터 세부 지표를 활성화하고 데이터가 93일(3개월) 동안 유지되도록 지정합니다. 대상 LinuxmacOS, 또는Unix: ``` aws rds modify-db-cluster \ --database-insights-mode standard \ --db-cluster-identifier sample-db-instance \ --enable-performance-insights \ --performance-insights-retention-period 93 ``` Windows의 경우: ``` aws rds modify-db-cluster ^ --database-insights-mode standard ^ --db-cluster-identifier sample-db-instance ^ --enable-performance-insights ^ --performance-insights-retention-period 93 ``` 보존 기간을 94일처럼 유효하지 않은 값으로 지정하면 RDS에서 오류가 발생합니다. ``` An error occurred (InvalidParameterValue) when calling the CreateDBInstance operation: Invalid Performance Insights retention period. Valid values are: [7, 31, 62, 93, 124, 155, 186, 217, 248, 279, 310, 341, 372, 403, 434, 465, 496, 527, 558, 589, 620, 651, 682, 713, 731] ``` **참고** DB 클러스터 수준에서 해당 지표를 관리하지 않는 경우에만, DB 클러스터 내 개별 인스턴스에 대한 쿼리별 및 데이터베이스 카운터 세부 지표 설정을 전환할 수 있습니다. ------ #### [ RDS API ] [CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) 작업 Amazon RDS API 작업을 사용하여 새 DB 인스턴스를 생성할 때 `EnablePerformanceInsights`를 `True`로 설정하면 쿼리별 및 데이터베이스 카운터 세부 지표가 활성화됩니다. 이를 비활성화하려면 `EnablePerformanceInsights`를 `False`로 설정하고 `DatabaseInsightsMode`를 `standard`로 설정합니다. 다음 API 작업으로 `EnablePerformanceInsights` 값을 지정할 수도 있습니다. + [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html)(다중 AZ DB 클러스터) + [ModifyDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html)(다중 AZ DB 클러스터) + [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) + [CreateDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html) + [RestoreDBInstanceFromS3](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromS3.html) 쿼리별 및 데이터베이스 카운터 세부 지표를 활성화하는 경우 `PerformanceInsightsRetentionPeriod` 파라미터를 사용하여 데이터를 유지할 기간(일수)을 선택적으로 지정할 수 있습니다. `7`, {{월}} \* 31({{월}}은 1\~23 사이의 숫자여야 함) 또는 `731`이라고 지정할 수 있습니다. 예를 들어 성능 데이터를 3개월 동안 보존하려면 3에 31을 곱한 `93`을 지정하면 됩니다. 기본값은 `7`일입니다. 보존 기간에 대한 자세한 내용은 [Database Insights의 요금 및 데이터 보존](USER_PerfInsights.Overview.cost.md) 섹션을 참조하세요. ------