Gestire e monitorare AlloyDB Omni

Seleziona una versione della documentazione:

Questa pagina descrive come gestire i ruoli utente di AlloyDB Omni, monitorare l'attività del server AlloyDB Omni e aggiornare o rimuovere l'installazione di AlloyDB Omni.

Gestisci i ruoli utente

AlloyDB Omni utilizza i seguenti ruoli:

  • AlloyDB Omni include un ruolo di super utente denominato alloydbadmin e un ruolo non di super utente denominato alloydbmetadata.

  • L'utente postgres predefinito ha un ruolo di super utente.

  • Tutti gli altri ruoli utente predefiniti non hanno privilegi. Sono riservati per potenziali utilizzi futuri.

Configura un database AlloyDB Omni

Ti consigliamo di seguire questi passaggi per configurare un database AlloyDB Omni:

  1. Definisci o importa i tuoi database utilizzando il ruolo utente postgres. In una nuova installazione, questo ruolo dispone dei privilegi di super utente.

  2. Crea nuovi ruoli utente con il livello di accesso corretto alle tabelle della tua applicazione, sempre utilizzando il ruolo utente postgres.

  3. Configura l'applicazione per connetterti al database utilizzando questi nuovi ruoli con accesso limitato.

Puoi creare e definire tutti i nuovi ruoli utente di cui hai bisogno. Non modificare o eliminare i ruoli utente forniti con AlloyDB Omni.

Per saperne di più, consulta Gestisci utenti e ruoli di AlloyDB Omni.

Installa e avvia il monitor di AlloyDB Omni

Il monitor di AlloyDB Omni è un componente facoltativo che espone le metriche in un endpoint. Puoi configurare i server di monitoraggio in modo che recuperino i campioni di metriche da questo endpoint e li integrino nel tuo stack di monitoraggio.

Per installare e avviare il monitor, segui questi passaggi su ogni host che esegue il servizio AlloyDB Omni:

  1. Installa il pacchetto di monitoraggio:

     sudo dnf install alloydbomni_monitor

  2. Abilita e avvia il servizio di monitoraggio:

     sudo systemctl enable alloydbomni_monitor
 sudo systemctl start alloydbomni_monitor

Configura il monitor di AlloyDB Omni

Per impostazione predefinita, il monitor è configurato per funzionare con il nome del servizio e la directory di dati standard di AlloyDB Omni. Se l'installazione utilizza valori personalizzati, devi configurare il monitor utilizzando un file di override systemd.

  1. Controlla la configurazione predefinita in /usr/lib/systemd/system/alloydbomni_monitor.service:

    • OMNI_SERVICE_NAME: il nome del servizio systemd di AlloyDB Omni, il cui valore predefinito è alloydbomni18.

    • PG_DATA_DIR: il percorso della directory dei dati del database, il cui valore predefinito è /var/lib/postgresql/18/data.

      Per trovare la directory dei dati del database, esegui questo comando:

      sudo -u postgres /usr/lib/postgresql/18/bin/psql -h localhost -c "SHOW data_directory;"

  2. Se la tua installazione utilizza valori diversi da quelli predefiniti, crea una directory di override e un file override.conf:

     sudo mkdir -p /etc/systemd/system/alloydbomni_monitor.service.d
 sudo touch /etc/systemd/system/alloydbomni_monitor.service.d/override.conf

  3. Aggiungi i seguenti contenuti a /etc/systemd/system/alloydbomni_monitor.service.d/override.conf. Sostituisci i valori segnaposto con la tua configurazione personalizzata:

     [Service]
 Environment="OMNI_SERVICE_NAME=SERVICE_NAME"
 Environment="PG_DATA_DIR=PG_DATA_DIR"

    Sostituisci quanto segue:

    • SERVICE_NAME: il nome del servizio systemd di AlloyDB Omni (ad esempio, alloydbomni18).
    • PG_DATA_DIR: il percorso della directory dei dati del database. Ad esempio, se hai installato AlloyDB Omni utilizzando l'RPM autonomo con PGDATA=/data, specifica /data.

  4. Ricarica il daemon systemd:

     sudo systemctl daemon-reload

  5. Riavvia il servizio di monitoraggio:

     sudo systemctl restart alloydbomni_monitor

Verifica il monitor di AlloyDB Omni

  1. Verifica che il servizio di monitoraggio sia in esecuzione:

     sudo systemctl status alloydbomni_monitor

  2. Verifica che il monitor esponga le metriche effettuando una chiamata HTTP all'endpoint delle metriche:

    curl http://localhost:9187/metrics

Limitazioni del monitoraggio

Le metriche relative ai limiti di CPU e memoria di AlloyDB Omni sono visibili solo se nel tuo ambiente sono stati impostati limiti di CPU e memoria per il servizio systemd alloydbomni18. Le seguenti metriche sono interessate:

  • alloydb_omni_memory_limit_byte
  • alloydb_omni_memory_available_byte
  • alloydb_omni_node_cpu_mcpu

Se vuoi impostare limiti di CPU e memoria, configura un file di unità systemd. L'esempio seguente configura CPUQuota su 90% e MemoryMax su 90%. Per saperne di più sui file delle unità systemd, consulta Utilizzo dei file delle unità systemd.

  1. Crea un file di configurazione di override systemd.

    Crea un file override.conf nella directory /etc/systemd/system/alloydbomni18.service.d.

  2. Aggiungi i contenuti seguenti al file override.conf:

     [Service]
 CPUQuota=90%
 MemoryMax=90%

  3. Ricarica il daemon systemd:

     sudo systemctl daemon-reload

  4. Riavvia il servizio AlloyDB Omni:

     sudo systemctl restart alloydbomni18

Monitora AlloyDB Omni

Il monitoraggio dell'installazione di AlloyDB Omni include il recupero e l'analisi delle metriche di AlloyDB Omni.

Per recuperare i log di AlloyDB Omni, esegui:

  sudo journalctl -u alloydbomni18

Visualizza le metriche di sistema utilizzando System Insights

Puoi monitorare le metriche dell'infrastruttura in tempo reale e storiche per le tue istanze AlloyDB Omni utilizzando Insight di sistema nell'interfaccia utente web di AlloyDB Omni. Insight di sistema esegue query sulle metriche di Prometheus esportate dall'agente di monitoraggio di AlloyDB Omni per visualizzare i grafici di utilizzo delle risorse.

Per visualizzare le metriche di sistema nella UI web, completa i seguenti passaggi:

  1. Connettiti alla UI web e seleziona il tuo cluster.
  2. Nel menu di navigazione, fai clic su Insight di sistema.
  3. (Facoltativo) In un cluster multi-nodo, utilizza l'elenco Filtra per: Istanze per selezionare un endpoint di istanza specifico (ad esempio localhost:9187).
  4. Seleziona un intervallo di tempo (1 ora, 6 ore, 1 giorno o 7 giorni) per regolare il periodo di osservazione in tutti i grafici.
  5. Esamina i grafici di telemetria del sistema:
    • Utilizzo CPU: mostra la percentuale di utilizzo della CPU nel tempo.
    • Utilizzo della memoria: mostra la percentuale di memoria allocata in uso nel tempo.
    • Memoria disponibile: mostra la percentuale di memoria libera disponibile nel tempo.
    • Limite di memoria: mostra la quota di memoria configurata (in GB) per l'istanza.
    • I/O di archiviazione e disco: mostra sei grafici aggiuntivi che monitorano l'utilizzo dello spazio di archiviazione, il limite di spazio di archiviazione, il numero di letture del disco, i byte letti, il numero di scritture del disco e i byte scritti.

Disinstalla AlloyDB Omni

Per disinstallare AlloyDB Omni, esegui:

  sudo dnf remove alloydbomni_monitor