AlloyDB Omni-Installation anpassen

Wählen Sie eine Dokumentationsversion aus:

Auf dieser Seite wird beschrieben, wie Sie Ihre AlloyDB Omni-Installation anpassen. AlloyDB Omni unterstützt verschiedene Formen der Anpassung. Auf dieser Seite finden Sie einige häufige Anpassungen.

AlloyDB Omni-Telemetrie aktivieren und deaktivieren

Die AlloyDB Omni-Telemetrie implementiert einen einfachen Client-Agent, der nur im AlloyDB Omni-Container-Image ausgeführt wird. Dieser Agent erfasst regelmäßig eine Reihe grundlegender, pseudonymisierter Messwerte und sendet sie an einen von Google verwalteten Endpunkt.

Da AlloyDB Omni ein herunterladbares Produkt ist, das kostenlos angeboten wird, liefert diese Telemetrie Google wichtige, nicht personenbezogene Messwerte zu den allgemeinen Umgebungen für die Einführung und Bereitstellung von ausgeführten Instanzen. Diese Daten helfen bei der Produktentwicklung und der Priorisierung des Supports.

Zu den erfassten Messwerten gehören:

  • Eindeutige Installations-ID (pseudonymisierte UUID)
  • AlloyDB Omni-Version und PostgreSQL-Hauptversion
  • Informationen zum Hostsystem wie Anzahl der CPUs, RAM und Betriebszeit

Telemetrieberichte deaktivieren

Wenn Sie verhindern möchten, dass der Telemetrie-Agent ausgeführt wird und Nutzungsmesswerte meldet, setzen Sie den PostgreSQL-Konfigurationsparameter omni_enable_telemetry auf off. Sie können den Telemetrie-Agent deaktivieren, indem Sie das Telemetrie-Flag in der Datei postgresql.conf festlegen oder das Flag zur Laufzeit mit ALTER SYSTEM festlegen.

Telemetrie-Flag in der Datei postgresql.conf festlegen

So ändern Sie die PostgreSQL-Konfigurationsdatei im persistenten Datenverzeichnis Ihres Containers:

  1. Suchen Sie die Datei postgresql.conf im Datenverzeichnis Ihrer Datenbank ($PGDATA).

  2. Deaktivieren Sie die AlloyDB Omni-Telemetrie.

    omni_enable_telemetry = off

  3. Starten Sie den AlloyDB Omni-Container neu, um die Änderung anzuwenden. Der Telemetrie-Agent erfasst und sendet keine Nutzungsmesswerte mehr an Google.

Telemetrie-Flag zur Laufzeit mit ALTER SYSTEM festlegen

So legen Sie das Telemetrie-Flag fest und behalten die Änderung auch nach Neustarts bei:

  1. Stellen Sie mit psql eine Verbindung zu Ihrer AlloyDB Omni-Instanz her:

    psql -h HOST -U USER -d DATABASE

    Ersetzen Sie die folgenden Werte:

    • HOST: Der Hostname oder die IP-Adresse Ihrer AlloyDB Omni-Instanz, z. B. 127.0.0.1.
    • USER: Der Datenbanknutzer, mit dem Sie eine Verbindung herstellen möchten, z. B. postgres.
    • DATABASE: Die Datenbank, mit der Sie eine Verbindung herstellen möchten, z. B. postgres.

  2. Führen Sie dazu diesen Befehl aus:

    ALTER SYSTEM SET omni_enable_telemetry = 'off';

  3. Laden Sie die Konfiguration neu oder starten Sie die Instanz neu. Bei einigen Containerkonfigurationen müssen Sie die Instanz möglicherweise neu starten, damit die Änderung vollständig vom Hintergrundprozess übernommen wird.

    SELECT pg_reload_conf();

    Der Telemetrie-Agent erfasst und sendet keine Nutzungsmesswerte mehr an Google.

Telemetrieberichte aktivieren

Wenn Sie die AlloyDB Omni-Telemetrie zuvor deaktiviert haben, können Sie sie wieder aktivieren, indem Sie das Flag omni_enable_telemetry auf on setzen. Sie können den Telemetrie-Agent aktivieren, indem Sie das Flag in der Datei postgresql.conf festlegen oder das Flag zur Laufzeit mit ALTER SYSTEM festlegen.

Telemetrie-Flag in der Datei postgresql.conf festlegen

  1. Suchen Sie die Datei postgresql.conf im Datenverzeichnis Ihrer Datenbank ($PGDATA).

  2. Legen Sie die folgende Zeile fest:

    omni_enable_telemetry = on

  3. Starten Sie den AlloyDB Omni-Container neu, um die Änderung anzuwenden.

Telemetrie-Flag zur Laufzeit mit ALTER SYSTEM festlegen

  1. Stellen Sie mit psql eine Verbindung zu Ihrer AlloyDB Omni-Instanz her.

  2. Führen Sie dazu diesen Befehl aus:

    ALTER SYSTEM SET omni_enable_telemetry = 'on';

  3. Starten Sie den AlloyDB Omni-Container neu, um die Änderung anzuwenden.

    docker restart CONTAINER_NAME

    Ersetzen Sie Folgendes:

    • CONTAINER_NAME: Der Name Ihres AlloyDB Omni-Containers, z. B. my-omni-1.

Status der AlloyDB Omni-Telemetrie prüfen

Sie können den Status des AlloyDB Omni-Telemetrie-Agents prüfen, einschließlich ob er aktiviert ist und ausgeführt wird. Sie können auch die Aktivität des Telemetrie-Agents prüfen.

Prüfen, ob der Telemetrie-Agent aktiviert oder deaktiviert ist

So prüfen Sie den Status der Telemetrieeinstellung:

  1. Verbindung zur Instanz herstellen
  2. Führen Sie den folgenden Befehl aus:
SHOW omni_enable_telemetry;

Die Ausgabe gibt on oder off zurück, je nachdem, ob Sie die AlloyDB Omni-Telemetrie deaktiviert oder aktiviert haben.

Prüfen, ob der Telemetrie-Agent ausgeführt wird

Führen Sie den folgenden Befehl auf dem Containerhost aus, um zu prüfen, ob der Telemetrie-Agent ausgeführt wird:

docker top CONTAINER_NAME

Ersetzen Sie Folgendes:

  • CONTAINER_NAME: Der Name Ihres AlloyDB Omni-Containers, z. B. my-omni-1.

Wenn die Telemetrie aktiviert ist und ausgeführt wird, enthält die Ausgabe eine Zeile mit dem Text postgres: omni telemetry worker.

Aktivität des Telemetrie-Agents prüfen

Führen Sie den folgenden Befehl auf dem Containerhost aus, um die Aktivität des Telemetrie-Agents zu prüfen:

docker logs CONTAINER_NAME 2>&1 | grep telemetry

Ersetzen Sie Folgendes:

  • CONTAINER_NAME: Der Name Ihres AlloyDB Omni-Containers, z. B. my-omni-1.

Wenn der Telemetrie-Agent ausgeführt wird, enthalten die Logs Meldungen wie die folgenden:

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.

Verbindung zur Instanz herstellen

Je nach Umgebung können Sie entweder lokal oder remote eine Verbindung zu Ihrer AlloyDB Omni-Instanz herstellen.

Regional präsent sein

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

Ersetzen Sie die folgende Variable:

  • CONTAINER_NAME: Der Name Ihres AlloyDB Omni-Containers, z. B. my-omni-1.

Remote-Verbindung herstellen

/usr/lib/postgresql/18/bin/psql -U postgres -p HOST_PORT -h IP_ADDRESS_OR_FQDN

Ersetzen Sie die folgenden Variablen:

  • HOST_PORT: Der TCP-Port, den Sie bei der Installation verwendet haben.
  • IP_ADDRESS_OR_FQDN: Die IP-Adresse oder der vollständig qualifizierte Domainname des Hosts, auf dem AlloyDB Omni ausgeführt wird.

Erweiterungen aktivieren

Die Liste der in AlloyDB Omni verfügbaren Erweiterungen finden Sie unter Unterstützte Datenbankerweiterungen. PostGIS und Orafce sind zwar nicht in AlloyDB Omni enthalten, können aber beide gemäß der folgenden Anleitung installiert werden:

Installierte Erweiterungen werden mit Standard-PostgreSQL-CREATE EXTENSION-Anweisungen aktiviert, wie unter Erweiterung aktivieren beschrieben.