I tipi di metriche seguono la definizione dei tipi di metriche Prometheus. Una metrica Info di Prometheus è un tipo speciale di metrica Gauge di Prometheus, che ha sempre un valore pari a 1 e più etichette che contengono informazioni importanti sulla risorsa personalizzata dell'operatore AlloyDB Omni Kubernetes corrispondente.
Etichette dei metadati della definizione di risorsa personalizzata (CRD)
Tutte le metriche delle risorse personalizzate hanno le seguenti etichette che contrassegnano il gruppo, la versione e il tipo
della CRD. Per ulteriori informazioni, consulta
Concetti dell'API Kubernetes.
Le definizioni e la denominazione delle etichette sono elencate nella tabella seguente:
Chiave
Descrizione
Valore di esempio
customresource_group
Il gruppo del CRD.
alloydbomni.dbadmin.goog
customresource_version
La versione di CRD.
v1
customresource_kind
Il tipo di CRD.
DBCluster
Metriche DBCluster
Le metriche DBCluster vengono esposte dai manifest delle risorse DBCluster. Tutti i nomi delle metriche DBCluster iniziano con alloydb_omni_dbcluster_. Tutte le metriche DBCluster
hanno le seguenti etichette:
Chiave
Valore
namespace
Lo spazio dei nomi a cui appartiene DBCluster.
dbcluster
Il nome della risorsa personalizzata DBCluster.
Le etichette nella tabella seguente avranno un valore vuoto e sono
considerate equivalenti alle etichette che non esistono per
Nomi e etichette delle metriche Prometheus
se il campo pertinente non è presente nel manifest DBCluster.
Nome metrica
Descrizione
Etichetta
Unità
Tipo
alloydb_omni_dbcluster_ha_ready
La preparazione all'alta disponibilità (HA) di `DBCluster`:
1 se ha-ready, altrimenti
0.
reason: il motivo per cui questo DBCluster è
(non) pronto per l'alta disponibilità.
1
Misuratore
alloydb_omni_dbcluster_primary_ready
La preparazione del nodo primario DBCluster:
1 se pronto, altrimenti 0.
reason: il motivo per cui il nodo principale di questo DBCluster
è (non) pronto.
1
Misuratore
alloydb_omni_dbcluster_status_info
Lo stato attuale di DBCluster.
phase: la fase del DBCluster.
database_version: la versione attualmente in esecuzione dell'immagine
AlloyDB Omni, ad esempio 15.7.0.
controlplane_agents_version: la versione corrente
dell'immagine degli agenti del control plane, ad esempio 1.3.0.
read_write_endpoint: l'endpoint di lettura/scrittura del
DBCluster.
read_only_endpoint: l'endpoint di sola lettura del
DBCluster.
primary_phase: la fase del
DBCluster nodo primario.
haready_status: stato della condizione HAReady, True o False.
haready_reason: il motivo della condizione
HAReady.
1
Informazioni
alloydb_omni_dbcluster_spec_info
Configurazione DBCluster nel campo spec
del manifest DBCluster.
num_standbys: il numero di nodi di standby configurati.
database_version: la versione dell'immagine
AlloyDB Omni configurata, ad esempio 15.7.0.
controlplane_agents_version: la versione dell'immagine degli agenti del control plane configurata, ad esempio 1.3.0.
is_deleted: indica se questo
DBCluster è contrassegnato per l'eliminazione, impostato su true o
false.
allow_external_incoming_traffic: indica se
questo DBCluster è configurato per consentire il traffico proveniente dall'esterno del
cluster Kubernetes, true o false.
1
Informazioni
alloydb_omni_dbcluster_spec_num_standbys
Il numero di stand-by definiti nella specifica DBCluster.
N/D
1
Misuratore
alloydb_omni_dbcluster_critical_incident_info
Voci di incidenti critici nella sezione status.criticalIncidents del manifest DBCluster.
create_time: l'ora in cui si è verificato l'incidente critico.
message: il messaggio di errore dell'incidente critico.
L'ora in cui si è verificato l'incidente critico, espressa nel formato ora epoca di Unix.
message: il messaggio di errore dell'incidente critico.
code: il codice di errore dell'incidente critico.
sec
Misuratore
Metriche di failover
Le metriche di failover sono metriche esposte dal manifest della risorsa Failover. Tutti i nomi delle metriche di failover iniziano con alloydb_omni_failover_. Tutte le metriche di failover
hanno le seguenti etichette:
Chiave
Valore
namespace
Lo spazio dei nomi a cui appartiene Failover.
failover
Il nome della risorsa personalizzata Failover.
dbcluster
Il nome della risorsa personalizzata DBCluster a cui è destinato il failover.
Questo valore è uguale al campo spec.dbclusterRef di
Failover.
Le etichette nella tabella seguente avranno un valore vuoto e sono
considerate equivalenti alle etichette che non esistono in base a
Nomi ed etichette delle metriche Prometheus
se il campo pertinente non è presente nel manifest di failover.
Nome metrica
Descrizione
Etichetta
Unità
Tipo
alloydb_omni_failover_start_time
L'ora di inizio di questo Failover, espressa nel formato
ora epoca di Unix.
state: lo stato di Failover.
phase: la fase del Failover.
sec
Misuratore
alloydb_omni_failover_end_time
L'ora in cui è terminato Failover, espressa nel formato ora epoca di Unix
state: lo stato di Failover
phase: la fase di Failover
sec
Misuratore
alloydb_omni_failover_status_info
Lo stato attuale di Failover.
start_time: l'ora di inizio di Failover.
end_time: l'ora in cui è terminato
Failover.
new_primary: il nome del nodo primario dopo il completamento di Failover.
old_primary: il nome del nodo primario prima dell'avvio di
Failover
phase: la fase del Failover.
state: lo stato di Failover.
1
Informazioni
Metriche PgBouncer
Le metriche PgBouncer sono metriche esposte dai manifest delle risorsePgBouncer. Tutti i nomi delle metriche PgBouncer iniziano con alloydb_omni_pgbouncer_. Tutte
le metriche di PgBouncer hanno le seguenti etichette:
Chiave
Valore
namespace
Lo spazio dei nomi a cui appartiene PgBouncer.
pgbouncer
Il nome della risorsa personalizzata PgBouncer.
dbcluster
Il nome della risorsa personalizzata DBCluster a cui fa riferimento
PgBouncer. Questo valore è uguale al campo
spec.dbclusterRef di
PgBouncer.
Le etichette nella tabella seguente avranno un valore vuoto e sono
considerate equivalenti alle etichette che non esistono in base a
Nomi e etichette delle metriche Prometheus
se il campo pertinente non è presente nel manifest di PgBouncer.
Nome metrica
Descrizione
Etichetta
Unità
Tipo
alloydb_omni_pgbouncer_status_info
Lo stato attuale di PgBouncer.
endpoint: l'endpoint esposto da questo PgBouncer. Ti connetti a questo endpoint per eseguire query sul DBCluster a cui fa riferimento PgBouncer.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)."]]
