Gestire e monitorare AlloyDB Omni

Select a documentation version:

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.

Gestire i ruoli utente

AlloyDB Omni utilizza i seguenti ruoli:

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

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

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

Configurare un database AlloyDB Omni

Ti consigliamo di seguire questi passaggi quando configuri un database AlloyDB Omni:

  1. Definisci o importa i database utilizzando il ruolo utente postgres. In una nuova installazione, questo ruolo ha privilegi di superutente.

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

  3. Configura l'applicazione in modo che si connetta 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 nessuno dei ruoli utente forniti con AlloyDB Omni.

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

Installare e avviare 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 per recuperare i campioni di metriche da questo endpoint e integrarli nello 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 del monitor:

     sudo dnf install alloydbomni_monitor
  2. Abilita e avvia il servizio di monitoraggio:

     sudo systemctl enable alloydbomni_monitor
     sudo systemctl start alloydbomni_monitor

Configurare il monitor di AlloyDB Omni

Per impostazione predefinita, il monitor è configurato per funzionare con il nome del servizio e la directory dei dati standard di AlloyDB Omni. Se l'installazione utilizza valori personalizzati, devi configurare il monitor utilizzando un file di override di 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, che per impostazione predefinita è alloydbomni18.
    • PG_DATA_DIR: il percorso della directory dei dati del database, che per impostazione predefinita è /var/lib/postgresql/18/data.

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

      sudo -u postgres /usr/lib/postgresql/18/bin/psql -h localhost -c "SHOW data_directory;"
  2. Se l'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 dei segnaposto con la 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

Verificare 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. Sono interessate le seguenti metriche:

  • 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. Il seguente esempio configura CPUQuota su 90% e MemoryMax su 90%. Per saperne di più sui file di unità systemd, consulta Utilizzare i file di unità systemd.

  1. Crea un file di configurazione di override di systemd.

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

  2. Aggiungi i seguenti contenuti 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

Monitorare 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

Disinstallare AlloyDB Omni

Per disinstallare AlloyDB Omni, esegui:

  sudo dnf remove alloydbomni_monitor