Cette page explique comment personnaliser votre installation AlloyDB Omni, qui prend en charge 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 de base pseudonymes 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 personnelles concernant l'adoption générique et les environnements de déploiement des instances en cours d'exécution. Ces données permettent d'orienter le développement des produits et la priorisation de l'assistance.
Les métriques collectées incluent les éléments suivants :
- ID d'installation unique (UUID pseudonymisé)
- Version d'AlloyDB Omni et version majeure de PostgreSQL
- Informations sur le système hôte, telles que le nombre de processeurs, la RAM et la durée de fonctionnement
Désactiver la génération de rapports sur la 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'option de télémétrie dans le fichier postgresql.conf ou en définissant l'option au moment de l'exécution à l'aide de ALTER SYSTEM.
Définir l'option 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/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'option de télémétrie au moment de l'exécution à l'aide de ALTER SYSTEM
Pour définir l'option de télémétrie et conserver la modification lors des 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 processus 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 la génération de rapports sur la 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 l'option omni_enable_telemetry sur on. Vous activez l'agent de télémétrie en définissant l'option dans le fichier postgresql.conf ou en définissant l'option au moment de l'exécution à l'aide de ALTER SYSTEM.
Définir l'option 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'option 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 aux suivants :
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 ci-dessous :
Les extensions installées sont activées à l'aide d'instructions CREATE EXTENSION
PostgreSQL standard, comme décrit dans
Activer une extension.