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

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

指標類型遵循 Prometheus 指標類型的定義。Prometheus 資訊指標是一種特殊的 Prometheus 計量指標，值一律為 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) 準備狀態： 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 資訊

後續步驟