Benutzerdefinierte Ressourcenmesswerte für den AlloyDB Omni Kubernetes-Operator

Wählen Sie eine Dokumentationsversion aus:

Auf dieser Seite werden die Messwerte für benutzerdefinierte Ressourcen (CR) für den AlloyDB Omni Kubernetes-Operator beschrieben. Der AlloyDB Omni Kubernetes-Operator stellt Messwerte bereit, die aus Manifesten benutzerdefinierter Ressourcen im Prometheus-Format mit kube-state-metrics erstellt wurden.

Messwerttypen entsprechen der Definition von Prometheus-Messwerttypen. Ein Prometheus-Info-Messwert ist eine spezielle Art von Prometheus-Gauge-Messwert, der immer den Wert 1 hat und mehrere Labels mit wichtigen Informationen zur entsprechenden benutzerdefinierten Ressource des AlloyDB Omni Kubernetes-Operators enthält.

Informationen zum Aktivieren von Messwerten für benutzerdefinierte Ressourcen finden Sie unter Benutzerdefinierte Ressourcen des AlloyDB Omni Kubernetes-Operators überwachen.

Metadatenlabels für benutzerdefinierte Ressourcendefinitionen (Custom Resource Definition, CRD)

Alle benutzerdefinierten Ressourcenmesswerte haben die folgenden Labels, die die Gruppe, Version und Art der CRD kennzeichnen. Weitere Informationen finden Sie unter Kubernetes API-Konzepte. Die Definitionen und Namen der Labels sind in der folgenden Tabelle aufgeführt:

Schlüssel Beschreibung Beispielwert

customresource_group

Die Gruppe der CRD.

alloydbomni.dbadmin.goog

customresource_version

Die Version der CRD.

v1

customresource_kind

Die Art der CRD.

DBCluster

Sicherungsmesswerte

Sicherungs-Messwerte werden in Backup-Ressourcenmanifesten bereitgestellt. Alle Namen von Sicherungsmesswerten beginnen mit alloydb_omni_backup_. Alle Sicherungsmesswerte haben die folgenden Labels:

Schlüssel Wert

backup

[metadata, name]

backupplan

[metadata, name]

namespace

[metadata, namespace]

dbcluster

[spec, dbclusterRef]

Die Labels in der folgenden Tabelle haben einen leeren Wert und werden gemäß Prometheus-Messwertnamen und -Labels als nicht vorhanden betrachtet, wenn das entsprechende Feld nicht im Backup-Manifest vorhanden ist.

Name des Messwerts Beschreibung Label Einheit Typ

alloydb_omni_backup_phase

Aktueller Status der Sicherung („Erfolgreich“, „In Bearbeitung“ oder „Fehlgeschlagen“)

–

1

StateSet

alloydb_omni_backup_start_time

Unix-Zeitstempel des Beginns der Sicherung

–

Sek.

Gauge

alloydb_omni_backup_end_time

Unix-Zeitstempel der Endzeit der Sicherung

–

Sek.

Gauge

alloydb_omni_backup_duration_seconds

Dauer des Sicherungsvorgangs in Sekunden

–

Sek.

Gauge

alloydb_omni_backup_backup_size

Größe der abgeschlossenen Sicherung in Byte

–

Byte

Gauge

alloydb_omni_backup_spec_info

Spezifikation der Sicherung
  • backup_source_role: [spec, backupSourceRole]
  • manual: [spec, manual]
  • backup_type: [spec, physicalBackupSpec, backupType]

1

Info

alloydb_omni_backup_status_info

Sicherungsstatus
  • phase: [status, phase]
  • backup_id: [status, physicalBackupStatus, backupID]
  • prior_backup: [status, physicalBackupStatus, priorBackup]
  • backup_type: [status, physicalBackupStatus, backupType]
  • lsn_start: [status, physicalBackupStatus, lsn, start]
  • lsn_stop: [status, physicalBackupStatus, lsn, stop]
  • wal_start: [status, physicalBackupStatus, wal, start]
  • wal_stop: [status, physicalBackupStatus, wal, stop]
  • retain_expire_time: [status, retainExpire_time]

1

Info

alloydb_omni_backup_critical_incident_info

Sicherung kritischer Vorfälle
  • create_time: [status, criticalIncidents, createTime]
  • message: [status, criticalIncidents, message]
  • code: [status, criticalIncidents, code]

1

Info

alloydb_omni_backup_critical_incident_createtime

„createTime“ für kritische Vorfälle in Backups
  • message: [status, criticalIncidents, message]
  • code: [status, criticalIncidents, code]

Sek.

Gauge

BackupPlan-Messwerte

BackupPlan-Messwerte werden aus BackupPlan-Ressourcenmanifesten bereitgestellt. Alle BackupPlan-Messwertnamen beginnen mit alloydb_omni_backupplan_. Alle BackupPlan-Messwerte haben die folgenden Labels:

Schlüssel Wert

backupplan

[metadata, name]

namespace

[metadata, namespace]

dbcluster

[spec, dbclusterRef]

Die Labels in der folgenden Tabelle haben einen leeren Wert und werden als Labels betrachtet, die basierend auf Prometheus-Messwertnamen und -Labels nicht vorhanden sind, wenn das entsprechende Feld im BackupPlan-Manifest nicht vorhanden ist.

Name des Messwerts Beschreibung Label Einheit Typ

alloydb_omni_backupplan_phase

Aktueller Status des Sicherungsplans

–

1

StateSet

alloydb_omni_backupplan_last_backup_time

Unix-Zeitstempel der letzten geplanten Sicherung des Plans

–

Sek.

Gauge

alloydb_omni_backupplan_next_backup_time

Unix-Zeitstempel der nächsten geplanten Sicherung durch den Plan

–

Sek.

Gauge

alloydb_omni_backupplan_recovery_window_begin

Unix-Zeitstempel des Beginns der Wiederherstellung

–

Sek.

Gauge

alloydb_omni_backupplan_recovery_window_end

Unix-Zeitstempel der Endzeit der Wiederherstellung

–

Sek.

Gauge

alloydb_omni_backupplan_spec_info

Spezifikation des Sicherungsplans
  • full_schedule: [spec, backupSchedules, full]
  • differential_schedule: [spec, backupSchedules, differential]
  • incremental_schedule: [spec, backupSchedules, incremental]
  • backup_retain_days: [spec, backupRetainDays]
  • backup_source_strategy: [spec, backupSourceStrategy]
  • paused: [spec, paused]

1

Info

alloydb_omni_backupplan_status_info

Status des Sicherungsplans
  • phase: [status, phase]
  • last_backup_time: [status, lastBackupTime]
  • next_backup_time: [status, nextBackupTime]
  • recovery_window_begin: [status, recoveryWindow, begin]
  • recovery_window_end: [status, recoveryWindow, end]

1

Info

alloydb_omni_backupplan_critical_incident_info

Kritische Vorfälle im Sicherungsplan
  • create_time: [status, criticalIncidents, createTime]
  • message: [status, criticalIncidents, message]
  • code: [status, criticalIncidents, code]

1

Info

alloydb_omni_backupplan_critical_incident_createtime

Erstellungszeit des kritischen Vorfalls im Sicherungsplan
  • message: [status, criticalIncidents, message]
  • code: [status, criticalIncidents, code]

Sek.

Gauge

DBCluster-Messwerte

DBCluster-Messwerte werden über DBCluster-Ressourcenmanifeste bereitgestellt. Alle DBCluster-Messwertnamen beginnen mit alloydb_omni_dbcluster_. Alle DBCluster-Messwerte haben die folgenden Labels:

Schlüssel Wert

namespace

Der Namespace, zu dem der DBCluster gehört.

dbcluster

Der Name der benutzerdefinierten DBCluster-Ressource.

Die Labels in der folgenden Tabelle haben einen leeren Wert und gelten als gleichwertig mit Labels, die gemäß Prometheus-Messwertnamen und ‑Labels nicht vorhanden sind, wenn das entsprechende Feld nicht im DBCluster-Manifest vorhanden ist.

Name des Messwerts Beschreibung Label Einheit Typ

alloydb_omni_dbcluster_ha_ready

Die Hochverfügbarkeitsbereitschaft des „DBCluster“: 1, wenn ha-ready, andernfalls 0. reason: Der Grund, warum diese DBCluster (nicht) für Hochverfügbarkeit bereit ist. 1 Gauge

alloydb_omni_dbcluster_primary_ready

Die Bereitschaft des primären Knotens DBCluster: 1, wenn bereit, andernfalls 0. reason: Der Grund, warum der primäre Knoten dieses DBCluster (nicht) bereit ist. 1 Gauge

alloydb_omni_dbcluster_status_info

Der aktuelle Status von DBCluster.
  • phase: die Phase des DBCluster.
  • database_version: Die aktuell ausgeführte Version des AlloyDB Omni-Images, z. B. 15.7.0.
  • controlplane_agents_version: die aktuell ausgeführte Version des Images der Agents der Steuerungsebene, z. B. 1.3.0.
  • read_write_endpoint: Der Lese-/Schreibendpunkt des DBClusters.
  • read_only_endpoint: der Lesezugriff-Endpunkt des DBClusters.
  • primary_phase: die Phase des primären Knotens DBCluster.
  • haready_status: HAReady-Zustandsstatus, True oder False.
  • haready_reason: der Grund für den HAReady-Zustand.
 1 Info

alloydb_omni_dbcluster_spec_info

DBCluster-Konfiguration im Feld spec des DBCluster-Manifests.
  • num_standbys:Die Anzahl der konfigurierten Stand-by-Knoten.
  • database_version: Die Version des konfigurierten AlloyDB Omni-Images, z. B. 15.7.0.
  • controlplane_agents_version: Die Version des konfigurierten Images der Agents der Steuerungsebene, z. B. 1.3.0.
  • is_deleted: gibt an, ob dieser DBCluster zum Löschen markiert ist, festgelegt auf true oder false.
  • allow_external_incoming_traffic: Gibt an, ob dieser DBCluster so konfiguriert ist, dass Traffic von außerhalb des Kubernetes-Clusters, true oder false, zugelassen wird.
 1 Info

alloydb_omni_dbcluster_spec_num_standbys

Die Anzahl der Stand-by-Instanzen, die in der DBCluster-Spezifikation definiert sind. – 1 Gauge

alloydb_omni_dbcluster_critical_incident_info

Kritische Vorfallseinträge im Abschnitt status.criticalIncidents des DBCluster-Manifests.
  • create_time: Die Uhrzeit, zu der der kritische Vorfall aufgetreten ist.
  • message: Die Fehlermeldung des kritischen Vorfalls.
  • code: Der Fehlercode des kritischen Vorfalls.
 1 Info

alloydb_omni_dbcluster_critical_incident_create_time

Der Zeitpunkt, zu dem der kritische Vorfall aufgetreten ist, im Format Unix-Epoche.
  • message: Die Fehlermeldung des kritischen Vorfalls.
  • code: Der Fehlercode des kritischen Vorfalls.
 Sek. Gauge

Failover-Messwerte

Failover-Messwerte sind Messwerte, die im Failover-Ressourcenmanifest verfügbar sind. Alle Failover-Messwertnamen beginnen mit alloydb_omni_failover_. Alle Failover-Messwerte haben die folgenden Labels:

Schlüssel Wert

namespace

Der Namespace, zu dem die Failover gehört.

failover

Der Name der benutzerdefinierten Ressource Failover.

dbcluster

Der Name der benutzerdefinierten DBCluster-Ressource, auf die sich das Failover bezieht. Dieser Wert entspricht dem Feld spec.dbclusterRef von Failover.

Die Labels in der folgenden Tabelle haben einen leeren Wert und werden als Labels betrachtet, die nicht vorhanden sind, basierend auf Prometheus-Messwertnamen und -Labels, wenn das entsprechende Feld im Failover-Manifest nicht vorhanden ist.

Messwertname Beschreibung Label Einheit Typ

alloydb_omni_failover_start_time

Der Zeitpunkt, zu dem dieser Failover gestartet wurde, angegeben im Unix-Epochenzeitformat.
  • state: Der Status des Failover.
  • phase: die Phase des Failover.
 Sek. Gauge

alloydb_omni_failover_end_time

Der Zeitpunkt, zu dem die Failover abgeschlossen wurde, im Format der Unix-Epoche
  • state: der Status des Failover
  • phase: die Phase des Failover
 Sek. Gauge

alloydb_omni_failover_status_info

Der aktuelle Status von Failover.
  • start_time: die Zeit, zu der die Failover gestartet wurde.
  • end_time: Die Uhrzeit, zu der die Failover beendet wurde.
  • new_primary: Der Name des primären Knotens nach Abschluss von Failover.
  • old_primary: der Name des primären Knotens vor dem Start des Failover
  • phase: die Phase des Failover.
  • state: der Status des Failover.
 1 Info

PgBouncer-Messwerte

PgBouncer-Messwerte sind Messwerte, die über PgBouncer-Ressourcenmanifeste bereitgestellt werden. Alle PgBouncer-Messwertnamen beginnen mit alloydb_omni_pgbouncer_. Alle PgBouncer-Messwerte haben die folgenden Labels:

Schlüssel Wert

namespace

Der Namespace, zu dem die PgBouncer gehört.

pgbouncer

Der Name der benutzerdefinierten Ressource PgBouncer.

dbcluster

Der Name der benutzerdefinierten DBCluster-Ressource, auf die sich diese PgBouncer bezieht. Dieser Wert entspricht dem Feld spec.dbclusterRef der PgBouncer.

Die Labels in der folgenden Tabelle haben einen leeren Wert und gelten als gleichwertig mit Labels, die nicht vorhanden sind, basierend auf Prometheus-Messwertnamen und ‑Labels, wenn das entsprechende Feld nicht im PgBouncer-Manifest vorhanden ist.

Name des Messwerts Beschreibung Label Einheit Typ

alloydb_omni_pgbouncer_status_info

Der aktuelle Status von PgBouncer.
  • endpoint: Der von diesem PgBouncer bereitgestellte Endpunkt. Sie stellen eine Verbindung zu diesem Endpunkt her, um Abfragen für den DBCluster auszuführen, auf den dieser PgBouncer abzielt.
  • phase: die Phase des PgBouncers
 1 Info

Nächste Schritte