Personnaliser votre installation AlloyDB Omni

Sélectionnez une version de la documentation :

Cette page explique comment personnaliser votre installation AlloyDB Omni, qui accepte différentes formes de personnalisation. Vous trouverez ci-dessous 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 ne s'exécute que dans l'image de conteneur AlloyDB Omni. Cet agent collecte périodiquement un ensemble de métriques de base pseudonymisées et les envoie à un point de terminaison géré par Google.

AlloyDB Omni étant 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'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 dans le répertoire de données persistant de votre conteneur, procédez comme suit :

  1. Recherchez le fichier postgresql.conf dans le répertoire de données de votre base de données ($PGDATA).

  2. Désactivez la télémétrie AlloyDB Omni.

    omni_enable_telemetry = off

  3. Pour appliquer la modification, redémarrez votre conteneur AlloyDB Omni. L'agent de télémétrie cesse de collecter et d'envoyer des métriques d'utilisation à Google.

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 lors des redémarrages, procédez comme suit :

  1. Connectez-vous à votre instance AlloyDB Omni à l'aide de psql :

    psql -h HOST -U USER -d DATABASE

    Effectuez les remplacements suivants :

    • HOST: nom d'hôte ou adresse IP de votre instance AlloyDB Omni (par exemple, 127.0.0.1).
    • USER: utilisateur de la base de données auquel vous souhaitez vous connecter (par exemple, postgres).
    • DATABASE: base de données à laquelle vous souhaitez vous connecter (par exemple, postgres).

  2. Exécutez la commande suivante :

    ALTER SYSTEM SET omni_enable_telemetry = 'off';

  3. Rechargez la configuration ou redémarrez l'instance. Dans certaines configurations de conteneur, vous devrez peut-être redémarrer votre instance pour vous assurer que la modification est entièrement prise en compte par le processus d'arrière-plan.

    SELECT pg_reload_conf();

    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'indicateur 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

  1. Recherchez le fichier postgresql.conf dans le répertoire de données de votre base de données ($PGDATA).

  2. Définissez la ligne suivante :

    omni_enable_telemetry = on

  3. Pour appliquer la modification, redémarrez votre conteneur AlloyDB Omni.

Définir l'indicateur de télémétrie au moment de l'exécution à l'aide de ALTER SYSTEM

  1. Connectez-vous à votre instance AlloyDB Omni à l'aide de psql.

  2. Exécutez la commande suivante :

    ALTER SYSTEM SET omni_enable_telemetry = 'on';

  3. Pour appliquer la modification, redémarrez votre conteneur AlloyDB Omni.

    docker restart CONTAINER_NAME

    Effectuez le remplacement suivant :

    • CONTAINER_NAME: nom de votre conteneur AlloyDB Omni (par exemple, my-omni-1).

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 en cours d'exécution. 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 :

  1. Vous connecter à votre instance
  2. 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 du conteneur :

docker top CONTAINER_NAME

Effectuez le remplacement suivant :

  • CONTAINER_NAME: nom de votre conteneur AlloyDB Omni (par exemple, my-omni-1).

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 du conteneur :

docker logs CONTAINER_NAME 2>&1 | grep telemetry

Effectuez le remplacement suivant :

  • CONTAINER_NAME: nom de votre conteneur AlloyDB Omni (par exemple, my-omni-1).

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é

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

Remplacez la variable suivante :

  • CONTAINER_NAME: nom de votre conteneur AlloyDB Omni (par exemple, my-omni-1).

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 des CREATE EXTENSION instructions PostgreSQL standards, comme décrit dans Activer une extension.