AlloyDB Omni Kubernetes 연산자의 커스텀 리소스 측정항목

문서 버전을 선택합니다.

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

측정항목 유형은 Prometheus 측정항목 유형의 정의를 따릅니다. Prometheus Info 측정항목은 특별한 종류의 Prometheus Gauge 측정항목으로, 항상 값이 1이며 해당 AlloyDB Omni Kubernetes 연산자 커스텀 리소스와 관련된 중요한 정보를 전달하는 여러 라벨을 포함합니다.

커스텀 리소스 측정항목을 사용 설정하는 방법을 알아보려면 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) 준비 상태: ha-ready인 경우 1, 그렇지 않은 경우 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

심각한 사고가 발생한 시간으로, 유닉스 시간 형식으로 표시됩니다.
  • message: 심각한 사고의 오류 메시지입니다.
  • code: 심각한 사고의 오류 코드입니다.
 초 게이지

장애 조치 측정항목

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

키 값

namespace

Failover가 속한 네임스페이스입니다.

failover

Failover 커스텀 리소스의 이름입니다.

dbcluster

장애 조치 대상인 DBCluster 커스텀 리소스의 이름입니다. 이 값은 Failover의 spec.dbclusterRef 필드와 동일합니다.

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

측정항목 이름 설명 라벨 단위 유형

alloydb_omni_failover_start_time

이 Failover가 시작된 시간입니다. 유닉스 시간 형식으로 표현됩니다.
  • state: Failover의 상태입니다.
  • phase: Failover의 단계입니다.
 초 게이지

alloydb_omni_failover_end_time

Failover가 종료된 시간입니다. 유닉스 시간 형식으로 표현됩니다.
  • 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 정보

다음 단계