Cette page explique comment personnaliser votre installation AlloyDB Omni, qui est compatible avec différentes formes de personnalisation. Cette page présente quelques personnalisations courantes.
Activer et désactiver la télémétrie AlloyDB Omni
La télémétrie AlloyDB Omni implémente un agent client léger qui collecte un ensemble de métriques pseudonymisées de base et les envoie à un point de terminaison géré par Google.
Étant donné qu'AlloyDB Omni est un produit téléchargeable proposé sans frais, cette télémétrie fournit à Google des métriques essentielles non personnellement identifiables (non-PII) concernant les environnements d'adoption et de déploiement génériques des instances en cours d'exécution. Ces données nous aident à développer nos produits et à prioriser l'assistance.
Voici les métriques collectées :
- ID d'installation unique (UUID pseudonymisé)
- Version d'AlloyDB Omni et version majeure de PostgreSQL
- Informations sur le système hôte, comme le nombre de processeurs, la RAM et la disponibilité
Désactiver les rapports de télémétrie
Pour empêcher l'agent de télémétrie de s'exécuter et de générer des rapports sur les métriques d'utilisation, définissez le paramètre de configuration PostgreSQL omni_enable_telemetry sur off. Vous pouvez désactiver l'agent de télémétrie en définissant l'indicateur de télémétrie dans le fichier postgresql.conf ou en définissant l'indicateur au moment de l'exécution à l'aide de ALTER SYSTEM.
Définir l'indicateur de télémétrie dans le fichier postgresql.conf
Pour modifier le fichier de configuration PostgreSQL, procédez comme suit :
- Recherchez le fichier
postgresql.confdans le répertoire de données de votre base de données. Par défaut, il s'agit de la valeur/var/lib/postgresql/MAJOR_VERSION/data. Désactivez la télémétrie AlloyDB Omni.
omni_enable_telemetry = off
Pour appliquer la modification, redémarrez le service AlloyDB Omni. L'agent de télémétrie cesse de collecter et d'envoyer des métriques d'utilisation à Google.
systemctl restart alloydbomniMAJOR_VERSION
Définir l'indicateur de télémétrie au moment de l'exécution à l'aide de ALTER SYSTEM
Pour définir l'indicateur de télémétrie et conserver la modification après les redémarrages, procédez comme suit :
Connectez-vous à votre instance AlloyDB Omni à l'aide de
psql:/usr/lib/postgresql/18/bin/psql -h localhost -U postgres
Exécutez la commande suivante :
ALTER SYSTEM SET omni_enable_telemetry = 'off';
Redémarrez le service de base de données pour vous assurer que la modification est entièrement prise en compte par le nœud de calcul en arrière-plan.
systemctl restart alloydbomni18
L'agent de télémétrie cesse de collecter et d'envoyer des métriques d'utilisation à Google.
Activer les rapports de télémétrie
Si vous avez précédemment désactivé la télémétrie AlloyDB Omni, vous pouvez la réactiver en définissant le flag omni_enable_telemetry sur on. Vous pouvez activer l'agent de télémétrie en définissant l'indicateur dans le fichier postgresql.conf ou en définissant l'indicateur au moment de l'exécution à l'aide de ALTER SYSTEM.
Définir l'indicateur de télémétrie dans le fichier postgresql.conf
- Recherchez le fichier
postgresql.confdans le répertoire de données de votre base de données. Définissez la ligne suivante :
omni_enable_telemetry = on
Pour appliquer la modification, redémarrez le service AlloyDB Omni.
systemctl restart alloydbomni18
Définir l'indicateur de télémétrie au moment de l'exécution à l'aide de ALTER SYSTEM
- Connectez-vous à votre instance AlloyDB Omni à l'aide de
psql. Exécutez la commande suivante :
ALTER SYSTEM SET omni_enable_telemetry = 'on';
Pour appliquer la modification, redémarrez le service AlloyDB Omni.
systemctl restart alloydbomni18
Vérifier l'état de la télémétrie AlloyDB Omni
Vous pouvez vérifier l'état de l'agent de télémétrie AlloyDB Omni, y compris s'il est activé ou désactivé. Vous pouvez également vérifier l'activité de l'agent de télémétrie.
Vérifier si l'agent de télémétrie est activé ou désactivé
Pour vérifier l'état du paramètre de télémétrie, procédez comme suit :
- Vous connecter à votre instance
- Exécutez la commande suivante :
SHOW omni_enable_telemetry;
Le résultat renvoie on ou off, selon que vous avez désactivé ou activé la télémétrie AlloyDB Omni.
Vérifier si l'agent de télémétrie est en cours d'exécution
Pour vérifier si l'agent de télémétrie est en cours d'exécution, exécutez la commande suivante sur l'hôte :
ps -ef | grep "omni telemetry worker"
Si la télémétrie est activée et en cours d'exécution, le résultat contient une ligne avec le texte postgres: omni telemetry worker.
Vérifier l'activité de l'agent de télémétrie
Pour vérifier l'activité de l'agent de télémétrie, exécutez la commande suivante sur l'hôte :
journalctl -u alloydbomni18 | grep telemetry
Si l'agent de télémétrie est en cours d'exécution, les journaux contiennent des messages semblables à ceux-ci :
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.
Se connecter à l'instance
Selon votre environnement, vous pouvez vous connecter à votre instance AlloyDB Omni localement ou à distance.
Touchez les clients à proximité
Pour vous connecter localement à votre instance AlloyDB Omni, exécutez la commande suivante :/usr/lib/postgresql/18/bin/psql -U postgres -p HOST_PORT -h localhost
Se connecter à distance
/usr/lib/postgresql/18/bin/psql -U postgres -p HOST_PORT -h IP_ADDRESS_OR_FQDN
Remplacez les variables suivantes :
HOST_PORT: port TCP que vous avez utilisé lors de l'installation.IP_ADDRESS_OR_FQDN: adresse IP ou nom de domaine complet de l'hôte sur lequel AlloyDB Omni est exécuté.
Activer les extensions
La liste des extensions disponibles dans AlloyDB Omni est disponible dans Extensions de base de données compatibles. Bien que PostGIS et Orafce ne soient pas inclus dans AlloyDB Omni, vous pouvez les installer en suivant les instructions suivantes :
Les extensions installées sont activées à l'aide d'instructions CREATE EXTENSION PostgreSQL standards, comme indiqué dans Activer une extension.