AlloyDB Omni 측정항목

문서 버전을 선택합니다.

AlloyDB Omni Kubernetes 연산자는 데이터베이스의 상태와 성능을 모니터링하는 측정항목을 제공합니다. 이러한 측정항목은 Prometheus에서 스크래핑하기에 적합한 형식으로 노출됩니다.

라벨

AlloyDB Omni Kubernetes 연산자는 다음 유형의 라벨을 노출합니다.

리소스 라벨

AlloyDB Omni Kubernetes 연산자는 측정항목이 속한 데이터베이스 컨테이너를 고유하게 식별하는 다음 리소스 라벨을 노출합니다. 이러한 리소스 라벨은 데이터베이스 컨테이너를 소유한 Kubernetes 리소스의 이름과 일치합니다.

라벨 키 라벨 값
dbnamespace dbcluster CR의 네임스페이스입니다.
dbcluster dbcluster CR의 이름입니다.
dbinstance dbinstance CR의 이름입니다. ReadPool 유형의 dbinstance만 지원됩니다. 데이터베이스 컨테이너가 ReadPool dbinstance에 속하지 않는 경우 이 값은 n/a입니다.
dbnode 인스턴스 CR의 이름입니다. 모든 인스턴스 CR은 데이터베이스 컨테이너에 일대일로 매핑됩니다.

시스템 메타데이터 라벨

DB 컨테이너의 roles가 변경되면 시스템 메타데이터 라벨이 동적으로 변경됩니다. 예를 들어 dbcluster가 보조에서 기본으로 승격되면 dbcluster_type이 Secondary에서 Primary로 변경됩니다.

라벨 키 라벨 값
dbcluster_type dbcluster CR의 재해 복구(DR) 역할입니다. Primary 또는 Secondary일 수 있습니다.
dbinstance_type dbinstance CR의 유형입니다. 컨테이너가 ReadPool dbinstance에 속하는 경우 이 값은 ReadPool이고, 그렇지 않으면 이 값은 n/a입니다.
dbnode_type dbnode의 HA 역할입니다. Primary 또는 Standby일 수 있습니다.

측정항목 라벨

다음 표에서는 각 측정항목의 구체적인 라벨을 보여줍니다. 예를 들어 database는 AlloyDB Omni 데이터베이스 컨테이너 내에 호스팅된 Postgres 데이터베이스의 이름을 의미합니다.

측정항목

AlloyDB Omni Kubernetes 연산자는 다음 측정항목을 노출합니다. 측정항목 목록에는 측정항목 라벨만 언급됩니다. 모든 측정항목은 alloydb_omni로 시작합니다. 측정항목 유형에 대해 자세히 알아보려면 측정항목 유형을 참조하세요.

데이터베이스 컨테이너 수준 측정항목

데이터베이스 컨테이너 수준의 측정항목은 AlloyDB Omni 데이터베이스 컨테이너별로 수집됩니다. 각 데이터베이스 컨테이너 수준의 측정항목에는 리소스 및 시스템 메타데이터 라벨이 포함됩니다.

이름 설명 라벨 단위 유형
alloydb_omni_database_postgresql_backends AlloyDB Omni 인스턴스에 대한 활성 및 유휴 상태 연결 수입니다. 게이지
alloydb_omni_database_postgresql_max_connections Postgres max_connections 런타임 파라미터의 현재 값입니다. gauge
alloydb_omni_database_postgresql_up Postgres 기본 프로세스가 실행 중인지 여부입니다. 실행 중이면 1, 중단되었으면 0입니다. gauge
alloydb_omni_database_postgresql_uptime_second Postgres 기본 프로세스가 시작된 후 경과된 시간입니다. 초 gauge
alloydb_omni_database_postgresql_vacuum_oldest_transaction_age 배큠 작업을 차단 중인 가장 오래된 커밋되지 않은 트랜잭션의 현재 기간입니다. 가장 오래된 트랜잭션 이후에 시작된 트랜잭션 수로 측정됩니다. type: [running, prepared, replication_slot, replica] 중 하나입니다. gauge
alloydb_omni_database_postgresql_vacuum_transaction_id_utilization_percentage 사용된 트랜잭션 ID 공간의 비율입니다. 1은 100%를 의미합니다. gauge
alloydb_omni_instance_postgresql_backends_by_state 현재 연결 수입니다. state: 연결 상태로, [idle, active, idle_in_transaction, idle_in_transaction_aborted, disabled, fastpath_function_call] 중 하나입니다. gauge
alloydb_omni_instance_postgresql_backends_for_top_applications 애플리케이션별 현재 연결 수입니다. application_name: 애플리케이션 이름입니다. gauge
alloydb_omni_instance_postgresql_blks_hit_count_total Postgres가 버퍼 캐시에서 요청된 블록을 찾은 총횟수입니다. counter
alloydb_omni_instance_postgresql_blks_read_count_total Postgres 버퍼 캐시에 없으며 Postgres가 읽은 총 블록 수입니다. counter
alloydb_omni_instance_postgresql_committed_transactions_count_total 커밋된 총 트랜잭션 수입니다. counter
alloydb_omni_instance_postgresql_deadlock_count_total 감지된 교착 상태 수입니다. counter
alloydb_omni_instance_postgresql_new_connections_count_total 총 신규 연결 수입니다. counter
alloydb_omni_instance_postgresql_rolledback_transactions_count_total 롤백된 총 트랜잭션 수입니다. counter
alloydb_omni_instance_postgresql_temp_bytes_written_count_total 쿼리가 임시 파일에 작성한 총 데이터 양입니다. 바이트 counter
alloydb_omni_instance_postgresql_temp_files_written_count_total 내부 알고리즘을 실행하는 동안 데이터를 작성하는 데 사용된 임시 파일의 총개수입니다. counter
alloydb_omni_instance_postgresql_tuples_deleted_count_total 삭제된 총 행 수입니다. counter
alloydb_omni_instance_postgresql_tuples_fetched_count_total 가져온 총 행 수입니다. counter
alloydb_omni_instance_postgresql_tuples_inserted_count_total 삽입된 총 행 수입니다. counter
alloydb_omni_instance_postgresql_tuples_returned_count_total 반환된 총 행 수입니다. counter
alloydb_omni_instance_postgresql_tuples_updated_count_total 업데이트된 행의 총 개수입니다. 카운터
alloydb_omni_instance_postgresql_wait_count_total 대기 이벤트의 총 대기 횟수입니다.
  • wait_event_name: 대기 이벤트의 이름입니다.
  • wait_event_type: 대기 이벤트의 유형입니다.
 카운터
alloydb_omni_instance_postgresql_wait_time_second_total 대기 이벤트에서 경과된 총 시간입니다.
  • wait_event_name: 대기 이벤트의 이름입니다.
  • wait_event_type: 대기 이벤트의 유형입니다.
 초 카운터
alloydb_omni_instance_postgresql_replication_flush_lag_ms 최근 WAL을 로컬로 플러시한 후 복제본 서버가 이를 작성하고 플러시했다는(아직 적용하지 않음) 알림을 수신할 때까지 경과한 시간입니다.
  • application_name: 복제본 인스턴스 CR의 이름과 일치하는 기본 인스턴스에 대한 복제본 연결 문자열에 있는 application_name입니다.
  • client_addr: 복제본 포드의 IP 주소입니다.
 ms gauge
alloydb_omni_instance_postgresql_replication_replay_lag_ms 최근 WAL을 로컬로 플러시한 후 복제본 서버가 이를 작성하고 플러시하고 적용했다는 알림을 수신할 때까지 경과한 시간입니다.
  • application_name: 기본 인스턴스에 대한 복제본의 연결 문자열에 있는 application_name입니다. 복제본 인스턴스 CR의 이름과 일치합니다.
  • client_addr: 복제본 포드의 IP 주소입니다.
 ms gauge
alloydb_omni_instance_postgresql_replication_state 기본 인스턴스에 연결된 각 복제본의 상태입니다. 이 값은 항상 1입니다.
  • application_name: 기본 인스턴스에 대한 복제본의 연결 문자열에 있는 application_name입니다. 복제본 인스턴스 CR의 이름과 일치합니다.
  • client_addr: 복제본 포드의 IP 주소입니다.
  • state: [startup, catchup, streaming, backup, stopping] 중 하나입니다.
 gauge
alloydb_omni_instance_postgresql_replication_write_lag_ms 최근 WAL을 로컬로 플러시한 후 복제본 서버가 이를 작성했다는(아직 플러시하거나 적용하지 않음) 알림을 수신할 때까지 경과한 시간입니다.
  • application_name: 기본 인스턴스에 대한 복제본의 연결 문자열에 있는 application_name입니다. 복제본 인스턴스 CR의 이름과 일치합니다.
  • client_addr: 복제본 포드의 IP 주소입니다.
 ms gauge
alloydb_omni_memory_available_byte 할당에 사용할 수 있는 메모리 양의 추정치입니다. 바이트 gauge
alloydb_omni_memory_limit_byte 데이터베이스 클러스터 매니페스트 파일의 spec 부분의 primarySpec 섹션에 지정된 데이터베이스 컨테이너의 메모리 한도입니다. 바이트 gauge
alloydb_omni_memory_used_byte 해제할 수 없는 사용된 데이터베이스 컨테이너 메모리의 추정치입니다. 바이트 gauge
alloydb_omni_node_cpu_mcpu 할당된 mCPU 수입니다. 1,000mCPU = 1CPU입니다. mCPU gauge
alloydb_omni_node_cpu_usage_second_total 사용된 총 CPU 시간(초)입니다. 초 counter
alloydb_omni_node_network_received_bytes_count_total AlloyDB Omni 포드의 네트워크 수신 바이트 수입니다. 바이트 counter
alloydb_omni_node_network_sent_bytes_count_total AlloyDB Omni 포드의 네트워크 전송 바이트 수입니다. 바이트 counter
alloydb_omni_node_storage_limit_per_disk_byte 스토리지 한도(바이트)입니다. disk: 디스크 이름입니다. 바이트 gauge
alloydb_omni_node_storage_read_bytes_count_total 디스크에서 읽은 바이트 수입니다. 바이트 counter
alloydb_omni_node_storage_read_ops_count_total 디스크 읽기 IO 작업 수입니다. counter
alloydb_omni_node_storage_usage_per_disk_byte 디스크별 사용된 스토리지(바이트)입니다. disk: 디스크 이름입니다. 바이트 gauge
alloydb_omni_node_storage_write_bytes_count_total 디스크에 기록된 바이트 수입니다. 바이트 counter
alloydb_omni_node_storage_write_ops_count_total 디스크 쓰기 IO 작업 수입니다. counter

데이터베이스 수준 측정항목

이러한 측정항목은 Postgres 데이터베이스 수준에서 AlloyDB Omni 데이터베이스 컨테이너별로 수집됩니다. 하나의 데이터베이스 컨테이너에 여러 개의 Postgres 데이터베이스를 만들 수 있습니다. 이러한 모든 측정항목에는 리소스, 시스템 메타데이터, '데이터베이스' 라벨이 포함됩니다. 데이터베이스 라벨은 측정항목이 속한 Postgres 데이터베이스의 이름입니다.

이름 설명 라벨 단위 유형
alloydb_omni_database_postgresql_backends_for_top_databases 데이터베이스별 현재 연결 수입니다. gauge
alloydb_omni_database_postgresql_blks_hit_for_top_databases_count_total 데이터베이스당 Postgres가 버퍼 캐시에서 요청된 블록을 찾은 총횟수입니다. counter
alloydb_omni_database_postgresql_blks_read_for_top_databases_count_total 데이터베이스당 Postgres 버퍼 캐시에 없는 Postgres가 읽은 총 블록 수입니다. counter
alloydb_omni_database_postgresql_committed_transactions_for_top_databases_count_total 데이터베이스별로 커밋된 총 트랜잭션 수입니다. counter
alloydb_omni_database_postgresql_deadlock_for_top_databases_count_total 데이터베이스별 교착 상태 수입니다. counter
alloydb_omni_database_postgresql_insights_aggregate_execution_time_us_total 모든 쿼리의 총 실행 시간입니다.
  • user: 쿼리를 실행한 Postgres 사용자입니다.
  • client_addr: 클라이언트의 IP 주소입니다(사용 가능한 경우). 사용 불가능한 경우 비어 있습니다.
 us counter
alloydb_omni_database_postgresql_insights_aggregate_io_time_us_total 모든 쿼리에서 IO를 실행하는 데 소요된 총시간입니다.
  • user: 쿼리를 실행한 Postgres 사용자입니다.
  • io_type: read 또는 write입니다.
 us counter
alloydb_omni_database_postgresql_new_connections_for_top_databases_count_total 데이터베이스별 새 연결 수입니다. counter
alloydb_omni_database_postgresql_rolledback_transactions_for_top_databases_count_total 데이터베이스별 롤백된 총 트랜잭션 수입니다. counter
alloydb_omni_database_postgresql_size_byte 데이터베이스 크기입니다. 바이트 gauge
alloydb_omni_database_postgresql_statements_executed_count_total 데이터베이스별로 수행된 문의 총 개수입니다. operation_type: 작업 이름으로, [SELECT, UPDATE, INSERT, DELETE, MERGE, UTILITY, NOTHING, UNKNOWN] 중 하나입니다. counter
alloydb_omni_database_postgresql_temp_bytes_written_for_top_databases_count_total 데이터베이스별로 쿼리가 임시 파일에 기록한 총 데이터 양입니다. 바이트 counter
alloydb_omni_database_postgresql_temp_files_written_for_top_databases_count_total 데이터베이스당 내부 알고리즘을 실행하는 동안 데이터를 작성하는 데 사용된 임시 파일의 총개수입니다. counter
alloydb_omni_database_postgresql_tuples 데이터베이스의 행 수입니다. state: [live, dead] 중 하나입니다. gauge
alloydb_omni_database_postgresql_tuples_deleted_for_top_databases_count_total 데이터베이스별로 삭제된 총 행 수입니다. counter
alloydb_omni_database_postgresql_tuples_fetched_for_top_databases_count_total 데이터베이스별로 가져온 총 행 수입니다. counter
alloydb_omni_database_postgresql_tuples_inserted_for_top_databases_count_total 데이터베이스별로 삽입된 총 행 수입니다. counter
alloydb_omni_database_postgresql_tuples_returned_for_top_databases_count_total 데이터베이스별로 반환된 총 행 수입니다. counter
alloydb_omni_database_postgresql_tuples_updated_for_top_databases_count_total 데이터베이스별로 업데이트된 총 행 수입니다. counter

측정항목 수집 측정항목

이러한 측정항목은 각 측정항목 수집 주기의 상태를 나타냅니다. 라벨에 언급된 리소스 라벨을 포함합니다.

이름 설명 단위 유형
alloydb_omni_monitor_collect_ms 측정항목을 수집하는 데 걸린 시간(밀리초)입니다. ms gauge
alloydb_omni_monitor_error_count 이번 주기에서 측정항목 수집을 시도하는 동안 발생한 오류 수입니다. gauge
alloydb_omni_monitor_metric_count 이번 주기에 성공적으로 수집된 측정항목 수입니다. gauge

Prometheus 측정항목 핸들러 측정항목

이러한 측정항목은 각 수집 주기 동안 Prometheus에 의해 자동으로 생성됩니다.

이름 설명 원인 유형
promhttp_metric_handler_errors_total promhttp 측정항목 핸들러에서 발생한 총 내부 오류 수입니다. 오류 원인 counter

다음 단계