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, pseudonymer Messwerte erfasst und an einen von Google verwalteten Endpunkt sendet.
Da AlloyDB Omni ein herunterladbares Produkt ist, das kostenlos angeboten wird, liefert diese Telemetrie Google wichtige, nicht personenidentifizierbare Informationen (Nicht-PII) zu den allgemeinen Akzeptanz- und Bereitstellungsumgebungen laufender 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 CPU-Anzahl, RAM und Betriebszeit
- Informationen zur Datenbankkonfiguration und Funktionsnutzung, einschließlich Datenbank-Flags, GUC-Parametern (Grand Unified Configuration) und aggregierten Statistiken zur Nutzung von AlloyDB Omni-Funktionen und Datenbankfunktionen
Berichte mit Telemetriedaten 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 oder zur Laufzeit mit ALTER SYSTEM festlegen.
Telemetrie-Flag in der Datei „postgresql.conf“ festlegen
So ändern Sie die PostgreSQL-Konfigurationsdatei:
- Suchen Sie die Datei
postgresql.confim Datenverzeichnis Ihrer Datenbank. Der Standardwert ist/var/lib/postgresql/MAJOR_VERSION/data. AlloyDB Omni-Telemetrie deaktivieren.
omni_enable_telemetry = off
Starten Sie den AlloyDB Omni-Dienst neu, um die Änderung zu übernehmen. Der Telemetrie-Agent erfasst keine Nutzungsmesswerte mehr und sendet sie nicht 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 auch nach Neustarts bei:
Stellen Sie mit
psqleine Verbindung zu Ihrer AlloyDB Omni-Instanz her:/usr/lib/postgresql/18/bin/psql -h localhost -U postgres
Führen Sie dazu diesen Befehl aus:
ALTER SYSTEM SET omni_enable_telemetry = 'off';
Starten Sie den Datenbankdienst neu, damit die Änderung vom Hintergrund-Worker vollständig übernommen wird.
systemctl restart alloydbomni18
Der Telemetrie-Agent erfasst keine Nutzungsmesswerte mehr und sendet sie nicht 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-Agent, indem Sie das Flag in der Datei postgresql.conf oder zur Laufzeit mit ALTER SYSTEM festlegen.
Telemetrie-Flag in der Datei „postgresql.conf“ festlegen
- Suchen Sie die Datei
postgresql.confim Datenverzeichnis Ihrer Datenbank. Legen Sie die folgende Zeile fest:
omni_enable_telemetry = on
Starten Sie den AlloyDB Omni-Dienst neu, um die Änderung zu übernehmen.
systemctl restart alloydbomni18
Telemetrie-Flag zur Laufzeit mit ALTER SYSTEM festlegen
- Stellen Sie über
psqleine Verbindung zu Ihrer AlloyDB Omni-Instanz her. Führen Sie dazu diesen Befehl aus:
ALTER SYSTEM SET omni_enable_telemetry = 'on';
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, 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:
- Verbindung zur Instanz herstellen
- 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 Host 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.
Aktivität des Telemetrie-Agents 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 remote eine Verbindung zu Ihrer AlloyDB Omni-Instanz herstellen.
Lokal verbinden
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-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: IP-Adresse oder voll qualifizierter 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.