AlloyDB Omni Kubernetes 運算子的自訂資源指標

選取說明文件版本：

本頁說明 AlloyDB Omni Kubernetes 運算子的自訂資源 (CR) 指標。AlloyDB Omni Kubernetes 運算子會使用 kube-state-metrics，以 Prometheus 格式公開從自訂資源資訊清單建構的指標。

指標類型遵循 Prometheus 指標類型的定義。Prometheus 資訊指標是特殊的 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

備份指標

備份指標會從 Backup 資源資訊清單公開。所有備份指標名稱開頭都是 alloydb_omni_backup_。所有備份指標都包含下列標籤：

金鑰 值

backup

[metadata, name]

backupplan

[metadata, name]

namespace

[metadata, namespace]

dbcluster

[spec, dbclusterRef]

如果備份資訊清單中沒有相關欄位，下表中的標籤值會為空白，且會視為與Prometheus 指標名稱和標籤中不存在的標籤相同。

指標名稱 說明 標籤 單位 類型

alloydb_omni_backup_phase

備份作業的目前狀態 (成功、進行中或失敗)

不適用

1

StateSet

alloydb_omni_backup_start_time

備份開始時間的 Unix 時間戳記

不適用

秒

度量圖

alloydb_omni_backup_end_time

備份結束時間的 Unix 時間戳記

不適用

秒

度量圖

alloydb_omni_backup_duration_seconds

備份作業的持續時間 (以秒為單位)

不適用

秒

度量圖

alloydb_omni_backup_backup_size

備份完成後的大小 (以位元組為單位)

不適用

位元組

度量圖

alloydb_omni_backup_spec_info

備份規格
  • backup_source_role：[spec, backupSourceRole]
  • manual：[spec, manual]
  • backup_type：[spec, physicalBackupSpec, backupType]

1

資訊

alloydb_omni_backup_status_info

備份狀態
  • phase：[status, phase]
  • backup_id：[status, physicalBackupStatus, backupID]
  • prior_backup：[status, physicalBackupStatus, priorBackup]
  • backup_type：[status, physicalBackupStatus, backupType]
  • lsn_start：[status, physicalBackupStatus, lsn, start]
  • lsn_stop：[status, physicalBackupStatus, lsn, stop]
  • wal_start：[status, physicalBackupStatus, wal, start]
  • wal_stop：[status, physicalBackupStatus, wal, stop]
  • retain_expire_time：[status, retainExpire_time]

1

資訊

alloydb_omni_backup_critical_incident_info

備份重大事件
  • create_time：[status, criticalIncidents, createTime]
  • message：[status, criticalIncidents, message]
  • code：[status, criticalIncidents, code]

1

資訊

alloydb_omni_backup_critical_incident_createtime

備份重大事件 createTime
  • message：[status, criticalIncidents, message]
  • code：[status, criticalIncidents, code]

秒

度量圖

BackupPlan 指標

BackupPlan 指標會從 BackupPlan 資源資訊清單公開。所有 BackupPlan 指標名稱開頭都是 alloydb_omni_backupplan_。所有 BackupPlan 指標都具有下列標籤：

金鑰 值

backupplan

[metadata, name]

namespace

[metadata, namespace]

dbcluster

[spec, dbclusterRef]

如果 BackupPlan 資訊清單中沒有相關欄位，下表中的標籤值就會是空白，且會被視為與Prometheus 指標名稱和標籤中不存在的標籤相同。

指標名稱 說明 標籤 單位 類型

alloydb_omni_backupplan_phase

備份方案的目前狀態

不適用

1

StateSet

alloydb_omni_backupplan_last_backup_time

方案上次排定備份的 Unix 時間戳記

不適用

秒

度量圖

alloydb_omni_backupplan_next_backup_time

方案下次排定備份的 UNIX 時間戳記

不適用

秒

度量圖

alloydb_omni_backupplan_recovery_window_begin

復原作業的開始時間 (以 Unix 時間戳記表示)

不適用

秒

度量圖

alloydb_omni_backupplan_recovery_window_end

復原作業結束時間的 Unix 時間戳記

不適用

秒

度量圖

alloydb_omni_backupplan_spec_info

backupplan 的規格
  • full_schedule：[spec, backupSchedules, full]
  • differential_schedule：[spec, backupSchedules, differential]
  • incremental_schedule：[spec, backupSchedules, incremental]
  • backup_retain_days：[spec, backupRetainDays]
  • backup_source_strategy：[spec, backupSourceStrategy]
  • paused：[spec, paused]

1

資訊

alloydb_omni_backupplan_status_info

備份方案狀態
  • phase：[status, phase]
  • last_backup_time：[status, lastBackupTime]
  • next_backup_time：[status, nextBackupTime]
  • recovery_window_begin：[status, recoveryWindow, begin]
  • recovery_window_end：[status, recoveryWindow, end]

1

資訊

alloydb_omni_backupplan_critical_incident_info

Backupplan 重大事件
  • create_time：[status, criticalIncidents, createTime]
  • message：[status, criticalIncidents, message]
  • code：[status, criticalIncidents, code]

1

資訊

alloydb_omni_backupplan_critical_incident_createtime

Backupplan critical incident createTime
  • message：[status, criticalIncidents, message]
  • code：[status, criticalIncidents, code]

秒

度量圖

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 (不) 適合高可用性的原因。 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 時間格式表示。
  • message：重大事件的錯誤訊息。
  • code：重大事件的錯誤代碼。
 秒 度量圖

容錯移轉指標

容錯移轉指標是從 Failover 資源資訊清單公開的指標。所有容錯移轉指標名稱開頭都是 alloydb_omni_failover_。所有容錯移轉指標都具有下列標籤：

金鑰 值

namespace

Failover 所屬的命名空間。

failover

Failover 自訂資源的名稱。

dbcluster

容錯移轉目標的 DBCluster 自訂資源名稱。 這個值與 Failover 的 spec.dbclusterRef 欄位相同。

如果容錯移轉資訊清單中沒有相關欄位，下表中的標籤值就會為空，且會根據 Prometheus 指標名稱和標籤，視為不存在的標籤。

指標名稱 說明 標籤 單位 類型

alloydb_omni_failover_start_time

這個 Failover 的開始時間，格式為 Unix 訓練週期時間。
  • 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 資訊

後續步驟