AlloyDB Omni-Installation anpassen

Wählen Sie eine Dokumentationsversion aus:

Auf dieser Seite wird beschrieben, wie Sie Ihre AlloyDB Omni-Installation anpassen, die verschiedene Formen der Anpassung unterstützt. 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 eine Reihe grundlegender, pseudonymisierter Messwerte erfasst und an einen von Google verwalteten Endpunkt sendet.

Da AlloyDB Omni ein kostenloses, herunterladbares Produkt ist, liefert diese Telemetrie Google wichtige Nicht-PII-Messwerte zu den allgemeinen Umgebungen für die Einführung und Bereitstellung von laufenden Instanzen. Diese Daten helfen uns, die Produktentwicklung und die Priorisierung des Supports zu steuern.

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

Berichte mit Telemetriedaten deaktivieren

Damit der Telemetrie-Agent nicht ausgeführt wird und keine Nutzungsmesswerte erfasst werden, 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:

  1. Suchen Sie die postgresql.conf-Datei im Datenverzeichnis Ihrer Datenbank. Der Standardwert ist /var/lib/postgresql/MAJOR_VERSION/data.

  2. AlloyDB Omni-Telemetrie deaktivieren

    omni_enable_telemetry = off

  3. Starten Sie den AlloyDB Omni-Dienst neu, um die Änderung zu übernehmen. Der Telemetrie-Agent erfasst und sendet keine Nutzungsstatistiken mehr an Google.

    systemctl restart alloydbomniMAJOR_VERSION

Telemetrie-Flag zur Laufzeit mit ALTER SYSTEM festlegen

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

  1. Verbindung zu Ihrer AlloyDB Omni-Instanz mit psql herstellen:

    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres

  2. Führen Sie dazu diesen Befehl aus:

    ALTER SYSTEM SET omni_enable_telemetry = 'off';

  3. Starten Sie den Datenbankdienst neu, damit die Änderung vollständig vom Hintergrundworker übernommen wird.

    systemctl restart alloydbomni18

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

Berichte mit Telemetriedaten 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 aktivieren den Telemetrie-Agenten, indem Sie das Flag in der Datei postgresql.conf oder zur Laufzeit mit ALTER SYSTEM festlegen.

Telemetrie-Flag in der Datei „postgresql.conf“ festlegen

  1. Suchen Sie die postgresql.conf-Datei im Datenverzeichnis Ihrer Datenbank.

  2. Legen Sie die folgende Zeile fest:

    omni_enable_telemetry = on

  3. Starten Sie den AlloyDB Omni-Dienst neu, um die Änderung zu übernehmen.

    systemctl restart alloydbomni18

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-Dienst neu, um die Änderung zu übernehmen.

    systemctl restart alloydbomni18

AlloyDB Omni-Telemetriestatus prüfen

Sie können den Status des AlloyDB Omni-Telemetrie-Agents prüfen, einschließlich der Frage, ob er aktiviert oder deaktiviert ist. 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 auf dem Host den folgenden Befehl aus, um zu prüfen, ob der Telemetrie-Agent ausgeführt wird:

ps -ef | grep "omni telemetry worker"

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

Telemetrie-Agent-Aktivität prüfen

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

journalctl -u alloydbomni18 | grep telemetry

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.

Mit Instanz verbinden

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

Regional präsent sein

Führen Sie den folgenden Befehl aus, um lokal eine Verbindung zu Ihrer AlloyDB Omni-Instanz herzustellen:

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

Remote verbinden

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

Ersetzen Sie die folgenden Variablen:

  • HOST_PORT: TCP-Port, den Sie während der Installation verwendet haben.
  • IP_ADDRESS_OR_FQDN: IP-Adresse oder vollständig qualifizierter Domainname für den Host, 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.