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
Für die AlloyDB Omni-Telemetrie wird ein einfacher Client-Agent verwendet, 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 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
- Informationen zur Datenbankkonfiguration und zur 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 erfasst, 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 Verzeichnis für persistente Daten Ihres Containers:
- Suchen Sie die Datei
postgresql.confim Datenverzeichnis Ihrer Datenbank ($PGDATA). AlloyDB Omni-Telemetrie deaktivieren
omni_enable_telemetry = off
Starten Sie Ihren AlloyDB Omni-Container neu, damit die Änderung übernommen wird. Der Telemetrie-Agent erfasst und sendet keine Nutzungsstatistiken mehr an Google.
Telemetrie-Flag zur Laufzeit mit ALTER SYSTEM festlegen
So legen Sie das Telemetrie-Flag fest und behalten die Änderung bei Neustarts bei:
So stellen Sie mit
psqleine 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.
Führen Sie dazu diesen Befehl aus:
ALTER SYSTEM SET omni_enable_telemetry = 'off';
Laden Sie die Konfiguration neu oder starten Sie die Instanz neu. In einigen Containerkonfigurationen müssen Sie die Instanz möglicherweise neu starten, damit die Änderung vollständig vom Hintergrund-Worker übernommen wird.
SELECT pg_reload_conf();
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
- Suchen Sie die Datei
postgresql.confim Datenverzeichnis Ihrer Datenbank ($PGDATA). Legen Sie die folgende Zeile fest:
omni_enable_telemetry = on
Starten Sie Ihren AlloyDB Omni-Container neu, damit die Änderung übernommen wird.
Telemetrie-Flag zur Laufzeit mit ALTER SYSTEM festlegen
- Stellen Sie mit
psqleine Verbindung zu Ihrer AlloyDB Omni-Instanz her. Führen Sie dazu diesen Befehl aus:
ALTER SYSTEM SET omni_enable_telemetry = 'on';
Starten Sie Ihren AlloyDB Omni-Container neu, damit die Änderung übernommen wird.
docker restart CONTAINER_NAME
Ersetzen Sie Folgendes:
CONTAINER_NAME: Der Name Ihres AlloyDB Omni-Containers, z. B.my-omni-1.
AlloyDB Omni-Telemetriestatus prüfen
Sie können den Status des AlloyDB Omni-Telemetrie-Agents prüfen, einschließlich der Frage, ob er aktiviert ist oder 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:
- Verbindung zur Instanz herstellen
- Führen Sie den folgenden Befehl aus:
SHOW omni_enable_telemetry;
In der Ausgabe wird on oder off zurückgegeben, 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.
Telemetrie-Agent-Aktivität 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.
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
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: Name Ihres AlloyDB Omni-Containers, z. B.my-omni-1.
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.