Cette page explique comment surveiller et dépanner les requêtes en cours d'exécution dans votre instance Spanner. Les requêtes actives sont des requêtes de longue durée qui peuvent affecter les performances de votre instance. La surveillance de ces requêtes peut vous aider à identifier les causes de la latence des instances et de l'utilisation élevée du processeur.
Dans la console Google Cloud , vous pouvez afficher les requêtes actives sur la page Insights sur les requêtes de Spanner. Ces requêtes sont triées par heure de début. Si de nombreuses requêtes sont actives, les résultats peuvent être limités à un sous-ensemble du nombre total de requêtes en raison des contraintes de mémoire appliquées par Spanner sur la collecte de données.
Avant de commencer
Pour obtenir les autorisations nécessaires pour afficher les requêtes actives, 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)
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.
Afficher les requêtes actives
Pour afficher les requêtes actives pour chaque base de données :
Dans la console Google Cloud , accédez à la page Instances de Spanner.
Cliquez sur l'instance contenant les requêtes que vous souhaitez surveiller.
Dans le menu de navigation, cliquez sur Insights sur les requêtes.
Utilisez le menu Base de données pour spécifier la base de données que vous souhaitez surveiller.
Cliquez sur l'onglet Requêtes actives. Cet onglet contient un récapitulatif des requêtes actives, ainsi qu'un tableau des 50 requêtes actives les plus longues.
Afficher les requêtes dont l'exécution prend le plus de temps
Le tableau suivant décrit les colonnes du tableau Requêtes les plus longues de l'onglet Requêtes actives :
| Nom de la colonne | Description |
|---|---|
| ID de la requête | Identifiant unique de la requête. |
| Requête | Texte de la requête SQL. |
| Empreinte numérique | Hachage du REQUEST_TAG ou du texte de la requête SQL. |
| Heure de début | Code temporel de début de la requête. |
| Durée de la requête | Durée d'exécution de la requête active. |
| Action | Contient un lien permettant de mettre fin à la requête. |
Lorsque l'option Actualisation automatique est activée, l'écran est actualisé toutes les 60 secondes.
Arrêter une requête
Vous pouvez mettre fin à une requête en cours d'exécution dans votre instance. Mettre fin à une requête peut aider à libérer des ressources et à réduire la charge sur votre instance. L'arrêt d'une requête est une opération effectuée dans la mesure du possible.
La page de la console Google Cloud s'actualise après le lancement de la résiliation. Si l'arrêt a abouti, la requête est supprimée du tableau. Si la terminaison échoue, elle se fait en arrière-plan et la requête continue d'apparaître dans le tableau Requêtes les plus longues.
Il est possible que Spanner n'annule pas une requête lorsque les serveurs sont occupés. Vous pouvez réessayer de mettre fin à une requête pour l'annuler.
Pour obtenir l'autorisation dont vous avez besoin pour mettre fin à une requête, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de bases de données Cloud Spanner (spanner.databaseReader) sur l'instance.
Ce rôle prédéfini contient l'autorisation spanner.sessions.delete, qui est nécessaire pour mettre fin à une requête.
Pour mettre fin à une requête, procédez comme suit :
- Sélectionnez la requête que vous souhaitez arrêter dans le tableau Requêtes les plus longues.
- Dans la colonne Actions, cliquez sur Mettre fin.
- Dans la fenêtre Arrêter la requête, cliquez sur Confirmer.
Étapes suivantes
- En savoir plus sur l'analyse des performances des requêtes
- En savoir plus sur les statistiques sur les requêtes actives les plus anciennes