Questa pagina descrive come personalizzare l'installazione di AlloyDB Omni, che supporta diverse forme di personalizzazione. Questa pagina mostra alcune personalizzazioni comuni.
Abilita e disabilita la telemetria AlloyDB Omni
La telemetria AlloyDB Omni implementa un agente client leggero che raccoglie un insieme di metriche di base pseudonimizzate e le invia a un endpoint gestito da Google.
Poiché AlloyDB Omni è un prodotto scaricabile offerto senza costi, questa telemetria fornisce a Google metriche essenziali sulle informazioni che non consentono l'identificazione personale (non-PII) relative agli ambienti di adozione e deployment generici delle istanze in esecuzione. Questi dati aiutano a definire lo sviluppo del prodotto e l'assegnazione delle priorità di assistenza.
Le metriche raccolte includono:
- ID di installazione univoco (UUID pseudonimizzato)
- Versione AlloyDB Omni e versione principale di PostgreSQL
- Informazioni sul sistema host, come numero di CPU, RAM e uptime
- Informazioni sulla configurazione del database e sull'utilizzo delle funzionalità, inclusi flag di database, parametri GUC (Grand Unified Configuration) e statistiche aggregate relative all'utilizzo delle funzionalità di AlloyDB Omni e delle funzionalità del database
Disattiva i report sulla telemetria
Per impedire all'agente di telemetria di eseguire e segnalare le metriche di utilizzo, imposta il parametro di configurazione PostgreSQL omni_enable_telemetry su off. Puoi disattivare l'agente di telemetria impostando il flag di telemetria nel file postgresql.conf o impostando il flag in fase di runtime utilizzando ALTER SYSTEM.
Imposta il flag di telemetria nel file postgresql.conf
Per modificare il file di configurazione di PostgreSQL, segui questi passaggi:
- Individua il file
postgresql.confnella directory di dati del database. Per impostazione predefinita, questo valore è/var/lib/postgresql/MAJOR_VERSION/data. Disabilita la telemetria AlloyDB Omni.
omni_enable_telemetry = off
Per applicare la modifica, riavvia il servizio AlloyDB Omni. L'agente di telemetria interrompe la raccolta e l'invio delle metriche di utilizzo a Google.
systemctl restart alloydbomniMAJOR_VERSION
Imposta il flag di telemetria in fase di runtime utilizzando ALTER SYSTEM
Per impostare il flag di telemetria e rendere persistente la modifica tra i riavvii, segui questi passaggi:
Connettiti all'istanza AlloyDB Omni utilizzando
psql:/usr/lib/postgresql/18/bin/psql -h localhost -U postgres
Esegui questo comando:
ALTER SYSTEM SET omni_enable_telemetry = 'off';
Riavvia il servizio di database per assicurarti che la modifica venga applicata completamente dal worker in background.
systemctl restart alloydbomni18
L'agente di telemetria interrompe la raccolta e l'invio delle metriche di utilizzo a Google.
Attiva i report sulla telemetria
Se in precedenza hai disattivato la telemetria AlloyDB Omni, puoi riattivarla impostando il flag omni_enable_telemetry su on. Puoi attivare l'agente di telemetria impostando il flag nel file postgresql.conf o impostando il flag in fase di runtime utilizzando ALTER SYSTEM.
Imposta il flag di telemetria nel file postgresql.conf
- Individua il file
postgresql.confnella directory di dati del database. Imposta la seguente riga:
omni_enable_telemetry = on
Per applicare la modifica, riavvia il servizio AlloyDB Omni.
systemctl restart alloydbomni18
Imposta il flag di telemetria in fase di runtime utilizzando ALTER SYSTEM
- Connettiti all'istanza AlloyDB Omni utilizzando
psql. Esegui questo comando:
ALTER SYSTEM SET omni_enable_telemetry = 'on';
Per applicare la modifica, riavvia il servizio AlloyDB Omni.
systemctl restart alloydbomni18
Controlla lo stato della telemetria AlloyDB Omni
Puoi controllare lo stato dell'agente di telemetria AlloyDB Omni, incluso se è abilitato o disabilitato. Puoi anche controllare l'attività dell'agente di telemetria.
Controlla se l'agente di telemetria è abilitato o disabilitato
Per controllare lo stato dell'impostazione della telemetria, segui questi passaggi:
- Connettiti all'istanza.
- Esegui questo comando:
SHOW omni_enable_telemetry;
L'output restituisce on o off, a seconda che tu abbia disattivato o attivato la telemetria AlloyDB Omni.
Controlla se l'agente di telemetria è in esecuzione
Per verificare se l'agente di telemetria è in esecuzione, esegui questo comando nell'host:
ps -ef | grep "omni telemetry worker"
Se la telemetria è abilitata e in esecuzione, l'output contiene una riga con il testo postgres: omni telemetry worker.
Controlla l'attività dell'agente di telemetria
Per controllare l'attività dell'agente di telemetria, esegui questo comando nell'host:
journalctl -u alloydbomni18 | grep telemetry
Se l'agente di telemetria è in esecuzione, i log contengono messaggi simili ai seguenti:
LOG: [telemetry_agent_worker.cc:143] Started telemetry worker LOG: [telemetry_agent_worker.cc:161] Running telemetry reporting agent telemetry_agent: Uploading telemetry data to https://cloud.google.com/log.
Connettiti all'istanza
A seconda dell'ambiente, puoi connetterti all'istanza AlloyDB Omni localmente o da remoto.
Crea contatti locali
Per connetterti localmente all'istanza AlloyDB Omni, esegui questo comando:/usr/lib/postgresql/18/bin/psql -U postgres -p HOST_PORT -h localhost
Connettiti da remoto
/usr/lib/postgresql/18/bin/psql -U postgres -p HOST_PORT -h IP_ADDRESS_OR_FQDN
Sostituisci le seguenti variabili:
HOST_PORT: la porta TCP utilizzata durante l'installazione.IP_ADDRESS_OR_FQDN: indirizzo IP o nome di dominio completo dell'host in cui è in esecuzione AlloyDB Omni.
Attiva le estensioni
L'elenco delle estensioni disponibili in AlloyDB Omni è disponibile in Estensioni del database supportate. Sebbene PostGIS e Orafce non siano inclusi in AlloyDB Omni, possono essere installati entrambi seguendo le istruzioni:
Le estensioni installate vengono abilitate utilizzando le istruzioni CREATE EXTENSION standard di PostgreSQL, come descritto in Abilita un'estensione.