Surveiller et résoudre les problèmes avec l'aide de l'IA

Ce document explique comment utiliser l'assistance IA pour surveiller et résoudre les problèmes liés à vos ressources Cloud SQL. Vous pouvez utiliser les outils de dépannage assistés par l'IA de Cloud SQL et Gemini Cloud Assist pour résoudre les problèmes de requêtes lentes et résoudre les problèmes de charge élevée de la base de données.

Limites

Les limites suivantes s'appliquent au dépannage assisté par l'IA dans Cloud SQL :

  • Le dépannage assisté par l'IA n'est pas compatible avec les configurations Cloud SQL suivantes :
  • La détection d'anomalies dans les requêtes n'est disponible que pour les instances Cloud SQL Enterprise Plus.

Avant de commencer

  1. Assurez-vous que Gemini Cloud Assist est configuré pour votre compte utilisateur et votre projet Google Cloud .

    Une fois que vous avez configuré Gemini Cloud Assist, la propagation du service peut prendre quelques minutes. Attendez que la propagation soit terminée avant d'activer le dépannage assisté par l'IA dans Cloud SQL.

  2. Assurez-vous que votre instance est une instance Cloud SQL Enterprise Plus.
  3. Assurez-vous que votre instance Cloud SQL utilise la nouvelle architecture réseau.
  4. Activez les insights sur les requêtes pour les éditions Cloud SQL Enterprise Plus et Cloud SQL Enterprise.
  5. MYSQL_VERSION.R20250304.00_01 ou une version ultérieure doit être installé sur l'instance Cloud SQL pour MySQL. Pour en savoir plus sur l'application de versions de maintenance à une instance, consultez À propos de la maintenance sur les instances Cloud SQL.

Rôles et autorisations nécessaires

Pour obtenir les autorisations nécessaires pour utiliser le dépannage assisté par l'IA, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet qui héberge l'instance Cloud SQL :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour utiliser le dépannage assisté par l'IA. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour utiliser le dépannage assisté par l'IA :

  • databaseinsights.performanceIssues.detect
  • databaseinsights.performanceIssues.investigate

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour en savoir plus sur les rôles et les autorisations requis pour utiliser les investigations Gemini Cloud Assist, consultez Résoudre les problèmes à l'aide des investigations Gemini Cloud Assist.

Activer le dépannage assisté par IA

Lorsque vous activez le dépannage assisté par l'IA pour votre instance Cloud SQL, Cloud SQL peut analyser les performances de vos bases de données et détecter les anomalies dans l'exécution de vos requêtes. Lorsque Cloud SQL détecte des anomalies dans les performances des requêtes ou identifie une charge système élevée, le dépannage assisté par l'IA vous aide à analyser la situation avec des preuves et fournit des recommandations.

Pour activer le dépannage assisté par l'IA pour votre instance Cloud SQL, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans la tuile Configuration, cliquez sur Modifier la configuration.
  4. Dans la section Personnaliser votre instance, développez Insights sur les requêtes.
    1. Si ce n'est pas déjà fait, sélectionnez Activer Insights sur les requêtes.
    2. Pour l'édition Cloud SQL Enterprise Plus uniquement, si ce n'est pas déjà fait, sélectionnez Activer les fonctionnalités Enterprise Plus.
  5. Pour l'édition Cloud SQL Enterprise Plus uniquement, sélectionnez Activer le dépannage assisté par l'IA. Pour les instances Cloud SQL Enterprise, le dépannage avec l'assistance IA n'est disponible que si vous activez Gemini Cloud Assist.
  6. Cliquez sur Enregistrer.
  7. Pour obtenir des résultats optimaux, attendez 24 heures après avoir activé le dépannage assisté par l'IA dans la console Google Cloud pour permettre à Cloud SQL de créer une référence des performances moyennes de votre instance, de votre base de données et de vos requêtes.

Votre instance doit être redémarrée. Pour en savoir plus sur l'activation d'Insights sur les requêtes pour l'édition Cloud SQL Enterprise Plus, consultez Utiliser Insights sur les requêtes pour améliorer les performances des requêtes.

Ouvrir Gemini Cloud Assist

Pour utiliser Gemini Cloud Assist avec Cloud SQL, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le volet de navigation, sélectionnez Insights sur les requêtes.
  4. Pour ouvrir le panneau Cloud Assist, cliquez sur Ouvrir ou fermer le chat Gemini Cloud Assist.
  5. Dans le panneau Cloud Assist, saisissez un prompt qui décrit les informations qui vous intéressent.
  6. Après avoir saisi le prompt, cliquez sur Envoyer le prompt.

    Gemini renvoie une réponse à votre prompt en fonction des informations de la dernière heure.

Résoudre les problèmes liés à la lenteur des requêtes

Pour utiliser l'assistance IA afin de résoudre les problèmes de requêtes lentes, accédez au tableau de bord Insights sur les requêtes de votre instance Cloud SQL dans la console Google Cloud .

Tableau des requêtes les plus fréquentes

Vous pouvez commencer à résoudre les problèmes liés à la lenteur des requêtes avec l'assistance IA dans la section Tableau des requêtes les plus fréquentes du tableau de bord Insights sur les requêtes.

Cloud SQL peut vous aider à identifier les requêtes dont les performances sont inférieures à la moyenne pendant une période de détection spécifique. Après avoir sélectionné une période dans le tableau de bord Insights sur les requêtes, Cloud SQL vérifie si des requêtes sont plus lentes que la moyenne en utilisant une période de détection de 24 heures avant la fin de la période sélectionnée.

Lorsque vous ajustez le filtre de période du graphique Charge de la base de données ou tout autre filtre tel que la base de données ou l'utilisateur, Cloud SQL actualise le tableau des requêtes les plus fréquentes et réexécute la détection d'anomalies en fonction de la nouvelle liste de requêtes et d'une période de détection mise à jour.

Pour les instances Cloud SQL Enterprise Plus, voici ce qui se passe lorsque Cloud SQL détecte une anomalie :

Si une requête s'exécute plus lentement que prévu, une icône d'avertissement warning_spark s'affiche. Lorsque vous cliquez sur l'une de ces icônes, Gemini Cloud Assist est utilisé pour vous aider à analyser l'exécution de la requête et vous propose des observations sur ce qui a pu causer un problème. À partir de ces observations, Gemini Cloud Assist génère une hypothèse qui peut vous aider à résoudre le problème.

Pour résoudre les problèmes de requêtes lentes dans le tableau Principales requêtes du tableau de bord Insights sur les requêtes, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, cliquez sur Insights sur les requêtes.
  4. Dans le graphique Requêtes exécutées, utilisez le filtre Période pour sélectionner 1 heure, 6 heures, 1 jour, 7 jours, 30 jours ou une période personnalisée.
  5. Dans le tableau Requêtes les plus fréquentes, sous l'onglet Requêtes, examinez la liste des requêtes pour votre base de données.
  6. Si une icône Avertissement warning_spark s'affiche à côté de la valeur Temps d'exécution moyen (ms) d'une requête, cela signifie que Cloud SQL a détecté une anomalie dans les performances de votre requête. Cloud SQL recherche les anomalies au cours de la période de 24 heures qui précède la fin de la période sélectionnée.
  7. Cliquez sur l'icône Avertissement warning_spark.
  8. Dans la boîte de dialogue La requête est plus lente que d'habitude, cliquez sur Nouvelle investigation pour commencer à résoudre les problèmes avec l'assistance IA de Gemini Cloud Assist. Après environ deux minutes, le volet Détails de l'investigation s'ouvre avec les sections suivantes :
    • Problème. Une description du problème examiné, y compris l'heure de début et de fin de l'investigation.
    • Observations. Liste des observations concernant le problème. Par exemple, il peut s'agir de détails sur les conflits de verrouillage, tels qu'un ratio d'attente de verrouillage plus long que prévu pour la requête.
    • Hypothèses. Liste des actions recommandées par l'IA pour résoudre le problème de lenteur de la requête.

  9. Si vous souhaitez afficher toutes les investigations associées à la requête, dans la boîte de dialogue La requête est plus lente que d'habitude, cliquez sur Afficher toutes les investigations. La page Gemini Cloud Assist s'ouvre. Vous pouvez y consulter toutes les investigations en cours et terminées. Vous pouvez filtrer la page par projet ou par étiquette, par exemple, pour trouver l'investigation dont vous avez besoin.

    Vous pouvez également afficher toutes les investigations précédentes en cliquant sur l'icône Notifications , puis en sélectionnant une notification associée à une investigation pour ouvrir la page Gemini Cloud Assist.

  10. Si vous souhaitez examiner la latence d'une requête, procédez comme suit :
    1. Identifiez la requête spécifique que vous souhaitez examiner.
    2. Dans la colonne Actions, cliquez sur l'icône Actions associée à cette requête.
    3. Sélectionnez Examiner la latence dans le menu pour exécuter une investigation Gemini Cloud Assist.

Détails de la requête

Vous pouvez également résoudre les problèmes liés à la lenteur d'une requête avec l'assistance IA depuis la page Détails de la requête.

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Cliquez sur Insights sur les requêtes pour ouvrir le tableau de bord Insights sur les requêtes.
  4. Dans le tableau de bord Insights sur les requêtes, cliquez sur la requête que vous souhaitez afficher dans Requêtes les plus fréquentes. La page Détails de la requête s'affiche.
  5. Pour l'édition Cloud SQL Enterprise Plus, si Cloud SQL détecte une anomalie pour la requête, un ou plusieurs des indicateurs suivants s'affichent sur la page Détails de la requête :
    • Un message sur l'écran d'informations indiquant This query is slower than usual et une option Examiner.

    • Un message dans le graphique Latence des requêtes qui indique Query slower than usual. Si ce message s'affiche, cliquez sur le bouton Examiner pour commencer le dépannage avec l'assistance IA de Gemini Cloud Assist.

      Après environ deux minutes, le volet Détails de l'investigation s'ouvre avec les sections suivantes :

      • Problème. Une description du problème examiné, y compris l'heure de début et de fin de l'investigation.
      • Observations. Liste des observations concernant le problème. Par exemple, il peut s'agir de détails sur les conflits de verrouillage, tels qu'un ratio d'attente de verrouillage plus long que prévu pour la requête.
      • Hypothèses. Liste des actions recommandées par l'IA pour résoudre le problème de lenteur de la requête.
  6. (Facultatif) Utilisez le filtre de période pour sélectionner une heure, six heures, un jour, sept jours, 30 jours ou une période personnalisée. Lorsque vous ajustez le filtre de période de la page Détails de la requête ou tout autre filtre tel que Base de données ou Utilisateur, Cloud SQL réexécute la détection d'anomalies.
  7. Si Cloud SQL ne détecte pas d'anomalie pour la requête, vous pouvez toujours l'analyser en cliquant sur le bouton Examiner de la fiche Latence de la requête.

Analyser la latence des requêtes

Grâce à l'assistance IA, vous pouvez analyser et résoudre les problèmes liés à la latence de vos requêtes.

Période d'analyse

La période d'analyse correspond aux 24 heures précédant la fin de la période que vous sélectionnez dans le graphique Charge de la base de données du tableau de bord Insights sur les requêtes ou de la page Détails de la requête. Cloud SQL utilise cette période pour comparer les métriques de référence avec celles récupérées pendant la période de l'anomalie.

Sur la page Détails de la requête, pour l'édition Cloud SQL Enterprise Plus, si Cloud SQL a détecté une anomalie dans la requête, après avoir sélectionné la requête dans le tableau de bord Insights sur les requêtes, Cloud SQL effectue une analyse des performances de référence pour la requête en utilisant les 24 dernières heures à partir de la fin de l'anomalie. Si Cloud SQL n'a pas détecté d'anomalie avec la requête et exécute à nouveau la détection d'anomalies sur la requête, Cloud SQL utilise 48 heures avant la fin de la période sélectionnée comme référence de performances pour la période d'analyse.

Période d'anomalie détectée

La période d'anomalie détectée ne s'applique qu'aux instances Cloud SQL Enterprise Plus.

La période d'anomalie détectée représente une période pendant laquelle Cloud SQL détecte un changement anormal des performances des requêtes. Cloud SQL utilise les performances de référence mesurées pour la requête pendant la période d'analyse.

Si Cloud SQL détecte plusieurs anomalies pour une requête au cours d'une période sélectionnée, il utilise la dernière anomalie détectée.

Exemples de prompts sur les performances des requêtes

Vous pouvez également utiliser Gemini Cloud Assist pour saisir des prompts afin d'améliorer les performances de vos requêtes. Gemini Cloud Assist répond aux questions concernant l'instance et la base de données Cloud SQL sélectionnées.

Prompt Type de réponse
Quelles sont les principales requêtes par latence dans ma base de données ?
    Résumés des requêtes triés par latence. Gemini limite la réponse au filtre de période sélectionné dans le graphique de charge de la base de données d'Insights sur les requêtes.
Quelle est la requête la plus lente dans cette instance de base de données ? Conseils pour identifier la requête la plus lente en fonction de la latence.

Résoudre les problèmes de charge élevée de la base de données

En accédant au tableau de bord Insights sur les requêtes dans la console Google Cloud , vous pouvez analyser votre base de données et résoudre les événements lorsque votre système subit une charge de base de données supérieure à la moyenne. Cloud SQL utilise les 24 heures de données précédant la période sélectionnée pour calculer la charge attendue de votre base de données. Vous pouvez examiner les raisons de l'augmentation des événements de chargement et analyser les preuves de la baisse des performances. Cloud SQL fournit également des recommandations pour optimiser votre base de données afin d'améliorer les performances.

Pour utiliser l'assistance IA afin de résoudre les problèmes de charge élevée de la base de données, accédez à la page Présentation de l'instance ou au tableau de bord Insights sur les requêtes dans la console Google Cloud .

Page de présentation de l'instance

Pour résoudre les problèmes de charge élevée de la base de données avec l'assistance IA sur la page Présentation de l'instance, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Sur la page Présentation, dans le menu Graphique, sélectionnez une métrique pour la base de données. Vous pouvez sélectionner n'importe quelle métrique, par exemple Utilisation du processeur.
  4. (Facultatif) Pour sélectionner une période d'analyse spécifique, utilisez le filtre Période afin de sélectionner 1 heure, 6 heures, 1 jour, 7 jours, 30 jours ou une période personnalisée.

    Vous pouvez zoomer sur des sections spécifiques du graphique où vous remarquez des zones de charge élevée que vous souhaitez analyser. Par exemple, une zone de charge élevée peut afficher des niveaux d'utilisation du processeur proches de 100 %. Pour faire un zoom avant, vous pouvez cliquer sur une partie du graphique et la sélectionner.

    Cliquez sur le bouton Examiner les performances pour commencer à résoudre les problèmes de charge élevée de la base de données avec l'assistance IA de Gemini Cloud Assist.

    Après environ deux minutes, le volet Détails de l'investigation s'ouvre avec les sections suivantes :

    • Problème. Une description du problème examiné, y compris l'heure de début et de fin de l'investigation.
    • Observations. Liste des observations concernant le problème. Par exemple, il peut s'agir de détails sur les conflits de verrouillage, tels qu'un ratio d'attente de verrouillage plus long que prévu pour la requête.
    • Hypothèses. Liste des actions recommandées par l'IA pour résoudre le problème de lenteur de la requête.

Tableau de bord d'Insights sur les requêtes

Pour résoudre les problèmes de charge élevée de la base de données avec l'assistance IA dans le tableau de bord Insights sur les requêtes, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Cliquez sur Insights sur les requêtes pour ouvrir le tableau de bord Insights sur les requêtes.
  4. (Facultatif) Utilisez le filtre Période pour sélectionner une heure, six heures, un jour, sept jours, 30 jours ou une période personnalisée.

    5. Vous pouvez zoomer sur des sections spécifiques du graphique où vous remarquez des zones de charge de base de données plus élevée par temps d'exécution de la requête. Pour faire un zoom avant, vous pouvez cliquer sur une partie du graphique et la sélectionner.

    Dans le graphique de charge de la base de données, cliquez sur le bouton Examiner les performances pour commencer à résoudre les problèmes de charge élevée de la base de données avec l'assistance IA de Gemini Cloud Assist.

    Après environ deux minutes, le volet Détails de l'investigation s'ouvre avec les sections suivantes :

    • Problème. Une description du problème examiné, y compris l'heure de début et de fin de l'investigation.
    • Observations. Liste des observations concernant le problème. Par exemple, il peut s'agir de détails sur les conflits de verrouillage, tels qu'un ratio d'attente de verrouillage plus long que prévu pour la requête.
    • Hypothèses. Liste des actions recommandées par l'IA pour résoudre le problème de lenteur de la requête.

Analyser une charge de base de données élevée

Grâce à l'assistance IA, vous pouvez analyser et résoudre les problèmes liés à la charge de votre base de données.

Période d'analyse

Cloud SQL analyse votre base de données pour la période que vous sélectionnez dans le graphique de charge de la base de données, à partir du tableau de bord Insights sur les requêtes ou de la page Présentation de l'instance. Si vous sélectionnez une période de moins de 24 heures, Cloud SQL analyse l'intégralité de la période. Si vous sélectionnez une période supérieure à 24 heures, Cloud SQL ne sélectionne que les 24 dernières heures de la période pour l'analyse.

Pour calculer l'analyse des performances de référence de votre base de données, Cloud SQL inclut une période de référence de 24 heures dans sa période d'analyse. Si la période sélectionnée se produit un jour autre que le lundi, Cloud SQL utilise une période de référence correspondant aux 24 heures précédant la période sélectionnée. Si la période sélectionnée se produit un lundi, Cloud SQL utilise une période de référence correspondant au 7e jour précédant la période sélectionnée.

Analyse des métriques

Lorsque Cloud SQL lance l'analyse, il vérifie si des modifications importantes ont été apportées aux différentes métriques, y compris, mais sans s'y limiter, les suivantes :

  • Requêtes par seconde (RPS)
  • Processeur
  • Mémoire
  • E/S disque

Cloud SQL compare les données globales de référence de votre base de données aux données sur les performances de votre période d'analyse. Si Cloud SQL détecte un changement significatif du seuil d'une métrique clé, il indique une situation possible avec votre base de données. La situation identifiée peut expliquer la cause principale de la charge élevée sur votre base de données au cours de la période sélectionnée.

Recommandations

Une fois l'analyse terminée, la section Hypothèses du volet Détails de l'investigation liste des insights exploitables pour vous aider à résoudre le problème.

Dans certains cas, l'analyse peut ne pas déboucher sur une recommandation.

Exemples de prompts sur les performances du système

Vous pouvez également utiliser Gemini Cloud Assist pour saisir des prompts afin de collecter des informations sur les performances de votre système. Gemini Cloud Assist répond aux questions concernant l'instance Cloud SQL sélectionnée.

Prompt Type de réponse
Combien d'entrées de journal d'erreurs y a-t-il pour cette instance de base de données au cours des sept derniers jours ?
  • Résumé des entrées de journal regroupées par type de gravité. Gemini limite la réponse au filtre de période sélectionné dans le graphique des performances de l'instance.
  • Conseils pour identifier et trier les requêtes par latence.
Quelle était l'utilisation du processeur pour cette instance de base de données vers 14h aujourd'hui ? Résultats des métriques en pourcentage pour l'utilisation du processeur au cours de l'intervalle de temps.

Résoudre les problèmes de connectivité

Vous pouvez commencer à résoudre les problèmes de connectivité en utilisant Gemini Cloud Assist ou en lançant une investigation lorsque des erreurs de connexion se produisent. L'assistance IA évalue plusieurs sources pour identifier pourquoi un client peut rencontrer des problèmes lorsqu'il tente de se connecter à une base de données Cloud SQL.

Examiner les problèmes de connectivité

Pour utiliser l'assistance IA pour résoudre les problèmes de connectivité, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le volet Résoudre les problèmes de base de données grâce au dépannage assisté par l'IA, cliquez sur Explorer les investigations.
  4. Dans la fenêtre Options d'investigation, recherchez la section Utilisation de la connexion.
  5. Facultatif : Sélectionnez une période d'analyse spécifique à l'aide du filtre Période (1 heure, 6 heures, 1 jour, 7 jours ou une période personnalisée).
  6. Cliquez sur Examiner.

    Gemini lance une analyse automatisée des métadonnées, des journaux et de la configuration réseau de votre instance. Une fois l'analyse terminée, le volet Détails de l'investigation affiche les sections suivantes :

    • Problème : résumé de l'échec de connectivité, y compris les ressources concernées et les codes temporels.
    • Observations : preuves recueillies à partir de signaux, par exemple lorsqu'une base de données a atteint sa limite de max_connections ou que des connexions simultanées actives sont croisées avec des métadonnées d'instance. Les preuves peuvent être utilisées pour déterminer si un pic de trafic ou des sessions non fermées peuvent être à l'origine de l'indisponibilité de l'instance.
    • Hypothèses : causes principales et étapes de correction générées par IA.

Exemples de requêtes concernant des problèmes de connectivité

Vous pouvez également utiliser Gemini Cloud Assist pour résoudre les problèmes de connectivité entre un client et votre instance Cloud SQL.

Prompt Type de réponse
Pourquoi des erreurs de connexion s'affichent-elles ? Gemini évalue les connexions à votre base de données et recommande des améliorations, comme l'activation du pooling de connexions géré.

Obtenir des recommandations d'index

Vous pouvez obtenir des recommandations d'index de Cloud SQL dans les insights sur les requêtes. Pour en savoir plus sur l'obtention de recommandations d'index, consultez Utiliser Index Advisor.

Exemples de prompts de recommandation d'index

Utilisez Gemini Cloud Assist pour en savoir plus sur l'utilisation des index dans vos bases de données. Gemini Cloud Assist répond aux questions concernant l'instance Cloud SQL sélectionnée.

Prompt Type de réponse
Afficher les recommandations d'index pour les requêtes exécutées au cours des sept derniers jours. Conseils sur les types de requêtes pouvant bénéficier d'un index.

Surveiller les requêtes actives

Utilisez le tableau de bord Insights sur les requêtes pour surveiller les requêtes actives et, si nécessaire, arrêter les processus de longue durée. Pour en savoir plus, consultez Surveiller les requêtes actives.

Exemples de prompts de requête actifs

Utilisez Gemini Cloud Assist pour obtenir plus d'informations sur les requêtes qui entraînent une latence ou une charge de processeur élevée. Gemini Cloud Assist répond aux questions concernant l'instance Cloud SQL sélectionnée.

Prompt Type de réponse
Quelles sont les principales requêtes en cours d'exécution dans ma base de données ? Conseils pour identifier les requêtes les plus longues et les plus gourmandes en ressources.

Étapes suivantes