Los tipos de métricas siguen la definición de los tipos de métricas de Prometheus. Una métrica de información de Prometheus es un tipo especial de métrica de medidor de Prometheus, que siempre tiene un valor de 1 y tiene varias etiquetas que contienen información importante sobre el recurso personalizado del operador de Kubernetes de AlloyDB Omni correspondiente.
Etiquetas de metadatos de la definición de recurso personalizado (CRD)
Todas las métricas de recursos personalizados tienen las siguientes etiquetas que marcan el grupo, la versión y el tipo del CRD. Para obtener más información, consulta Conceptos de la API de Kubernetes.
Las definiciones y los nombres de las etiquetas se indican en la siguiente tabla:
Clave
Descripción
Valor de ejemplo
customresource_group
Es el grupo del CRD.
alloydbomni.dbadmin.goog
customresource_version
Es la versión del CRD.
v1
customresource_kind
Es el tipo de CRD.
DBCluster
Métricas de DBCluster
Las métricas de DBCluster se exponen desde los manifiestos de recursos DBCluster. Todos los nombres de métricas de DBCluster comienzan con alloydb_omni_dbcluster_. Todas las métricas de DBCluster tienen las siguientes etiquetas:
Clave
Valor
namespace
Es el espacio de nombres al que pertenece el DBCluster.
dbcluster
Es el nombre del recurso personalizado de DBCluster.
Las etiquetas de la siguiente tabla tendrán un valor vacío y se considerarán equivalentes a las etiquetas que no existen según los nombres y las etiquetas de las métricas de Prometheus si el campo pertinente no está presente en el manifiesto de DBCluster.
Nombre de la métrica
Descripción
Etiqueta
Unidad
Tipo
alloydb_omni_dbcluster_ha_ready
Disponibilidad de alta disponibilidad (HA) del objeto `DBCluster`:1 si ha-ready, de lo contrario, 0.
reason: Es el motivo por el que este DBCluster está (no) listo para la HA.
1
Indicador
alloydb_omni_dbcluster_primary_ready
Disponibilidad del nodo principal DBCluster:
1 si está disponible; de lo contrario, 0.
reason: Es el motivo por el que el nodo principal de este DBCluster está (no) listo.
1
Indicador
alloydb_omni_dbcluster_status_info
Estado actual del DBCluster.
phase: Es la fase de DBCluster.
database_version: Es la versión actual en ejecución de la imagen de AlloyDB Omni, por ejemplo, 15.7.0.
controlplane_agents_version: Es la versión actual en ejecución de la imagen de los agentes del plano de control, por ejemplo, 1.3.0.
read_write_endpoint: Es el extremo de lectura y escritura del DBCluster..
read_only_endpoint: Es el extremo de solo lectura del clúster de base de datos.
primary_phase: Es la fase del nodo principal DBCluster.
haready_status: Estado de la condición HAReady, True o False.
haready_reason: Es el motivo de la condición HAReady.
1
Información
alloydb_omni_dbcluster_spec_info
Configuración de DBCluster en el campo spec del manifiesto de DBCluster
num_standbys:Es la cantidad de nodos en espera configurados.
database_version: Es la versión de la imagen de AlloyDB Omni configurada, por ejemplo, 15.7.0.
controlplane_agents_version: Es la versión de la imagen de los agentes del plano de control configurada, por ejemplo, 1.3.0.
is_deleted: Indica si este DBCluster está marcado para su eliminación. Se establece en true o false..
allow_external_incoming_traffic: Indica si este DBCluster está configurado para permitir el tráfico desde fuera del clúster de Kubernetes, true o false.
1
Información
alloydb_omni_dbcluster_spec_num_standbys
Es la cantidad de copias de seguridad definidas en la especificación DBCluster.
N/A
1
Indicador
alloydb_omni_dbcluster_critical_incident_info
Entradas de incidentes críticos en la sección status.criticalIncidents del manifiesto de DBCluster
create_time: Es la fecha y hora en que ocurrió el incidente crítico.
message: Es el mensaje de error del incidente crítico.
code: Es el código de error del incidente crítico.
Es la fecha y hora en que ocurrió el incidente crítico, expresada en formato de hora de época de Unix.
message: Es el mensaje de error del incidente crítico.
code: Es el código de error del incidente crítico.
s
Indicador
Métricas de conmutación por error
Las métricas de conmutación por error son métricas expuestas desde el manifiesto del recurso Failover. Todos los nombres de las métricas de conmutación por error comienzan con alloydb_omni_failover_. Todas las métricas de conmutación por error tienen las siguientes etiquetas:
Clave
Valor
namespace
Es el espacio de nombres al que pertenece el Failover.
failover
Nombre del recurso personalizado Failover.
dbcluster
Nombre del recurso personalizado de DBCluster al que apunta la conmutación por error.
Este valor es el mismo que el campo spec.dbclusterRef del Failover.
Las etiquetas de la siguiente tabla tendrán un valor vacío (y se consideran equivalentes a las etiquetas que no existen según los nombres y las etiquetas de las métricas de Prometheus) si el campo pertinente no está presente en el manifiesto de conmutación por error.
Nombre de la métrica
Descripción
Etiqueta
Unidad
Tipo
alloydb_omni_failover_start_time
Es la fecha y hora en que comenzó este Failover, expresada en formato de hora de la época de Unix.
state: Es el estado de Failover.
phase: Es la fase de Failover.
s
Indicador
alloydb_omni_failover_end_time
Fecha y hora en que finalizó el Failover, expresada en formato de hora de época de Unix
state: Es el estado de Failover.
phase: Es la fase de Failover.
s
Indicador
alloydb_omni_failover_status_info
Es el estado actual del Failover.
start_time: Es la fecha y hora en que se inició el Failover.
end_time: Es la fecha y hora en que finalizó la Failover.
new_primary: Es el nombre del nodo principal después de que finaliza Failover.
old_primary: Es el nombre del nodo principal antes de que se iniciara Failover.
phase: Es la fase de Failover.
state: Es el estado de Failover.
1
Información
Métricas de PgBouncer
Las métricas de PgBouncer son métricas que se exponen desde los manifiestos de recursos dePgBouncer. Todos los nombres de las métricas de PgBouncer comienzan con alloydb_omni_pgbouncer_. Todas las métricas de PgBouncer tienen las siguientes etiquetas:
Clave
Valor
namespace
Es el espacio de nombres al que pertenece el PgBouncer.
pgbouncer
Nombre del recurso personalizado PgBouncer.
dbcluster
Es el nombre del recurso personalizado de DBCluster al que se dirige este PgBouncer. Este valor es el mismo que el campo spec.dbclusterRef de PgBouncer.
Las etiquetas de la siguiente tabla tendrán un valor vacío (y se consideran equivalentes a las etiquetas que no existen según Nombres y etiquetas de métricas de Prometheus) si el campo pertinente no está presente en el manifiesto de PgBouncer.
Nombre de la métrica
Descripción
Etiqueta
Unidad
Tipo
alloydb_omni_pgbouncer_status_info
Es el estado actual de PgBouncer.
endpoint: Es el extremo que expone este PgBouncer. Te conectas a este extremo para ejecutar consultas en el DBCluster al que se dirige este PgBouncer.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-03 (UTC)"],[[["\u003cp\u003eThis document details the custom resource (CR) metrics for the AlloyDB Omni Kubernetes operator, which are available in version 1.3.0 and later, and are exposed in Prometheus format via kube-state-metrics.\u003c/p\u003e\n"],["\u003cp\u003eAll custom resource metrics include labels for \u003ccode\u003ecustomresource_group\u003c/code\u003e, \u003ccode\u003ecustomresource_version\u003c/code\u003e, and \u003ccode\u003ecustomresource_kind\u003c/code\u003e, providing information about the CRD.\u003c/p\u003e\n"],["\u003cp\u003eDBCluster metrics, prefixed with \u003ccode\u003ealloydb_omni_dbcluster_\u003c/code\u003e, include labels for \u003ccode\u003enamespace\u003c/code\u003e and \u003ccode\u003edbcluster\u003c/code\u003e, with additional details like HA readiness, primary node status, and configuration information.\u003c/p\u003e\n"],["\u003cp\u003eFailover metrics, prefixed with \u003ccode\u003ealloydb_omni_failover_\u003c/code\u003e, are available in \u003ccode\u003eFailover\u003c/code\u003e resource manifests, providing details like start and end times, and status of the failover process, with labels for \u003ccode\u003enamespace\u003c/code\u003e, \u003ccode\u003efailover\u003c/code\u003e, and \u003ccode\u003edbcluster\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003ePgBouncer metrics, prefixed with \u003ccode\u003ealloydb_omni_pgbouncer_\u003c/code\u003e, are available in \u003ccode\u003ePgBouncer\u003c/code\u003e resource manifests, providing details such as the current status of the PgBouncer, and contain the labels \u003ccode\u003enamespace\u003c/code\u003e, \u003ccode\u003epgbouncer\u003c/code\u003e, and \u003ccode\u003edbcluster\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Custom resource metrics for the AlloyDB Omni Kubernetes operator\n\nSelect a documentation version: 15.7.0keyboard_arrow_down\n\n- [Current (16.8.0)](/alloydb/omni/current/docs/reference/custom-resource-metrics-kubernetes-operator)\n- [16.8.0](/alloydb/omni/16.8.0/docs/reference/custom-resource-metrics-kubernetes-operator)\n- [16.3.0](/alloydb/omni/16.3.0/docs/reference/custom-resource-metrics-kubernetes-operator)\n- [15.12.0](/alloydb/omni/15.12.0/docs/reference/custom-resource-metrics-kubernetes-operator)\n- [15.7.1](/alloydb/omni/15.7.1/docs/reference/custom-resource-metrics-kubernetes-operator)\n- [15.7.0](/alloydb/omni/15.7.0/docs/reference/custom-resource-metrics-kubernetes-operator)\n\n\u003cbr /\u003e\n\nThis page describes the custom resource (CR) metrics for the AlloyDB Omni Kubernetes operator. The AlloyDB Omni Kubernetes operator exposes metrics constructed from custom resource manifests in a [Prometheus](https://prometheus.io/) format using [kube-state-metrics](https://kubernetes.io/docs/concepts/cluster-administration/kube-state-metrics/).\n\n\u003cbr /\u003e\n\n| **Note:** These metrics are only available on AlloyDB Omni Kubernetes operator version 1.3.0 and later.\n\nMetric types follow the definition of Prometheus metrics types. A Prometheus\nInfo metric is a special kind of Prometheus Gauge metric, which always has a\nvalue of 1 and has multiple labels carrying important information about the\ncorresponding AlloyDB Omni Kubernetes operator Custom Resource.\n\nTo learn how to enable custom resource metrics, see [Monitor AlloyDB Omni Kubernetes operator custom resources](/alloydb/omni/15.7.0/docs/monitor-kubernetes-operator-custom-resources).\n\nCustom Resource Definition (CRD) metadata labels\n------------------------------------------------\n\nAll custom resource metrics have the following labels that mark the group, version, and kind\nof the CRD. For more information, see\n[Kubernetes API concepts](https://kubernetes.io/docs/reference/using-api/api-concepts/).\nLabel definitions and naming are listed in the following table:\n\nDBCluster metrics\n-----------------\n\nDBCluster metrics are exposed from `DBCluster` resource manifests. All\nDBCluster metric names start with `alloydb_omni_dbcluster_`. All DBCluster\nmetrics have the following labels:\n\nThe labels in the following table will have an empty value ---and are\nconsidered equivalent to labels that don't exist per\n[Prometheus metric names and labels](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels)---\nif the relevant field isn't present in the DBCluster manifest.\n\nFailover metrics\n----------------\n\nFailover metrics are metrics exposed from the `Failover` resource manifest. All\nfailover metric names start with `alloydb_omni_failover_`. All Failover metrics\nhave the following labels:\n\nThe labels in the following table will have an empty value ---and are\nconsidered equivalent to labels that don't exist based on\n[Prometheus metric names and labels](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels)---\nif the relevant field isn't present in the Failover manifest.\n\nPgBouncer metrics\n-----------------\n\nPgBouncer metrics are metrics that are exposed from`PgBouncer` resource\nmanifests. All PgBouncer metric names start with `alloydb_omni_pgbouncer_`. All\nPgBouncer metrics have the following labels:\n\nThe labels in the following table will have an empty value ---and are\nconsidered equivalent to labels that don't exist based on\n[Prometheus metric names and labels](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels)---\nif the relevant field isn't present in the PgBouncer manifest..\n\nWhat's next\n-----------\n\n- [Monitor AlloyDB Omni Kubernetes operator custom resources](/alloydb/omni/15.7.0/docs/monitor-kubernetes-operator-custom-resources)."]]
