Les types de métriques suivent la définition des types de métriques Prometheus. Une métrique Info Prometheus est un type spécial de métrique Gauge Prometheus, qui a toujours une valeur de 1 et comporte plusieurs libellés contenant des informations importantes sur la ressource personnalisée de l'opérateur Kubernetes AlloyDB Omni correspondant.
Libellés de métadonnées de définition de ressource personnalisée (CRD)
Toutes les métriques de ressources personnalisées comportent les libellés suivants, qui indiquent le groupe, la version et le type de CRD. Pour en savoir plus, consultez Concepts de l'API Kubernetes.
Les définitions et les noms des libellés sont listés dans le tableau suivant :
Clé
Description
Exemple de valeur
customresource_group
Groupe du CRD.
alloydbomni.dbadmin.goog
customresource_version
Version du CRD.
v1
customresource_kind
Type de CRD.
DBCluster
Métriques DBCluster
Les métriques DBCluster sont exposées à partir des manifestes de ressources DBCluster. Tous les noms de métriques DBCluster commencent par alloydb_omni_dbcluster_. Toutes les métriques DBCluster comportent les libellés suivants :
Clé
Valeur
namespace
Espace de noms auquel appartient le DBCluster.
dbcluster
Nom de la ressource personnalisée DBCluster.
Les libellés du tableau suivant auront une valeur vide et seront considérés comme équivalents aux libellés qui n'existent pas selon Noms et libellés des métriques Prometheus si le champ correspondant n'est pas présent dans le fichier manifeste DBCluster.
Nom de la métrique
Description
Label
Unité
Type
alloydb_omni_dbcluster_ha_ready
L'état de préparation de la haute disponibilité (HA) du `DBCluster`:
1 si ha-ready, sinon
0.
reason : raison pour laquelle ce DBCluster est (non) prêt pour la haute disponibilité.
1
Jauge
alloydb_omni_dbcluster_primary_ready
État de préparation du nœud principal DBCluster : 1 s'il est prêt, sinon 0.
reason : raison pour laquelle le nœud principal de ce DBCluster est (non) prêt.
1
Jauge
alloydb_omni_dbcluster_status_info
État actuel de DBCluster.
phase : phase du DBCluster.
database_version : version en cours d'exécution de l'image AlloyDB Omni (par exemple, 15.7.0).
controlplane_agents_version : version actuelle de l'image des agents du plan de contrôle (par exemple, 1.3.0).
read_write_endpoint : point de terminaison en lecture/écriture du DBCluster.
read_only_endpoint : point de terminaison en lecture seule de DBCluster.
primary_phase : phase du nœud principal DBCluster.
haready_status : état de la condition HAReady, True ou False.
haready_reason : raison de la condition HAReady.
1
Infos
alloydb_omni_dbcluster_spec_info
Configuration DBCluster sous le champ spec du fichier manifeste DBCluster.
num_standbys : nombre de nœuds de secours configurés.
database_version : version de l'image AlloyDB Omni configurée (par exemple, 15.7.0).
controlplane_agents_version : version de l'image des agents du plan de contrôle configurée (par exemple, 1.3.0).
is_deleted : indique si ce DBCluster est marqué pour suppression (valeur définie sur true ou false.)
allow_external_incoming_traffic : indique si ce DBCluster est configuré pour autoriser le trafic en provenance du cluster Kubernetes, true ou false.
1
Infos
alloydb_omni_dbcluster_spec_num_standbys
Nombre de stand-by définis dans la spécification DBCluster.
N/A
1
Jauge
alloydb_omni_dbcluster_critical_incident_info
Entrées d'incidents critiques sous la section status.criticalIncidents du fichier manifeste DBCluster.
create_time : heure à laquelle l'incident critique s'est produit.
message : message d'erreur de l'incident critique.
Heure à laquelle l'incident critique s'est produit, exprimée au format heure epoch Unix.
message : message d'erreur de l'incident critique.
code : code d'erreur de l'incident critique.
s
Jauge
Métriques de basculement
Les métriques de basculement sont des métriques exposées à partir du fichier manifeste de ressources Failover. Tous les noms de métriques de basculement commencent par alloydb_omni_failover_. Toutes les métriques de basculement comportent les libellés suivants :
Clé
Valeur
namespace
Espace de noms auquel appartient Failover.
failover
Nom de la ressource personnalisée Failover.
dbcluster
Nom de la ressource personnalisée DBCluster que le basculement cible.
Cette valeur est identique au champ spec.dbclusterRef du Failover.
Les libellés du tableau suivant auront une valeur vide et seront considérés comme équivalents aux libellés qui n'existent pas en fonction des noms et libellés des métriques Prometheus si le champ correspondant n'est pas présent dans le fichier manifeste de basculement.
Nom de la métrique
Description
Label
Unité
Type
alloydb_omni_failover_start_time
Heure de début de cette Failover, exprimée au format epoch Unix.
state : état du Failover.
phase : phase du Failover.
s
Jauge
alloydb_omni_failover_end_time
Heure à laquelle Failover s'est terminé, exprimée au format heure epoch Unix
state : état de Failover
phase : phase de Failover.
s
Jauge
alloydb_omni_failover_status_info
État actuel de Failover.
start_time : heure à laquelle Failover a commencé.
end_time : heure à laquelle Failover s'est terminé.
new_primary : nom du nœud principal une fois l'Failover terminé.
old_primary : nom du nœud principal avant le démarrage de Failover
phase : phase du Failover.
state : état du Failover.
1
Infos
Métriques PgBouncer
Les métriques PgBouncer sont des métriques exposées à partir des fichiers manifeste de la ressource PgBouncer. Tous les noms de métriques PgBouncer commencent par alloydb_omni_pgbouncer_. Toutes les métriques PGBouncer comportent les libellés suivants :
Clé
Valeur
namespace
Espace de noms auquel appartient PgBouncer.
pgbouncer
Nom de la ressource personnalisée PgBouncer.
dbcluster
Nom de la ressource personnalisée DBCluster ciblée par PgBouncer. Cette valeur est identique au champ spec.dbclusterRef de PgBouncer.
Les libellés du tableau suivant auront une valeur vide et seront considérés comme équivalents aux libellés inexistants en fonction des noms et libellés des métriques Prometheus si le champ correspondant n'est pas présent dans le fichier manifeste PgBouncer.
Nom de la métrique
Description
Label
Unité
Type
alloydb_omni_pgbouncer_status_info
État actuel de PgBouncer.
endpoint : point de terminaison exposé par ce PgBouncer. Vous vous connectez à ce point de terminaison pour exécuter des requêtes sur le DBCluster ciblé par ce Pgbouncer.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/03 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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)."]]
