Personalizzare l'installazione di AlloyDB Omni

Seleziona una versione della documentazione:

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 viene eseguito solo nell'immagine container AlloyDB Omni. Questo agente raccoglie periodicamente 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

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 PostgreSQL nella directory dei dati persistenti del container, segui questi passaggi:

  1. Individua il file postgresql.conf nella directory di dati del database ($PGDATA).

  2. Disabilita la telemetria AlloyDB Omni.

    omni_enable_telemetry = off

  3. Per applicare la modifica, riavvia il container AlloyDB Omni. L'agente di telemetria interrompe la raccolta e l'invio delle metriche di utilizzo a Google.

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:

  1. Connettiti all'istanza AlloyDB Omni utilizzando psql:

    psql -h HOST -U USER -d DATABASE

    Effettua le seguenti sostituzioni:

    • HOST: il nome host o l'indirizzo IP della tua istanza AlloyDB Omni, ad esempio 127.0.0.1.
    • USER: l'utente del database con cui vuoi connetterti, ad esempio postgres.
    • DATABASE: il database a cui vuoi connetterti, ad esempio postgres.

  2. Esegui questo comando:

    ALTER SYSTEM SET omni_enable_telemetry = 'off';

  3. Ricarica la configurazione o riavvia l'istanza. In alcune configurazioni di container, potrebbe essere necessario riavviare l'istanza per assicurarti che la modifica venga applicata completamente dal worker in background.

    SELECT pg_reload_conf();

    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

  1. Individua il file postgresql.conf nella directory di dati del database ($PGDATA).

  2. Imposta la seguente riga:

    omni_enable_telemetry = on

  3. Per applicare la modifica, riavvia il container AlloyDB Omni.

Imposta il flag di telemetria in fase di runtime utilizzando ALTER SYSTEM

  1. Connettiti all'istanza AlloyDB Omni utilizzando psql.

  2. Esegui questo comando:

    ALTER SYSTEM SET omni_enable_telemetry = 'on';

  3. Per applicare la modifica, riavvia il container AlloyDB Omni.

    docker restart CONTAINER_NAME

    Sostituisci quanto segue:

    • CONTAINER_NAME: il nome del tuo container AlloyDB Omni, ad esempio my-omni-1.

Controlla lo stato della telemetria AlloyDB Omni

Puoi controllare lo stato dell'agente di telemetria AlloyDB Omni, incluso se è abilitato o in esecuzione. 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:

  1. Connettiti all'istanza.
  2. 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 del container:

docker top CONTAINER_NAME

Sostituisci quanto segue:

  • CONTAINER_NAME: il nome del tuo container AlloyDB Omni, ad esempio my-omni-1.

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 del container:

docker logs CONTAINER_NAME 2>&1 | grep telemetry

Sostituisci quanto segue:

  • CONTAINER_NAME: il nome del tuo container AlloyDB Omni, ad esempio my-omni-1.

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

Docker

docker exec -it CONTAINER_NAME psql -U postgres

Docker

docker exec -it CONTAINER_NAME psql -U postgres

Podman

podman exec -it CONTAINER_NAME psql -U postgres

Podman

podman exec -it CONTAINER_NAME psql -U postgres

Sostituisci la seguente variabile:

  • CONTAINER_NAME: il nome del container AlloyDB Omni, ad esempio my-omni-1.

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.