Utiliser la console Omni Spanner

Spanner Omni inclut la console Spanner Omni, qui affiche l'état et d'autres informations importantes sur vos déploiements.

Démarrer la console Spanner Omni

Téléchargez la console Spanner Omni pour exécuter une seule instance pour l'ensemble de votre déploiement. Pour en savoir plus, consultez Télécharger Spanner Omni.

Utiliser la console Spanner Omni avec des déploiements sur un seul serveur

Pour démarrer la console Spanner Omni avec un déploiement sur un seul serveur :

1. Suivez les étapes de la section Configurer Spanner Omni.

2. Exécutez la commande start-single-server pour démarrer le serveur Spanner.

3. Démarrez la console Spanner Omni. Si vous utilisez des conteneurs, exécutez la commande suivante :

   docker exec -it spanneromni /google/spanner/bin/omni-jre/bin/java -jar /google/spanner/bin/spanner-console
   

   La console Spanner Omni utilise les mêmes options que la CLI Spanner Omni.

   • Pour exécuter avec TLS, utilisez :

     docker exec -it spanneromni /google/spanner/bin/omni-jre/bin/java -jar \
         /google/spanner/bin/spanner-console \
         --ca-certificate-file=PATH_TO_CA_FILE
     

   • Pour exécuter avec mTLS, utilisez :

     docker exec -it spanneromni /google/spanner/bin/omni-jre/bin/java -jar \
         /google/spanner/bin/spanner-console \
         --ca-certificate-file=PATH_TO_CA_FILE \
         --client-certificate-directory=PATH_TO_CLIENT_CERT_DIR
     

   Remplacez les éléments suivants :

   • PATH_TO_CA_FILE : chemin d'accès au fichier de certificat de l'autorité de certification (CA).
   • PATH_TO_CLIENT_CERT_DIR : chemin d'accès au répertoire du certificat client.

4. Dans votre navigateur, accédez à http://localhost:15026 pour accéder à la console Spanner Omni.

Utiliser la console Spanner Omni avec des déploiements zonaux, régionaux et multiclusters

Pour les déploiements basés sur Kubernetes, la console Spanner Omni est déployée lorsque vous créez un déploiement. Pour accéder à la console Spanner Omni, accédez à http://HOST_ADDRESS:15026 dans votre navigateur.

Remplacez HOST_ADDRESS par le EXTERNAL_IP de spanner-omni-console qui se trouve dans le résultat de la commande suivante :

kubectl get svc -n spanner-ns

Fonctionnalités de la console Spanner Omni

La console Spanner Omni comprend plusieurs pages qui fournissent des insights sur votre déploiement.

Présentation

La page Vue d'ensemble est le tableau de bord central de votre déploiement Spanner Omni. Il fournit les informations générales suivantes sur l'état, l'état et l'utilisation des ressources de vos nœuds Spanner :

Informations sur le déploiement

Cette section liste les détails de votre déploiement :

• ID de déploiement : identifiant unique de votre déploiement Spanner Omni actuel. Vous spécifiez cet ID lorsque vous créez le déploiement.

• Version de la base de données : version spécifique du logiciel Spanner Omni que vous exécutez (par exemple, 2026.r4-lts.1).

• Édition : édition de la licence Spanner Omni installée sur le déploiement.

• Type de licence : type de licence installé sur le déploiement. Pour en savoir plus sur les éditions et les types de licences Spanner Omni, consultez la présentation des éditions Spanner Omni.

• Expiration de la licence : date d'expiration de la licence du déploiement.

Configuration du déploiement

• Utilisation du processeur : graphique en temps réel qui montre la charge de traitement de votre déploiement. Vous pouvez basculer entre Zone et Serveur pour afficher l'utilisation.

• Tableau des ressources : fournit une vue détaillée des composants de votre déploiement avec les informations suivantes. Les serveurs sont regroupés par zone.

  Colonne	Description
  Nom de la ressource	Nom de la zone ou du nœud de serveur Spanner Omni spécifique.
  Type	Zone : indique le type de zone (par exemple, lecture-écriture, lecture seule ou témoin). Serveur Spanner Omni : nœuds individuels exécutant le service Spanner Omni. La console Spanner Omni identifie spécifiquement les serveurs racine.
  État	Indique si la ressource est opérationnelle (par exemple, Ready).
  Emplacement	Région physique ou logique qui héberge la zone (par exemple, us-central1).
  vCPU, mémoire, stockage utilisé	L'allocation et l'utilisation actuelles des ressources pour chaque nœud et chaque zone.

Bases de données

La page Bases de données fournit une vue centralisée de toutes les bases de données de votre déploiement Spanner Omni. Le tableau de cette page comprend les informations suivantes :

Colonne	Description
Nom de la base de données	Identifiant unique de votre base de données (par exemple, retail, ycsbdb).
Dialecte	Le dialecte SQL compatible avec la base de données : GOOGLE_STANDARD_SQL : dialecte par défaut, offrant une compatibilité complète avec les fonctionnalités Spanner. POSTGRESQL : interface compatible avec PostgreSQL.
Utilisation du processeur	Pourcentage de ressources de processeur consommées par la base de données. Cela vous aide à identifier les bases de données à charge élevée.
Tables	Nombre total de tables définies par l'utilisateur dans la base de données.
Durée de conservation de la version	Durée pendant laquelle Spanner Omni conserve les données historiques pour la récupération à un moment précis (par exemple, 1h).

Sauvegardes

La page Sauvegardes fournit une vue complète de toutes les sauvegardes associées à votre déploiement Spanner Omni. Les sauvegardes sont des instantanés transactionnellement et extérieurement cohérents de votre base de données que Spanner Omni stocke dans des solutions de stockage externes.

Pour en savoir plus, consultez Sauvegardes Spanner Omni.

Espace de stockage total de la sauvegarde

La section Espace de stockage total des sauvegardes affiche la taille cumulée de toutes les sauvegardes que vous stockez dans votre espace de stockage externe (par exemple, Amazon Simple Storage Service (Amazon S3), Cloud Storage ou un espace de stockage local compatible avec Amazon S3).

Tableau des sauvegardes

Le tableau des sauvegardes affiche les informations suivantes pour chaque sauvegarde :

Colonne	Description
Nom de la sauvegarde	Identifiant unique de la sauvegarde.
Base de données source	Nom de la base de données à partir de laquelle la console Spanner Omni a créé la sauvegarde.
État	État actuel de la sauvegarde. Voici les états courants : Prêt : la sauvegarde est terminée et disponible pour la restauration. Création : la sauvegarde est en cours. Expiration imminente : la sauvegarde approche de la date d'expiration spécifiée par l'utilisateur.
Taille de la sauvegarde	Taille des données de sauvegarde dans l'espace de stockage.
Date et heure de création	Code temporel auquel le serveur Spanner Omni a lancé le processus de sauvegarde.
Heure de l'instantané (ou date/heure de la révision)	Moment représenté par la sauvegarde. Toutes les données de la sauvegarde sont un instantané cohérent de la base de données à ce moment-là.
Date/Heure d'expiration	Date et heure auxquelles Spanner Omni supprime la sauvegarde.

Insights sur le système

La page Insights système fournit une observabilité précise de votre déploiement Spanner Omni, ce qui vous permet de surveiller l'état du système, d'analyser les performances et de déboguer les problèmes.

Vous pouvez personnaliser les données affichées sur le tableau de bord à l'aide des filtres suivants :

• Zones : filtrez les métriques pour des zones de déploiement spécifiques.

• Serveurs : affichez le détail des nœuds de serveur individuels.

• Bases de données : affichez les métriques d'une base de données spécifique ou de l'ensemble du déploiement.

• Période : sélectionnez une période d'analyse comprise entre une heure et sept jours.

Utilisation du processeur

Cette section surveille la charge de traitement de votre déploiement. Vous pouvez regrouper cette métrique par :

• Zone : identifiez les déséquilibres de charge entre les emplacements physiques.

• Priorité : découvrez comment les ressources sont réparties entre les tâches de priorité élevée, moyenne et faible.

• Type d'opération : répartissez l'utilisation par tâches lancées par l'utilisateur, telles que les lectures, les écritures et les commits.

Latence

Cette section suit la vitesse de vos opérations :

• Latence des requêtes : temps nécessaire pour les requêtes API individuelles.

• Latence des transactions : durée totale des transactions de base de données complètes.

• Centiles : par exemple, affichez cette valeur au 50e centile (P50) pour les performances médianes. Toutefois, le dépannage nécessite souvent de vérifier P90 ou P99.

Débit et opérations

Cette section vous présente les informations suivantes :

• Débit : volume de données que le système lit ou écrit dans le déploiement (mesuré en octets par seconde).

• Opérations par seconde : nombre total d'appels d'API traités par le système.

Temps d'attente pour le verrouillage

Cette métrique mesure le temps cumulé que les transactions passent à attendre des verrous. Les pics de cette métrique, en particulier lorsqu'ils sont associés à une latence élevée et à une utilisation normale du processeur, indiquent souvent un conflit de verrouillage.

Métriques de stockage

• Capacité de stockage : espace de stockage total et disponible sur le système de fichiers sous-jacent, que la console Spanner Omni regroupe par zone.

• Utilisation du stockage : nombre d'octets utilisés par vos bases de données. Le processus de compactage des données Spanner Omni peut entraîner des fluctuations temporaires de ces chiffres.

Performances du système de fichiers

Cette section fournit des insights sur les performances de la couche de stockage sous-jacente (SpanhostFS) :

• Latence du système de fichiers : temps nécessaire aux opérations d'E/S de bas niveau (lecture, écriture et vidage).

• Débit du système de fichiers : taux de transfert de données au niveau du système de fichiers.

Insights sur les requêtes

La page Insights sur les requêtes vous aide à détecter et à diagnostiquer les problèmes de performances de vos requêtes SQL et de vos instructions LMD (INSERT, UPDATE et DELETE). Utilisez Insights sur les requêtes pour identifier les requêtes inefficaces qui peuvent contribuer à une utilisation élevée du processeur.

• Détection : déterminez si vos requêtes sont la cause principale de la charge du processeur de votre déploiement.

• Identification : identifiez les requêtes spécifiques ou les tags de requête d'application qui consomment le plus de ressources.

• Analyse : utilisez des métriques précises telles que la latence et le nombre de lignes pour comprendre pourquoi une requête peut être lente.

Charge de la base de données par temps d'exécution (toutes les requêtes)

Charge de la base de données par temps d'exécution affiche l'utilisation globale du processeur pour toutes les requêtes au fil du temps. Pour afficher la charge d'une base de données spécifique, utilisez un filtre de base de données.

N premiers tags et requêtes

Cette section fournit une vue en série temporelle des requêtes ou des tags qui entraînent la plus forte charge de base de données au cours de la période sélectionnée.

Tableau des requêtes et des tags les plus fréquents

Le tableau liste les requêtes et les tags les plus consommateurs. Vous pouvez l'utiliser pour identifier les requêtes qui consomment le plus de ressources dans votre charge de travail de requêtes.

Colonne	Description
Empreinte numérique	Identifiant unique d'une "forme" de requête spécifique.
Requête ou tag de requête	Texte SQL normalisé de la requête. Si votre application fournit un tag de requête dans les options de requête, la console Spanner Omni affiche ce tag à la place, ce qui vous permet de regrouper les requêtes associées (par exemple, checkout_process).
Type de requête	Type d'opération (par exemple, QUERY).
CPU (%)	Pourcentage des ressources de processeur de base de données totales consommées par cette requête pendant l'intervalle.
Nombre d'exécutions	Nombre total de fois où la console Spanner Omni a exécuté la requête.
Latence moy. (ms)	Temps moyen nécessaire pour exécuter la requête, y compris le temps réseau entre les serveurs.
Lignes analysées en moyenne	Nombre moyen de lignes lues par Spanner Omni pour traiter la requête. Des ratios élevés d'éléments analysés par rapport aux éléments renvoyés indiquent souvent des index manquants ou inefficaces.
Moy. des lignes renvoyées	Nombre moyen de lignes que la console Spanner Omni renvoie à votre application.
Octets renvoyés	Quantité moyenne de données renvoyées par la console Spanner Omni par exécution.