AlloyDB Omni Kubernetes 연산자의 맞춤 리소스 측정항목

문서 버전을 선택합니다. 16.3.0

• 현재 (16.8.0)
• 16.8.0
• 16.3.0
• 15.12.0
• 15.7.1
• 15.7.0

이 페이지에서는 AlloyDB Omni Kubernetes 연산자의 맞춤 리소스 (CR) 측정항목을 설명합니다. AlloyDB Omni Kubernetes 연산자는 kube-state-metrics를 사용하여 커스텀 리소스 매니페스트에서 구성된 측정항목을 Prometheus 형식으로 노출합니다.

참고: 이 측정항목은 AlloyDB Omni Kubernetes 연산자 버전 1.3.0 이상에서만 사용할 수 있습니다.

측정항목 유형은 Prometheus 측정항목 유형의 정의를 따릅니다. Prometheus Info 측정항목은 항상 값이 1이고 해당 AlloyDB Omni Kubernetes 연산자 커스텀 리소스에 관한 중요한 정보를 전달하는 여러 라벨이 있는 특수한 종류의 Prometheus Gauge 측정항목입니다.

커스텀 리소스 측정항목을 사용 설정하는 방법을 알아보려면 AlloyDB Omni Kubernetes 연산자 커스텀 리소스 모니터링을 참고하세요.

커스텀 리소스 정의 (CRD) 메타데이터 라벨

모든 커스텀 리소스 측정항목에는 CRD의 그룹, 버전, 종류를 표시하는 다음 라벨이 있습니다. 자세한 내용은 Kubernetes API 개념을 참고하세요. 라벨 정의 및 이름 지정은 다음 표에 나와 있습니다.

키	설명	예시 값
customresource_group	CRD의 그룹입니다.	alloydbomni.dbadmin.goog
customresource_version	CRD의 버전입니다.	v1
customresource_kind	CRD의 종류입니다.	DBCluster

DBCluster 측정항목

DBCluster 측정항목은 DBCluster 리소스 매니페스트에서 노출됩니다. 모든 DBCluster 측정항목 이름은 alloydb_omni_dbcluster_으로 시작합니다. 모든 DBCluster 측정항목에는 다음 라벨이 있습니다.

키	값
namespace	DBCluster가 속한 네임스페이스입니다.
dbcluster	DBCluster 커스텀 리소스의 이름입니다.

다음 표의 라벨은 값이 비어 있으며, 관련 필드가 DBCluster 매니페스트에 없으면 Prometheus 측정항목 이름 및 라벨에 따라 존재하지 않는 라벨과 동일한 것으로 간주됩니다.

측정항목 이름	설명	라벨	단위	유형
alloydb_omni_dbcluster_ha_ready	`DBCluster`의 고가용성(HA) 준비 상태입니다. 1(ha-ready인 경우) 또는 0.	reason: 이 DBCluster이 HA에 대해 (미)준비된 이유입니다.	1	게이지
alloydb_omni_dbcluster_primary_ready	DBCluster 기본 노드의 준비 상태: 준비된 경우 1, 그렇지 않은 경우 0.	reason: 이 DBCluster의 기본 노드가 준비되지 않은 이유입니다.	1	게이지
alloydb_omni_dbcluster_status_info	DBCluster.의 현재 상태	phase: DBCluster의 단계입니다. database_version: 현재 실행 중인 AlloyDB Omni 이미지 버전입니다(예: 15.7.0). controlplane_agents_version: 현재 실행 중인 컨트롤 플레인 에이전트 이미지 버전입니다(예: 1.3.0). read_write_endpoint: DBCluster.의 읽기-쓰기 엔드포인트 read_only_endpoint: DBCluster의 읽기 전용 엔드포인트입니다. primary_phase: DBCluster 기본 노드의 단계입니다. haready_status: HAReady 조건 상태, True 또는 False. haready_reason: HAReady 조건의 이유입니다.	1	정보
alloydb_omni_dbcluster_spec_info	DBCluster 매니페스트의 spec 필드 아래에 있는 DBCluster 구성	num_standbys:구성된 대기 노드 수입니다. database_version: 구성된 AlloyDB Omni 이미지의 버전입니다(예: 15.7.0). controlplane_agents_version: 구성된 컨트롤 플레인 에이전트 이미지의 버전입니다(예: 1.3.0). is_deleted: 이 DBCluster이 삭제 표시되어 있는지, true 또는 false.로 설정되어 있는지를 나타냅니다. allow_external_incoming_traffic: 이 DBCluster이 Kubernetes 클러스터 외부(true 또는 false)에서 들어오는 트래픽을 허용하도록 구성되었는지 여부를 나타냅니다.	1	정보
alloydb_omni_dbcluster_spec_num_standbys	DBCluster 사양에 정의된 대기 수입니다.	해당 사항 없음	1	게이지
alloydb_omni_dbcluster_critical_incident_info	DBCluster 매니페스트의 status.criticalIncidents 섹션에 있는 심각한 인시던트 항목	create_time: 심각한 사고가 발생한 시간입니다. message: 심각한 인시던트의 오류 메시지입니다. code: 심각한 인시던트의 오류 코드입니다.	1	정보
alloydb_omni_dbcluster_critical_incident_create_time	심각한 인시던트가 발생한 시간으로, Unix epoch time 형식으로 표시됩니다.	message: 심각한 인시던트의 오류 메시지입니다. code: 심각한 인시던트의 오류 코드입니다.	초	게이지

장애 조치 측정항목

장애 조치 측정항목은 Failover 리소스 매니페스트에서 노출되는 측정항목입니다. 모든 장애 조치 측정항목 이름은 alloydb_omni_failover_으로 시작합니다. 모든 장애 조치 측정항목에는 다음 라벨이 있습니다.

키	값
namespace	Failover가 속한 네임스페이스입니다.
failover	Failover 커스텀 리소스의 이름입니다.
dbcluster	장애 조치 대상인 DBCluster 커스텀 리소스의 이름입니다. 이 값은 Failover의 spec.dbclusterRef 필드와 동일합니다.

다음 표의 라벨은 값이 비어 있으며, 장애 조치 매니페스트에 관련 필드가 없으면 Prometheus 측정항목 이름 및 라벨에 따라 존재하지 않는 라벨과 동일한 것으로 간주됩니다.

측정항목 이름	설명	라벨	단위	유형
alloydb_omni_failover_start_time	이 Failover가 시작된 시간입니다. Unix epoch time 형식으로 표현됩니다.	state: Failover의 상태입니다. phase: Failover의 단계입니다.	초	게이지
alloydb_omni_failover_end_time	Failover가 종료된 시간입니다. Unix 에포크 시간 형식으로 표현됩니다.	state: Failover의 상태 phase: Failover의 단계	초	게이지
alloydb_omni_failover_status_info	Failover의 현재 상태입니다.	start_time: Failover가 시작된 시간입니다. end_time: Failover가 완료된 시간입니다. new_primary: Failover가 완료된 후 기본 노드의 이름입니다. old_primary: Failover이 시작되기 전 기본 노드의 이름 phase: Failover의 단계입니다. state: Failover의 상태입니다.	1	정보

PgBouncer 측정항목

PgBouncer 측정항목은 PgBouncer 리소스 매니페스트에서 노출되는 측정항목입니다. 모든 PgBouncer 측정항목 이름은 alloydb_omni_pgbouncer_으로 시작합니다. 모든 PgBouncer 측정항목에는 다음 라벨이 있습니다.

키	값
namespace	PgBouncer가 속한 네임스페이스입니다.
pgbouncer	PgBouncer 커스텀 리소스의 이름입니다.
dbcluster	이 PgBouncer가 타겟팅하는 DBCluster 커스텀 리소스의 이름입니다. 이 값은 PgBouncer의 spec.dbclusterRef 필드와 동일합니다.

다음 표의 라벨은 값이 비어 있으며, 관련 필드가 PgBouncer 매니페스트에 없으면 Prometheus 측정항목 이름 및 라벨에 따라 존재하지 않는 라벨과 동일한 것으로 간주됩니다.

측정항목 이름	설명	라벨	단위	유형
alloydb_omni_pgbouncer_status_info	PgBouncer의 현재 상태입니다.	endpoint: 이 PgBouncer에 의해 노출된 엔드포인트입니다. 이 엔드포인트에 연결하여 이 PgBouncer가 타겟팅하는 DBCluster에 대해 쿼리를 실행합니다. phase: PgBouncer의 단계	1	정보

다음 단계

• AlloyDB Omni Kubernetes 연산자 커스텀 리소스 모니터링