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

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

측정항목 유형은 Prometheus 측정항목 유형의 정의를 따릅니다. Prometheus 정보 측정항목은 항상 값이 1이고 상응하는 AlloyDB Omni Kubernetes 연산자 맞춤 리소스에 관한 중요한 정보를 포함하는 여러 라벨이 있는 특별한 종류의 Prometheus 차트 측정항목입니다.

커스텀 리소스 측정항목을 사용 설정하는 방법을 알아보려면 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_로 시작합니다. 모든 Failover(장애 조치) 측정항목에는 다음 라벨이 있습니다.

namespace

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

failover

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

dbcluster

Failover가 타겟팅하는 DBCluster 커스텀 리소스의 이름입니다. 이 값은 Failoverspec.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 커스텀 리소스의 이름입니다. 이 값은 PgBouncerspec.dbclusterRef 필드와 동일합니다.

다음 표의 라벨은 빈 값을 갖습니다. 관련 필드가 PgBouncer 매니페스트에 없는 경우 Prometheus 측정항목 이름 및 라벨에 따라 존재하지 않는 라벨과 동일한 것으로 간주됩니다.

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

alloydb_omni_pgbouncer_status_info

PgBouncer의 현재 상태입니다.
  • endpoint: 이 PgBouncer에서 노출하는 엔드포인트입니다. 이 엔드포인트에 연결하여 이 PgBouncer가 타겟팅하는 DBCluster에 대해 쿼리를 실행합니다.
  • phase: PgBouncer의 단계입니다.
1 정보

다음 단계