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

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

指标类型遵循 Prometheus 指标类型的定义。Prometheus Info 指标是一种特殊的 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 信息

后续步骤