Installer l'UI Web

Sélectionnez une version de la documentation :

Cette page explique comment installer l'interface utilisateur Web AlloyDB Omni afin de pouvoir surveiller l'état et la configuration de vos clusters de bases de données autogérés. L'interface utilisateur Web offre les fonctionnalités suivantes :

Fonctionnalité Description Conteneurs (autonomes) Kubernetes RPM (Linux) Outil d'orchestration RPM
Sélection des clusters Un écran de connectivité qui vous permet d'établir, d'enregistrer et de sauvegarder des identifiants de connexion pour accéder aux clusters cibles. Compatible Compatible Compatible Compatible
Aperçu du cluster Tableau de bord d'observation affichant toutes les instances de cluster actives et les graphiques de télémétrie. Compatible Compatible Compatible Compatible
Bases de données Page de présentation affichant les tables du catalogue et les tailles des bases de données sur le cluster. Compatible Compatible Compatible Compatible
Moteur de données en colonnes Paramètres de configuration et statistiques d'exécution d'analyse pour les requêtes analytiques. Compatible Compatible Compatible Compatible
Indicateurs de base de données Tableau d'observation affichant les options actives et les configurations qui s'écartent des paramètres par défaut. Compatible Compatible Compatible Compatible
Insights sur les requêtes Tableaux de bord de télémétrie et de performances des requêtes affichant des histogrammes structurels et des listes de requêtes lentes. Compatible Compatible Compatible Compatible
Insights sur le système Graphiques de télémétrie affichant la consommation de CPU, l'espace mémoire utilisé et les E/S de disque. Non compatible (conteneur autonome uniquement) Compatible Compatible Compatible

Avant de commencer

Avant d'installer l'interface utilisateur Web, assurez-vous d'effectuer les opérations suivantes :

  1. Obtenez les images de votre déploiement, puis téléchargez et installez AlloyDB Omni pour pouvoir utiliser l'interface utilisateur Web : Installer AlloyDB Omni à l'aide de RPM.

  2. Configurez l'utilisateur de la base de données.

    L'UI Web s'appuie sur un compte utilisateur limité, qui dispose du rôle pg_monitor pour accéder à la base de données. Configurez cet utilisateur sur chaque cluster en exécutant les commandes suivantes dans une session psql :

    CREATE ROLE alloydbui WITH LOGIN PASSWORD 'PASSWORD';
GRANT pg_monitor TO alloydbui WITH INHERIT TRUE;

  3. Configurez l'agent de surveillance AlloyDB Omni.

    Lorsque vous exécutez AlloyDB Omni à l'aide de RPM, l'agent de surveillance alloydbomni_monitor est disponible sous la forme d'un package RPM distinct dans le même dépôt. Pour en savoir plus, consultez Installer et démarrer le moniteur AlloyDB Omni, Configurer le moniteur AlloyDB Omni et Vérifier le moniteur AlloyDB Omni.

    Si votre installation utilise un répertoire de données personnalisé (PG_DATA_DIR), configurez /etc/systemd/system/alloydbomni_monitor.service.d/override.conf et redémarrez le service de surveillance :

    sudo mkdir -p /etc/systemd/system/alloydbomni_monitor.service.d
sudo tee /etc/systemd/system/alloydbomni_monitor.service.d/override.conf <<'EOF'
[Service]
Environment="PG_DATA_DIR=PG_DATA_DIR"
EOF
sudo systemctl daemon-reload
sudo systemctl restart alloydbomni_monitor

    Remplacez PG_DATA_DIR par le chemin d'accès au répertoire de données de votre base de données (par exemple, /var/lib/postgresql/18/data ou /data).

    Pour vérifier que l'agent de surveillance est actif et exporte des métriques, exécutez sudo systemctl status alloydbomni_monitor et curl http://localhost:9187/metrics.

    sudo mkdir -p /etc/systemd/system/alloydbomni18.service.d
sudo tee /etc/systemd/system/alloydbomni18.service.d/override.conf <<'EOF'
[Service]
CPUQuota=100%
MemoryMax=100%
IOAccounting=yes
EOF
sudo systemctl daemon-reload
sudo systemctl restart alloydbomni18

  4. Configurer Prometheus

    Pour afficher les données des graphiques sur les pages Présentation et Insights sur le système, y compris l'utilisation du processeur, installez et configurez Prometheus. Suivez les instructions d'installation et de configuration de la section Choisir et installer des outils de surveillance.

Étapes facultatives

Pour activer des fonctionnalités supplémentaires de l'UI Web :

  • Configuration des insights sur les requêtes

    Pour utiliser la fonctionnalité d'insights sur les requêtes, activez l'extension pg_stat_statements. Dans une session psql, exécutez les commandes suivantes pour configurer les bibliothèques :

    ALTER SYSTEM SET shared_preload_libraries=google_columnar_engine,google_job_scheduler,google_storage,google_db_advisor,pg_stat_statements;
ALTER SYSTEM SET pg_stat_statements.max = 10000;
ALTER SYSTEM SET pg_stat_statements.track_utility = on;
ALTER SYSTEM SET track_io_timing = on;

    Ensuite, exécutez la commande suivante dans chaque base de données individuellement pour créer l'extension :

    CREATE EXTENSION IF NOT EXISTS pg_stat_statements;

    Redémarrez la base de données pour que ces modifications soient prises en compte. Si vous prévoyez d'activer le moteur de données en colonnes, attendez que la configuration soit terminée avant de redémarrer.

  • Configuration du moteur de données en colonnes

    Pour accéder aux données du moteur de données en colonnes dans l'interface utilisateur Web, configurez le moteur comme décrit dans Présentation du moteur de données en colonnes.

  • Configuration d'AlloyDB AI

    Pour utiliser les fonctionnalités d'AlloyDB AI dans l'interface utilisateur Web, accordez les autorisations suivantes :

    • Pour renseigner les index vectoriels, accordez à l'utilisateur alloydbui l'autorisation SELECT sur pg_stat_ann_indexes.
    • Pour afficher les colonnes vectorielles, accordez à l'utilisateur alloydbui l'autorisation SELECT sur une table.
Pour en savoir plus, consultez Créer des applications d'IA générative à l'aide d'AlloyDB AI.

Installer l'UI Web

Vous pouvez installer et exécuter l'UI Web sur n'importe quel nœud. L'UI Web ne nécessite pas de nœud dédié. L'installation complète nécessite environ 250 Mo d'espace disque. Une fois que vous avez obtenu les images pour votre déploiement et téléchargé AlloyDB Omni, vous pouvez installer et exécuter l'UI Web.

Installer à l'aide de RPM

Google signe les packages RPM AlloyDB Omni avec la clé de signature de package Linux. Pour configurer le dépôt YUM avec la validation de la signature GPG et installer le package RPM de l'UI Web, procédez comme suit :

  1. Configurez le dépôt YUM dans votre répertoire local :

    sudo tee -a /etc/yum.repos.d/alloydbomni_ui.repo << EOF
[alloydbomni_ui]
name=alloydbomni_ui
baseurl=ALLOYDB_OMNI_COMMON_REPOSITORY_URL
enabled=1
repo_gpgcheck=1
gpgcheck=1
gpgkey=https://dl.google.com/linux/linux_signing_key.pub
EOF

    sudo yum makecache

    Remplacez ALLOYDB_OMNI_COMMON_REPOSITORY_URL par l'URL du dépôt commun AlloyDB Omni.

  2. Installez le package RPM de l'UI Web :

    sudo dnf install alloydbomni_ui

Démarrer l'UI Web

L'UI Web utilise un keystore Java pour protéger la clé AES 256 bits utilisée pour chiffrer les données de connexion. Lorsque vous démarrez l'UI Web, spécifiez une variable d'environnement contenant le mot de passe.

Démarrer l'UI Web sous Linux

export ALLOYDB_OMNI_UI_KEYSTORE="PASSWORD"
/opt/alloydbomni/app/alloydb-ui/app/bin/alloydb

Ouvrir l'interface utilisateur Web

Pour afficher l'UI Web, ouvrez un navigateur à l'adresse http://HOST:9080.

Remplacez HOST par le nom d'hôte ou l'adresse IP du nœud sur lequel l'UI Web est installée.

  • Si vous avez configuré un chemin d'accès de base personnalisé à l'aide de la variable d'environnement facultative ALLOYDB_OMNI_BASE_PATH (par exemple, lors de l'hébergement derrière un proxy inverse existant), vous devez ajouter le chemin d'accès à l'URL : http://HOST:9080/BASE_PATH.

  • Vous pouvez configurer le chemin de base sans barre oblique de début, par exemple ALLOYDB_OMNI_BASE_PATH=PATH. Toutes les alternatives suivantes sont valides :

    • /test/
    • test/
    • test
    • /test

Limites

L'UI Web présente les limites suivantes :

  • Les graphiques de présentation et les insights système ne sont pas disponibles lorsque vous vous connectez à des déploiements de conteneurs autonomes AlloyDB Omni, car aucun agent de surveillance conteneurisé n'est disponible pour les déploiements de conteneurs autonomes. Toutes les autres fonctionnalités et métriques non graphiques restent entièrement fonctionnelles.

  • Pour afficher les données du moteur de données en colonnes pour une table donnée, l'utilisateur alloydbui doit disposer d'au moins une autorisation sur cette table, par exemple SELECT.

  • Pour afficher les données d'index vectoriel, l'utilisateur alloydbui doit disposer de l'autorisation SELECT sur pg_stat_ann_indexes.

  • Pour afficher les données de colonne vectorielle d'une table donnée, l'utilisateur alloydbui doit disposer de l'autorisation SELECT sur cette table.

Bonnes pratiques et mises en garde

Suivez ces bonnes pratiques et mises en garde lorsque vous installez et configurez l'UI Web :

  • Protection par mot de passe du keystore : l'UI Web génère un keystore Java pour protéger la clé de chiffrement de base de données AES 256 bits. Utilisez une phrase secrète sécurisée pour ALLOYDB_OMNI_UI_KEYSTORE. Des erreurs de déchiffrement se produisent si vous transférez vos fichiers de configuration et que vous vous connectez avec un mot de passe de keystore non concordant.
  • Récupération des métriques Prometheus : configurez les récupérateurs pour interroger les instances cibles à des intervalles standards (15 à 30 secondes) afin d'interroger les statistiques sans surcharger les nœuds de base de données.

Étapes suivantes