측정항목 및 알림 정책 필터

이 문서에서는 데이터베이스 센터에서 생성된 측정항목을 간략하게 설명합니다. 또한 필터를 사용하여 차트로 표시되거나 알림 정책에 의해 모니터링되는 데이터를 제한하는 방법도 설명합니다. Cloud SQL, PostgreSQL용 AlloyDB, Spanner와 같은 데이터베이스 제품의 성능 문제를 식별하고 해결하려면 유용한 측정항목과 알림 정책에 관한 정보를 표시하는 맞춤 대시보드를 만드세요.

데이터베이스 센터 측정항목 유형

이 섹션에는 데이터베이스 센터에서 생성되는 측정항목 유형이 나열되어 있습니다.

이 표의 '측정항목 유형' 문자열 앞에 databasecenter.googleapis.com/가 포함된 프리픽스를 붙여야 합니다. 표의 항목에서는 이 프리픽스가 생략되었습니다. 라벨을 쿼리할 때 metric.labels. 프리픽스를 사용합니다(예: metric.labels.LABEL="VALUE").

측정항목 유형 ^{실행 단계}(리소스 계층 구조 수준) 표시 이름
종류, 유형, 단위 모니터링 리소스	설명 라벨
`resource/new_resource_count` ^베타 *(프로젝트)* 새 데이터베이스 리소스
`CUMULATIVE`, `INT64`, `1` databasecenter.googleapis.com/Resource	새 데이터베이스 리소스 수입니다. `product`: 제품 유형입니다. `engine`: 엔진 유형입니다. `version`: 제품 버전입니다.
`resource/new_signal_count` ^베타 *(프로젝트)* 새 데이터베이스 신호
`CUMULATIVE`, `INT64`, `1` databasecenter.googleapis.com/Resource	리소스에 대해 생성된 신호 수입니다. `issue_type`: 신호 유형입니다.

2026년 3월 4일 20:51:34(UTC)에 생성된 표입니다.

측정항목 필터 정보

차트 또는 알림 정책을 만들 때 필터를 추가하여 차트로 표시되거나 모니터링되는 측정항목 데이터를 제한할 수 있습니다. 예를 들어 특정 리소스의 데이터만 차트에 표시되도록 필터를 추가할 수 있습니다. 알림 정책의 차트와 알림은 문제를 해결하는 데 도움이 될 수 있습니다. 또한 데이터베이스 Fleet의 상태에 대한 자세한 정보를 얻는 데도 도움이 됩니다.

필터는 라벨 키와 라벨 값으로 구성됩니다. 예를 들어 라벨 키는 resource_container이고 라벨 값은 특정 리소스 컨테이너일 수 있습니다. 측정항목 라벨과 리소스 라벨을 기준으로 측정항목 데이터를 필터링할 수 있습니다.

측정항목 라벨을 사용하면 데이터베이스 제품 유형이나 신호 유형과 같은 측정항목 유형의 특성을 기반으로 알림을 필터링할 수 있습니다.
리소스 라벨을 사용하면 위치 또는 이름과 같은 모니터링된 리소스의 속성을 기반으로 알림을 필터링할 수 있습니다.

필터 값은 대소문자를 구분하며 이 문서의 표에 표시된 대로 정확하게 입력해야 합니다.

차트 또는 알림 정책에 여러 필터를 추가할 수 있습니다. 필터를 여러 개 추가하면 모든 라벨과 일치하는 측정항목 데이터만 표시됩니다.

이 문서의 나머지 부분에는 데이터베이스 센터에서 생성하는 측정항목 데이터를 필터링하는 데 사용할 수 있는 측정항목 라벨과 리소스 라벨이 나열되어 있습니다. 필터를 만들 때 이 문서에 나열된 필터 값을 필터 요소에 복사하여 붙여넣는 것이 좋습니다.

리소스 유형별로 필터링
제품, 엔진 또는 버전별로 필터링
신호 유형별로 필터링

리소스 유형별로 필터링

다음 라벨 키를 사용하면 리소스 유형별로 New database resources (resource/new_resource_count) 및 New database signals (Resource/new_signal_count) 측정항목 데이터를 필터링할 수 있습니다.

resource_container
monitored_resource_container
location
resource_type
full_resource_name

resource_type를 제외한 모든 라벨 키의 경우 Google Cloud 콘솔에서 필터를 만들 때 값 메뉴에 유효한 값이 모두 표시됩니다.

resource_type 라벨 키의 경우 Google Cloud 콘솔에서 선택할 수 있는 라벨 값 목록이 불완전할 수 있습니다. 다음 표를 사용하여 지원되는 리소스 유형을 선택하세요.

`resource_type`	정의
`alloydb.googleapis.com/Cluster`	PostgreSQL용 AlloyDB 클러스터입니다.
`alloydb.googleapis.com/Instance`	PostgreSQL용 AlloyDB 인스턴스입니다.
`bigtableadmin.googleapis.com/Cluster`	Bigtable 클러스터입니다.
`bigtableadmin.googleapis.com/Instance`	Bigtable 인스턴스입니다.
`compute.googleapis.com/Instance`	Compute Engine 인스턴스입니다.
`firestore.googleapis.com/Database`	Firestore 데이터베이스
`oracledatabase.googleapis.com/AutonomousDatabase`	Oracle Autonomous Database 리소스입니다.
`oracledatabase.googleapis.com/CloudExadataInfrastructure`	Oracle Cloud Exadata 인프라 리소스
`oracledatabase.googleapis.com/CloudVmCluster`	Oracle Cloud VM 클러스터 리소스
`redis.googleapis.com/Cluster`	Redis 클러스터
`redis.googleapis.com/Instance`	Redis 인스턴스
`spanner.googleapis.com/Instance`	Spanner 인스턴스입니다.
`sqladmin.googleapis.com/Instance`	Cloud SQL 인스턴스입니다.

제품, 엔진 또는 버전별로 필터링

New database resources (resource/new_resource_count) 측정항목 유형은 다음 라벨 키를 정의합니다.

product: 제품 유형
engine—엔진 유형
version: 제품 버전

다음 표의 각 행에는 유효한 라벨 값 조합이 나열되어 있습니다. 예를 들어 product=CLOUD_SQL 및 version=SQLSERVER_2022_WEB 필터를 차트에 추가하면 차트에 데이터가 표시될 수 있습니다. 하지만 차트에 product=CLOUD_SQL 및 version=2 필터를 추가하면 차트에 데이터가 표시되지 않습니다.

`product`	`engine`	`version`
`ALLOYDB`	`POSTGRES`	`14`, `15`, `16`, `17`
`BIGTABLE`	`NATIVE`	해당 사항 없음
`CLOUD_SQL`	`MYSQL`	`5.6`, `5.7`, `8.0`, `8.4`
`CLOUD_SQL`	`POSTGRES`	`9.6`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`
`CLOUD_SQL`	`SQL_SERVER`	`SQLSERVER_2017_EXPRESS`, `SQLSERVER_2017_STANDARD`, `SQLSERVER_2017_ENTERPRISE`, `SQLSERVER_2017_WEB`, `SQLSERVER_2019_EXPRESS`, `SQLSERVER_2019_STANDARD`, `SQLSERVER_2019_ENTERPRISE`, `SQLSERVER_2019_WEB`, `SQLSERVER_2022_EXPRESS`, `SQLSERVER_2022_STANDARD`, `SQLSERVER_2022_ENTERPRISE`, `SQLSERVER_2022_WEB`
`COMPUTE_ENGINE`	`MYSQL`, `POSTGRES`, `SQL_SERVER`	해당 사항 없음
`FIRESTORE`	`FIRESTORE_WITH_NATIVE_MODE`, `FIRESTORE_WITH_DATASTORE_MODE`, `FIRESTORE_WITH_MONGODB_COMPATIBILITY_MODE`	해당 사항 없음
`MEMORYSTORE`	`MEMORYSTORE_FOR_REDIS`	`3.2`, `4.0`, `5.0`, `6.X`, `7.0`, `7.2`
`MEMORYSTORE`	`MEMORYSTORE_FOR_REDIS_CLUSTER`	`7`
`ORACLE_ON_GCP`	`EXADATA_ORACLE`	19, 23
`ORACLE_ON_GCP`	`ADB_SERVERLESS_ORACLE`	19c, 23ai
`SPANNER`	`NATIVE`	해당 사항 없음

신호 유형별 필터링

New database signals (resource/new_signal_count) 측정항목 유형은 하나의 라벨 키 issue_type를 정의합니다. 이 라벨의 값은 신호 유형으로 설정됩니다.

issue_type 라벨 키의 경우 Google Cloud 콘솔에서 선택할 수 있는 리소스 유형 목록에 지원되는 값이 모두 포함되지 않을 수 있습니다. 다음 표를 사용하여 지원되는 신호 유형을 선택하세요.

`issue_type`	정의
`RESOURCE_FAILOVER_PROTECTED`	리소스가 장애 조치로 보호됩니다.
`GROUP_MULTIREGIONAL`	리소스가 멀티 리전 그룹에 속합니다.
`GROUP_REPLICA_POOL`	리소스가 복제본 풀에 속합니다.
`NO_AUTOMATED_BACKUP_POLICY`	리소스에 자동 백업 정책이 없습니다.
`SHORT_BACKUP_RETENTION`	리소스의 백업 보관 기간이 짧습니다.
`LAST_BACKUP_FAILED`	리소스의 마지막 백업이 실패했습니다.
`LAST_BACKUP_OLD`	리소스의 마지막 백업이 24시간 이상 지났습니다.
`VIOLATES_CIS_GCP_FOUNDATION_2_0`	리소스가 CIS Google Cloud Foundation 2.0 벤치마크를 위반합니다.
`VIOLATES_CIS_GCP_FOUNDATION_1_3`	리소스가 CIS Google Cloud Foundation 1.3 벤치마크를 위반합니다.
`VIOLATES_CIS_GCP_FOUNDATION_1_2`	리소스가 CIS Google Cloud Foundation 1.2 벤치마크를 위반합니다.
`VIOLATES_CIS_GCP_FOUNDATION_1_1`	리소스가 CIS Google Cloud Foundation 1.1 벤치마크를 위반합니다.
`VIOLATES_CIS_GCP_FOUNDATION_1_0`	리소스가 CIS Google Cloud Foundation 1.0 벤치마크를 위반합니다.
`VIOLATES_CIS_CONTROLS_V8_0`	리소스가 CIS Controls 8.0을 위반합니다.
`VIOLATES_NIST_800_53`	리소스가 NIST 800-53을 위반합니다.
`VIOLATES_NIST_800_53_R5`	리소스가 NIST 800-53 R5를 위반합니다.
`VIOLATES_NIST_CYBERSECURITY_FRAMEWORK_V1_0`	리소스가 NIST 사이버 보안 프레임워크 1.0을 위반합니다.
`VIOLATES_ISO_27001`	리소스가 ISO-27001을 위반합니다.
`VIOLATES_ISO_27001_V2022`	리소스가 ISO-27001 v2022를 위반합니다.
`VIOLATES_PCI_DSS_V3_2_1`	리소스가 PCI-DSS v3.2.1을 위반합니다.
`VIOLATES_PCI_DSS_V4_0`	리소스가 PCI-DSS v4.0을 위반합니다.
`VIOLATES_CLOUD_CONTROLS_MATRIX_V4`	리소스가 Cloud Controls Matrix 4를 위반합니다.
`VIOLATES_HIPAA`	리소스가 HIPAA를 위반합니다.
`VIOLATES_SOC2_V2017`	리소스가 SOC2 v2017을 위반합니다.
`LOGS_NOT_OPTIMIZED_FOR_TROUBLESHOOTING`	로그가 문제 해결에 최적화되지 않았습니다.
`QUERY_DURATIONS_NOT_LOGGED`	쿼리 기간이 로깅되지 않습니다.
`VERBOSE_ERROR_LOGGING`	오류 로깅이 상세 모드로 구성되어 있습니다.
`QUERY_LOCK_WAITS_NOT_LOGGED`	쿼리 잠금 대기가 로깅되지 않습니다.
`LOGGING_MOST_ERRORS`	문에 대한 오류 로깅이 잘못 구성되었습니다.
`LOGGING_ONLY_CRITICAL_ERRORS`	문 심각도에 대한 오류 로깅이 잘못 구성되었습니다.
`MINIMAL_ERROR_LOGGING`	메시지 심각도에 대한 오류 로깅이 잘못 구성되었습니다.
`QUERY_STATS_LOGGED`	쿼리 통계가 로깅되고 있습니다.
`EXCESSIVE_LOGGING_OF_CLIENT_HOSTNAME`	클라이언트 호스트 이름의 로깅이 과도합니다.
`EXCESSIVE_LOGGING_OF_PARSER_STATS`	파서 통계의 로깅이 과도합니다.
`EXCESSIVE_LOGGING_OF_PLANNER_STATS`	플래너 통계의 로깅이 과도합니다.
`NOT_LOGGING_ONLY_DDL_STATEMENTS`	DDL 문만 로깅하도록 구성되지 않았습니다.
`LOGGING_QUERY_STATS`	쿼리 통계가 로깅되고 있습니다.
`NOT_LOGGING_TEMPORARY_FILES`	임시 파일이 로깅되지 않습니다.
`CONNECTION_MAX_NOT_CONFIGURED`	최대 동시 연결 수가 구성되지 않았습니다.
`USER_OPTIONS_CONFIGURED`	사용자 옵션이 구성됩니다.
`EXPOSED_TO_PUBLIC_ACCESS`	리소스가 공개 액세스에 노출됩니다.
`UNENCRYPTED_CONNECTIONS`	리소스를 통해 암호화되지 않은 직접 연결이 허용됩니다.
`NO_ROOT_PASSWORD`	루트 사용자에게는 비밀번호가 없습니다.
`WEAK_ROOT_PASSWORD`	루트 사용자의 비밀번호가 취약합니다.
`ENCRYPTION_KEY_NOT_CUSTOMER_MANAGED`	암호화 키가 고객에 의해 관리되지 않습니다.
`SERVER_AUTHENTICATION_NOT_REQUIRED`	포함된 데이터베이스 인증이 사용 설정되어 있으므로 서버 인증이 필요하지 않습니다.
`EXPOSED_BY_OWNERSHIP_CHAINING`	리소스가 소유권 체이닝에 의해 노출됩니다.
`EXPOSED_TO_EXTERNAL_SCRIPTS`	리소스가 외부 스크립트에 노출됩니다.
`EXPOSED_TO_LOCAL_DATA_LOADS`	리소스가 로컬 데이터 로드에 노출됩니다.
`CONNECTION_ATTEMPTS_NOT_LOGGED`	연결 시도가 로깅되지 않습니다.
`DISCONNECTIONS_NOT_LOGGED`	연결 해제가 로깅되지 않습니다.
`LOGGING_EXCESSIVE_STATEMENT_INFO`	과도한 문 정보가 로깅되고 있습니다.
`EXPOSED_TO_REMOTE_ACCESS`	리소스가 원격 액세스에 노출됩니다.
`DATABASE_NAMES_EXPOSED`	데이터베이스 이름이 노출됩니다.
`SENSITIVE_TRACE_INFO_NOT_MASKED`	민감한 추적 정보가 마스킹되지 않습니다.
`PUBLIC_IP_ENABLED`	리소스에 공개 IP가 사용 설정되어 있습니다.
`IDLE`	리소스가 유휴 상태입니다.
`OVERPROVISIONED`	리소스가 초과 프로비저닝되었습니다.
`HIGH_NUMBER_OF_OPEN_TABLES`	리소스에 열린 테이블 수가 많습니다.
`HIGH_NUMBER_OF_TABLES`	리소스에 테이블이 많습니다.
`HIGH_TRANSACTION_ID_UTILIZATION`	리소스의 트랜잭션 ID 사용률이 높습니다.
`UNDERPROVISIONED`	리소스가 과소 프로비저닝되었습니다 (높은 리소스 사용률).
`OUT_OF_DISK`	리소스가 스토리지 용량에 도달했거나 근접합니다.
`SERVER_CERTIFICATE_NEAR_EXPIRY`	서버 인증서의 만료일이 임박했습니다.
`DATABASE_AUDITING_DISABLED`	데이터베이스 감사가 사용 중지되었습니다.
`RESTRICT_AUTHORIZED_NETWORKS`	리소스가 승인된 네트워크를 제한하는 정책을 위반합니다.
`VIOLATE_POLICY_RESTRICT_PUBLIC_IP`	리소스가 공개 IP를 제한하는 정책을 위반합니다.
`QUOTA_LIMIT`	리소스가 클러스터 할당량 한도에 근접했습니다.
`NO_PASSWORD_POLICY`	구성된 비밀번호 정책이 없습니다.
`CONNECTIONS_PERFORMANCE_IMPACT`	연결 수가 많아 디스크 성능에 영향을 미치고 있습니다.
`TMP_TABLES_PERFORMANCE_IMPACT`	임시 테이블 사용이 성능에 영향을 미치고 있습니다.
`TRANS_LOGS_PERFORMANCE_IMPACT`	트랜잭션 로그 활동이 디스크 성능에 영향을 미치고 있습니다.
`HIGH_JOINS_WITHOUT_INDEXES`	색인이 없는 조인 수가 많아 성능에 영향을 미치고 있습니다.
`SUPERUSER_WRITING_TO_USER_TABLES`	수퍼유저가 사용자 테이블에 쓰고 있습니다.
`USER_GRANTED_ALL_PERMISSIONS`	사용자에게 모든 권한이 부여되었습니다.
`DATA_EXPORT_TO_EXTERNAL_CLOUD_STORAGE_BUCKET`	데이터가 외부 Cloud Storage 버킷으로 내보내졌습니다.
`DATA_EXPORT_TO_PUBLIC_CLOUD_STORAGE_BUCKET`	데이터가 공개 Cloud Storage 버킷으로 내보내졌습니다.
`WEAK_PASSWORD_HASH_ALGORITHM`	취약한 비밀번호 해시 알고리즘이 사용되고 있습니다.
`NO_USER_PASSWORD_POLICY`	사용자 비밀번호 정책이 없습니다.
`HOT_NODE`	클러스터의 노드 사용률이 높습니다.
`NO_DELETION_PROTECTION`	삭제 보호가 사용 설정되지 않았습니다.
`NO_POINT_IN_TIME_RECOVERY`	PITR(point-in-time recovery)이 사용 설정되지 않았습니다.
`RESOURCE_SUSPENDED`	리소스가 정지되었습니다.
`EXPENSIVE_COMMANDS`	비용이 많이 드는 명령어가 실행되고 있습니다.
`NO_MAINTENANCE_POLICY_CONFIGURED`	유지보수 정책이 구성되지 않았습니다.
`INEFFICIENT_QUERY`	비효율적인 쿼리가 실행되고 있습니다.
`READ_INTENSIVE_WORKLOAD`	워크로드가 읽기 집약적입니다.
`MEMORY_LIMIT`	리소스가 메모리 등급 한도에 근접했습니다.
`MAX_SERVER_MEMORY`	최대 서버 메모리가 잘못 구성되었습니다.
`LARGE_ROWS`	큰 행이 감지되었습니다.
`HIGH_WRITE_PRESSURE`	리소스에 높은 쓰기 압력이 발생했습니다.
`HIGH_READ_PRESSURE`	리소스에 높은 읽기 압력이 발생하고 있습니다.
`ENCRYPTION_ORG_POLICY_NOT_SATISFIED`	조직의 암호화 정책이 충족되지 않습니다.
`LOCATION_ORG_POLICY_NOT_SATISFIED`	조직의 위치 정책이 충족되지 않습니다.
`OUTDATED_MINOR_VERSION`	리소스가 오래된 마이너 버전을 실행 중이며 패치가 필요합니다.
`SCHEMA_NOT_OPTIMIZED`	데이터베이스 스키마가 최적화되지 않았습니다.
`MANY_IDLE_CONNECTIONS`	유휴 연결이 많습니다.
`REPLICATION_LAG`	복제 지연이 높습니다.
`OUTDATED_VERSION`	리소스가 오래된 메이저 버전을 실행하고 있습니다.

예: 차트 만들기

차트에서 새 데이터베이스 리소스 수를 시각화하려면 다음 안내를 따르세요. 다른 데이터베이스 센터 측정항목 유형에도 동일한 절차를 따를 수 있습니다.

Google Cloud 콘솔에서 측정항목 탐색기 페이지로 이동합니다.
측정항목 탐색기로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
Google Cloud 콘솔의 툴바에서 Google Cloud 프로젝트를 선택합니다. App Hub 구성의 경우 App Hub 호스트 프로젝트나 앱 지원 폴더의 관리 프로젝트를 선택합니다.
측정항목 요소에서 측정항목 선택 메뉴를 펼치고 필터 표시줄에 New database signals을 입력한 후 하위 메뉴를 사용하여 특정 리소스 유형과 측정항목을 선택합니다.
1. 활성 리소스 메뉴에서 데이터베이스 리소스를 선택합니다.
2. 활성 측정항목 카테고리 메뉴에서 리소스를 선택합니다.
3. 활성 측정항목 메뉴에서 새 데이터베이스 신호를 선택합니다.
4. 적용을 클릭합니다.
이 측정항목의 정규화된 이름은 databasecenter.googleapis.com/resource/new_signal_count입니다.
신호 유형 및 리소스 유형별로 데이터를 필터링합니다.
- 신호 유형으로 필터링하려면 필터 요소에서 필터 추가를 클릭한 다음 issue_type을 선택합니다. 라벨 값의 경우 값을 선택하거나 입력합니다.
- 리소스 유형별로 필터링하려면 필터 요소에서 필터 추가를 클릭한 다음 resource_type을 선택합니다. 라벨 값의 경우 값을 선택하거나 입력합니다.