AlloyDB Omni Kubernetes operator 的自定义资源指标

本页面介绍了 AlloyDB Omni Kubernetes operator 的自定义资源 (CR) 指标。AlloyDB Omni Kubernetes operator 使用 kube-state-metrics 以 Prometheus 格式公开从自定义资源清单构建的指标。

指标类型遵循 Prometheus 指标类型的定义。Prometheus 信息指标是一种特殊种类的 Prometheus 衡量指标，其值始终为 1，且具有多个标签，其中包含有关相应 AlloyDB Omni Kubernetes operator 自定义资源的重要信息。

如需了解如何启用自定义资源指标，请参阅监控 AlloyDB Omni Kubernetes operator 自定义资源。

自定义资源定义 (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（未）准备好高可用性的原因。 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 纪元时间格式表示）。
  • 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 信息

后续步骤