Analyser les performances des requêtes

Cette page explique comment utiliser le tableau de bord d'Insights sur les requêtes pour détecter et analyser les problèmes de performances de Spanner.

Remarque : Les graphiques de séries temporelles du tableau de bord d'Insights sur les requêtes affichent les données sous forme de taux moyens par minute.

Présentation d'Insights sur les requêtes

Insights sur les requêtes vous aide à détecter et à diagnostiquer les problèmes de performances des requêtes et des instructions LMD (INSERT, UPDATE, et DELETE) pour une base de données Spanner. Il offre un système de surveillance intuitif et fournit des informations de diagnostic qui vous aident à identifier la principale cause des problèmes de performances.

Insights sur les requêtes vous aide à améliorer les performances des requêtes Spanner en suivant les étapes ci-dessous :

1. Déterminez si des requêtes inefficaces entraînent une utilisation élevée du processeur.
2. Identifiez une requête ou un tag potentiellement problématique.
3. Analysez la requête ou le tag de requête pour identifier les problèmes.

Insights sur les requêtes est disponible dans les configurations régionales et multirégionales.

Tarifs

Insights sur les requêtes n'entraîne aucun coût supplémentaire.

Conservation des données

Insights sur les requêtes conserve les données pendant 30 jours maximum. Pour le graphique Utilisation totale du processeur (par requête ou tag de requête), Spanner récupère les données des tables SPANNER_SYS.QUERY_STATS_TOP_*. Ces tables ont une durée de conservation maximale de 30 jours. Pour en savoir plus, consultez Conservation des données.

Rôles requis

Vous avez besoin de différents rôles et autorisations IAM selon que vous êtes un utilisateur IAM ou un utilisateur du contrôle des accès ultraprécis.

Utilisateur Identity and Access Management (IAM)

Pour obtenir les autorisations nécessaires pour afficher la page Insights sur les requêtes, demandez à votre administrateur de vous accorder les rôles IAM suivants sur l'instance :

• Lecteur Cloud Spanner (roles/spanner.viewer)
• Lecteur de bases de données Cloud Spanner (roles/spanner.databaseReader)

Les autorisations suivantes du rôle Lecteur de bases de données Cloud Spanner(roles/spanner.databaseReader) sont requises pour afficher la page Insights sur les requêtes :

• spanner.databases.beginReadOnlyTransaction
• spanner.databases.select
• spanner.sessions.create

Utilisateur du contrôle des accès ultraprécis

Si vous utilisez le contrôle des accès ultraprécis, vérifiez que :

• vous disposez du rôle Lecteur Cloud Spanner(roles/spanner.viewer)
• vous disposez de privilèges de contrôle des accès ultraprécis et que le rôle système spanner_sys_reader ou l'un de ses rôles membres vous est attribué ;
• Sélectionnez spanner_sys_reader ou un rôle membre comme rôle système actuel sur la page de présentation de la base de données.

Remarque : Si vous disposez déjà d'une autorisation IAM au niveau de la base de données, telle que spanner.databases.select, la Google Cloud console suppose que vous êtes un utilisateur IAM. Vous ne pouvez pas sélectionner le spanner_sys_reader ni un rôle membre sur la page de présentation de la base de données en tant qu'utilisateur IAM.

Pour en savoir plus, consultez À propos du contrôle des accès ultraprécis et Rôles système pour le contrôle des accès ultraprécis.

Tableau de bord d'Insights sur les requêtes

Le tableau de bord d'Insights sur les requêtes affiche la charge de la requête en fonction de la base de données et de la période que vous sélectionnez. La charge de la requête correspond au calcul de l'utilisation totale du processeur pour toutes les requêtes de l'instance au cours de la période sélectionnée. Le tableau de bord fournit une série de filtres qui vous aident à afficher la charge des requêtes.

Pour afficher le tableau de bord d'Insights sur les requêtes pour une base de données, procédez comme suit :

1. Sélectionnez Insights sur les requêtes dans le panneau de navigation de gauche. Le tableau de bord d'Insights sur les requêtes s'ouvre.
2. Sélectionnez une base de données dans la liste Bases de données. Le tableau de bord affiche les informations sur la charge des requêtes pour la base de données.

Le tableau de bord comprend les sections suivantes :

1. Liste des bases de données : permet de filtrer la charge des requêtes sur une base de données spécifique ou sur toutes les bases de données.
2. Filtre de période : permet de filtrer la charge des requêtes par période, par exemple par heure, par jour ou selon une plage personnalisée.
3. Graphique Utilisation totale du processeur (toutes les requêtes) : affiche le taux moyen agrégé d'utilisation du processeur (en secondes de temps de processeur par minute) de toutes les requêtes.
4. Graphique Utilisation totale du processeur (par requête ou tag de requête) : affiche le taux moyen d'utilisation du processeur (en secondes de temps de processeur par minute) par requête ou tag de requête.
5. Tableau des N principales requêtes et des N principaux tags : affiche la liste des principales requêtes et des principaux tags de requête, triés par utilisation du processeur. Consultez Identifier une requête ou un tag potentiellement problématique.

Performances du tableau de bord

Utilisez des paramètres de requête ou ajoutez des tags à vos requêtes pour optimiser les performances d'Insights sur les requêtes. Si vous ne paramétrez pas vos requêtes ou si vous n'y ajoutez pas de tags, un trop grand nombre de résultats peut être renvoyé, ce qui peut empêcher le chargement correct du tableau des N principales requêtes et des N principaux tags.

Vérifier si des requêtes inefficaces sont responsables d'une utilisation élevée du processeur

L'utilisation totale du processeur est une mesure du taux moyen d'utilisation du processeur (en secondes de temps de processeur par minute) que les requêtes exécutées dans la base de données sélectionnée effectuent au fil du temps.

Examinez le graphique pour explorer les questions suivantes :

• Quelle base de données subit la charge ? Sélectionnez différentes bases de données dans la liste "Bases de données" pour trouver celles avec les charges les plus élevées. Pour déterminer quelle base de données présente la charge la plus élevée, vous pouvez également consulter le graphique Utilisation du processeur – Total pour les bases de données dans la Google Cloud console.

  

• L'utilisation du processeur est-elle élevée ? Le graphique a-t-il connu un pic ou augmenté au fil du temps ? Si vous ne constatez pas une utilisation élevée du processeur, le problème ne concerne pas vos requêtes.

• Depuis combien de temps l'utilisation du processeur est-elle élevée ? A-t-elle récemment connu un pic ou est-elle constamment élevée depuis un certain temps ? Utilisez le sélecteur de plage pour sélectionner différentes périodes afin de déterminer la durée du problème. Effectuez un zoom avant pour afficher une période pendant laquelle les pics de charge de requêtes sont observés. Effectuez un zoom arrière pour afficher jusqu'à une semaine de la chronologie.

Si vous constatez un pic ou une augmentation dans le graphique correspondant à l'utilisation globale du processeur de l'instance, cela est très probablement dû à une ou plusieurs requêtes coûteuses. Vous pouvez ensuite approfondir le processus de débogage en identifiant une requête ou un tag de requête potentiellement problématique.

Identifier une requête ou un tag de requête potentiellement problématique

Pour identifier une requête ou un tag de requête potentiellement problématique, observez la section des N principales requêtes :

Nous constatons ici que la requête avec l'empreinte 3216067328234137024 présente une utilisation élevée du processeur et peut être problématique.

Le tableau N principales requêtes fournit une présentation des requêtes qui utilisent le plus de processeur pendant la période choisie, triées de la plus élevée à la plus basse. Le nombre de N principales requêtes est limité à 100.

Pour les graphiques, nous récupérons les données du tableau des statistiques des N principales requêtes, qui comporte trois niveaux de granularité différents : 1 minute, 10 minutes et 1 heure. La valeur de chaque point de données des graphiques représente la valeur moyenne sur un intervalle d'une minute.

Nous vous recommandons d'ajouter des tags à vos requêtes SQL. L'ajout de tags aux requêtes vous aide à détecter les problèmes liés à des constructions de niveau supérieur, tels que la logique métier ou un microservice.

Le tableau affiche les propriétés suivantes :

• Empreinte : hachage du tag de requête ou, si le tag n'est pas présent, un hachage du texte de la requête.

• Requête ou tag de requête : si un tag est associé à la requête, le tag de requête s'affiche. Les statistiques de plusieurs requêtes ayant la même chaîne de tag sont regroupées sur une seule ligne avec la valeur REQUEST_TAG correspondant à la chaîne de tag. Pour en savoir plus sur l'utilisation des tags de requête, consultez Résoudre les problèmes liés aux tags de requête et aux tags de transaction.

  Si la requête n'a pas de tag associé, la requête SQL, tronquée à environ 64 Ko, s'affiche. Pour le traitement LMD par lots, les instructions SQL sont aplaties sur une seule ligne et concaténées à l'aide d'un point-virgule comme délimiteur. Les textes SQL identiques consécutifs sont dédupliqués avant d'être tronqués.

• Type de requête : indique si une requête est une PARTITIONED_QUERY ou une QUERY. Une PARTITIONED_QUERY est une requête avec un partitionToken obtenu à partir de l' API PartitionQuery. Toutes les autres requêtes et instructions LMD sont désignées par le type de requête QUERY.

• Utilisation du processeur : consommation des ressources du processeur par une requête, exprimée en pourcentage des ressources totales du processeur utilisées par toutes les requêtes exécutées sur les bases de données au cours de cet intervalle, affichée sur une barre horizontale dont la plage va de 0 à 100.

• Recommandation : Spanner analyse vos requêtes pour déterminer si elles peuvent bénéficier d'index améliorés. Si c'est le cas, il recommande des index nouveaux ou modifiés qui peuvent améliorer les performances des requêtes. Pour en savoir plus, consultez Utiliser le conseiller d'index Spanner.

• CPU (%) : consommation des ressources du processeur par une requête, exprimée en pourcentage des ressources totales du processeur utilisées par toutes les requêtes exécutées sur les bases de données au cours de cet intervalle.

• Nombre d'exécutions : taux moyen d'exécutions de requêtes, en exécutions par minute, que Spanner a constaté au cours de l'intervalle.

• Latence moyenne (ms) : durée moyenne, en microsecondes, de chaque exécution de la requête au sein de la base de données. à l'exclusion du temps d'encodage et de transmission de l'ensemble de résultats ainsi que de la surcharge

• Lignes analysées en moyenne : nombre moyen de lignes analysées par la requête, à l'exclusion des valeurs supprimées.

• Lignes renvoyées en moyenne : nombre moyen de lignes renvoyées par la requête.

• Octets renvoyés : nombre d'octets de données renvoyés par la requête, à l'exclusion de la surcharge liée à l'encodage de la transmission.

Écart possible entre les graphiques

Vous remarquerez peut-être un écart entre le graphique Utilisation totale du processeur (toutes les requêtes) et le graphique Utilisation totale du processeur (par requête ou tag de requête). Deux éléments peuvent être à l'origine de ce scénario :

• Différentes sources de données : les données Cloud Monitoring, qui alimentent le graphique Utilisation totale du processeur (toutes les requêtes), sont généralement plus précises, car elles sont envoyées toutes les minutes et ont une période de conservation de 45 jours. En revanche, les données de la table système, qui alimentent le graphique Utilisation totale du processeur (par requête ou tag de requête), peuvent être moyennées sur 10 minutes (ou 1 heure). Dans ce cas, nous risquons de perdre des données à haute granularité que nous voyons dans le graphique Utilisation totale du processeur (toutes les requêtes).

• Différentes fenêtres d'agrégation : les deux graphiques ont des fenêtres d'agrégation différentes. Par exemple, lors de l'inspection d'un événement datant de plus de six heures, nous interrogerons la table SPANNER_SYS.QUERY_STATS_TOTAL_10MINUTE. Dans ce cas, un événement qui se produit à 10h01 est agrégé sur 10 minutes et est présent dans la table système correspondant à l'horodatage 10h10.

La capture d'écran suivante montre un exemple de cet écart.

Analyser une requête ou un tag de requête spécifique

Pour déterminer si une requête ou un tag de requête est la cause principale du problème, cliquez sur la requête ou le tag de requête qui semble avoir la charge la plus élevée ou qui prend plus de temps que les autres. Vous pouvez sélectionner plusieurs requêtes et tags de requête à la fois.

Vous pouvez maintenir le pointeur de la souris sur le graphique pour les requêtes tout au long de la chronologie afin de connaître leur utilisation du processeur (en secondes).

Essayez de préciser le problème en examinant les éléments suivants :

• Depuis combien de temps la charge est-elle élevée ? Est-elle élevée uniquement maintenant ? Ou est-elle élevée depuis longtemps ? Modifiez les périodes pour trouver la date et l'heure auxquelles la requête a commencé à mal fonctionner.
• Y a-t-il eu des pics d'utilisation du processeur ? Vous pouvez modifier la période pour étudier l'historique d'utilisation du processeur de la requête.
• Quelle est la consommation des ressources ? Quel est le rapport avec les autres requêtes ? Consultez le tableau et comparez les données des autres requêtes avec celles de la requête sélectionnée. Y a-t-il une différence majeure ?

Pour confirmer que la requête sélectionnée contribue à l'utilisation élevée du processeur, vous pouvez afficher le détail des informations de la forme de requête spécifique (ou du tag de requête) et l'analyser plus en détail sur la page d'informations de la requête.

Afficher la page d'informations de la requête

Pour afficher les détails d'une forme de requête ou d'un tag de requête spécifique sous forme graphique, cliquez sur l'empreinte associée à la requête ou au tag de requête. La page "Détails de la requête" s'ouvre.

La page d'informations de la requête affiche les informations suivantes :

1. Texte des détails de la requête : texte de la requête SQL, tronqué à environ 64 Ko. Les statistiques de plusieurs requêtes ayant la même chaîne de tag sont regroupées sur une seule ligne avec le REQUEST_TAG correspondant à cette chaîne de tag. Seul le texte de l'une de ces requêtes est affiché dans ce champ. Pour le traitement LMD par lots, l'ensemble des instructions SQL est aplati sur une seule ligne, concaténé à l'aide d'un point-virgule comme délimiteur. Les textes SQL identiques consécutifs sont dédupliqués avant d'être tronqués.
2. Les valeurs des champs suivants :
   • Nombre d'exécutions : taux moyen d'exécutions de requêtes, en exécutions par minute, que Spanner a constaté au cours de l'intervalle.
   • CPU moyen (ms) : consommation moyenne des ressources du processeur, en millisecondes, par une requête des ressources du processeur de l'instance au cours d'un intervalle de temps.
   • Latence moyenne (ms) : durée moyenne, en millisecondes, de chaque exécution de la requête au sein de la base de données. à l'exclusion du temps d'encodage et de transmission de l'ensemble de résultats ainsi que de la surcharge
   • Lignes renvoyées en moyenne : nombre moyen de lignes renvoyées par la requête.
   • Lignes analysées en moyenne : nombre moyen de lignes analysées par la requête, à l'exclusion des valeurs supprimées.
   • Octets moyens : nombre d'octets de données renvoyés par la requête, à l'exclusion de la surcharge liée à l'encodage de la transmission.
3. Graphique des exemples de plan de requête : chaque point du graphique représente un plan de requête échantillonné à un moment précis et sa latence de requête spécifique. Cliquez sur l'un des points du graphique pour afficher le plan de requête et visualiser les étapes effectuées lors de l'exécution de la requête. Remarque : Les plans de requête ne sont pas compatibles avec les requêtes comportant des partitionTokens obtenus à partir de l'API PartitionQuery et requêtes LMD partitionnées.

4. Outil de visualisation de plans de requête : affiche le plan de requête échantillonné sélectionné. Spanner propose les options de mise en page suivantes :

   • Vue arborescente : la vue arborescente visualise le plan de requête sous forme de graphique où chaque nœud ou fiche représente un itérateur qui consomme les lignes de ses entrées et produit des lignes vers son parent. Vous pouvez cliquer sur chaque itérateur pour obtenir des informations détaillées.

   • Vue séquentielle : la vue séquentielle visualise le plan de requête dans un tableau hiérarchique où chaque ligne représente un opérateur. Vous pouvez cliquer sur chaque ligne pour obtenir des informations détaillées.

     

     Le tableau comporte les colonnes suivantes :

     • Nom : nom de l'opérateur.
     • Groupe de machines : groupe de machines sur lequel cet opérateur s'est exécuté.
     • Latence : temps écoulé lors de l'exécution de l' opération actuelle. Ce total peut être supérieur au temps CPU (par exemple, si l'opérateur a attendu des appels distants ou un retard du système de fichiers).
     • Latence cumulée : temps écoulé lors de l' exécution de l'ensemble de la sous-arborescence dont cet opérateur est la racine. Cela n'inclut pas le temps de création du plan ni les autres frais généraux. C'est pourquoi la latence cumulée peut être inférieure à la durée totale de la requête.
     • Temps CPU : temps CPU total utilisé pour l'exécution de la requête. N'inclut pas la latence du réseau. Certaines parties de l'exécution d'une requête peuvent avoir lieu en parallèle. Il est donc possible que le temps CPU soit supérieur à la durée totale écoulée. Par exemple, si une requête exécute 10 opérations en parallèle en 1 milliseconde (ms), le temps écoulé est d'1 ms, mais le temps CPU est de 10 ms.
     • Lignes renvoyées : nombre de lignes renvoyées par l'opérateur.

5. Graphique de latence de la requête : affiche la valeur de la latence de la requête pour une requête sélectionnée sur une période donnée. Il indique également la latence moyenne.

6. Graphique d'utilisation du processeur : affiche l'utilisation du processeur par une requête, en pourcentage, sur une période donnée. Il indique également l'utilisation moyenne du processeur.

7. Graphique du nombre d'exécutions/d'échecs : affiche le taux moyen d'exécutions de requêtes (en exécutions par minute) sur une période donnée et le taux moyen d'échecs d'exécution de requêtes (en échecs d'exécution par minute).

8. Graphique des lignes analysées : affiche le nombre de lignes analysées par la requête sur une période donnée.

9. Graphique des lignes renvoyées : affiche le nombre de lignes renvoyées par la requête sur une période donnée.

10. Filtre de période : permet de filtrer les détails de la requête par période, par exemple par heure, par jour ou selon une plage personnalisée.

Pour les graphiques, nous récupérons les données du tableau des statistiques des N principales requêtes, qui comporte trois niveaux de granularité différents : 1 minute, 10 minutes et 1 heure. La valeur de chaque point de données des graphiques représente la valeur moyenne sur un intervalle d'une minute.

Rechercher toutes les exécutions d'une requête dans le journal d'audit

Pour rechercher toutes les exécutions d'une empreinte de requête particulière dans Cloud Audit Logs, interrogez le journal d'audit et recherchez tout query_fingerprint correspondant au champ Fingerprint dans le tableau des statistiques des N principales requêtes. Pour en savoir plus, consultez la présentation Interroger et afficher les journaux. Utilisez cette méthode pour identifier l'utilisateur qui a lancé la requête.

Étape suivante

• Surveiller les requêtes actives