Surveiller des instances avec Cloud Monitoring

Ce document explique comment utiliser la console Cloud Monitoring pour surveiller vos instances Spanner.

La console Cloud Monitoring offre plusieurs outils de surveillance pour Spanner :

• Un tableau de bord organisé, qui affiche des graphiques prédéfinis pour vos ressources Spanner
• Des graphiques personnalisés, y compris des graphiques ad hoc dans l'explorateur de métriques ainsi que des graphiques dans les tableaux de bord personnalisés
• Des alertes, qui vous avertissent lorsqu'une métrique dépasse le seuil que vous avez spécifié

Si vous préférez surveiller Spanner de manière automatisée, utilisez les bibliothèques clientes Cloud pour Cloud Monitoring afin d'extraire les métriques.

Remarque : Vous pouvez également surveiller vos instances en affichant des graphiques dans la console Google Cloud. Utilisez la console Google Cloud pour obtenir un aperçu rapide des métriques les plus importantes pour votre instance.

Utiliser le tableau de bord organisé de Cloud Monitoring

Cloud Monitoring vous fournit un tableau de bord organisé récapitulant les informations essentielles sur vos instances Spanner, y compris :

• Incidents : liste des alertes de surveillance créées par l'utilisateur (ouvertes, actives ou résolues)
• Événements : liste des journaux d'audit de Spanner (si la journalisation est activée et que des journaux sont disponibles)
• Instances: résumé général de vos instances Spanner, y compris capacité de calcul, nombre de bases de données et état de l'instance
• Graphiques agrégés d'utilisation du débit et du stockage

Pour afficher le tableau de bord Spanner, procédez comme suit :

1. Dans Google Cloud Console, sélectionnez Monitoring ou utilisez le bouton suivant :

   Accéder à Monitoring

2. Si Ressources s'affiche dans le volet de navigation, sélectionnez Ressources, puis Cloud Spanner. Sinon, sélectionnez Tableaux de bord, puis le tableau de bord intitulé Cloud Spanner.

Afficher les détails de l'instance et de la base de données

Lorsque vous ouvrez le tableau de bord organisé pour Spanner, celui-ci affiche des données cumulées pour toutes vos instances. Vous pouvez afficher plus de détails sur une instance spécifique en cliquant sur son nom sous Instances.

Le tableau de bord affiche des informations relatives à cette instance, telles que ses métadonnées, les bases de données qu'elle contient et les graphiques de diverses métriques ventilées par région.

À partir de la page "Tableau de bord" d'une instance, vous pouvez également accéder aux graphiques associés à une base de données spécifique hébergée dans cette instance :

1. Sur la droite, au-dessus des graphiques représentant les métriques de l'instance, cliquez sur Métriques de bases de données.

2. Dans la liste déroulante Sélectionner une répartition, sélectionnez la base de données que vous souhaitez examiner.

   La console Cloud Monitoring affiche les graphiques relatifs à la base de données sélectionnée.

Créer des graphiques personnalisés pour les métriques Spanner

Cloud Monitoring peut vous servir à créer des graphiques personnalisés pour les métriques Spanner. L'explorateur de métriques permet de créer des graphiques ad hoc temporaires ou des graphiques qui s'affichent dans les tableaux de bord personnalisés.

Cloud Monitoring vous permet notamment de créer un graphique personnalisé indique si deux métriques ou plus sont corrélées entre elles. Par exemple, vous pouvez rechercher une corrélation entre l'utilisation du processeur et lalatence dans une instance Spanner. Une telle corrélation peut indiquer que votre instance a besoin de plus de capacité de calcul ou que certaines de vos requêtes entraînent une utilisation intensive du processeur.

Pour faire vos premiers pas avec cet exemple, procédez comme suit :

1. Dans Google Cloud Console, sélectionnez Monitoring ou utilisez le bouton suivant :

   Accéder à Monitoring

2. Si l'explorateur de métriques s'affiche dans le volet de navigation, sélectionnez-le. Sinon, sélectionnez Ressources, puis Explorateur de métriques.

3. Cliquez sur l'onglet Afficher les options, puis cochez la case Échelle logarithmique sur l'axe y. Cette option vous permet de comparer plusieurs métriques lorsque l'une d'entre elles présente des valeurs beaucoup plus élevées que les autres.

4. Dans la liste déroulante située au-dessus du panneau de droite, sélectionnez Ligne.

5. Cliquez sur l'onglet Métriques. Vous pouvez maintenant ajouter des métriques au graphique.

Pour ajouter des métriques de latence au graphique, procédez comme suit :

1. Dans le champ Rechercher un type de ressource et une métrique, saisissez la valeur spanner.googleapis.com/api/request_latencies, puis cliquez sur la ligne qui s'affiche en dessous.
2. Dans le champ Filtre, saisissez la valeur instance_id, puis indiquez l'ID de l'instance à examiner et cliquez sur Appliquer.
3. Dans la liste déroulante Agrégateur, cliquez sur max.

4. Facultatif : modifiez le centile de latence :

   1. Cliquez sur Afficher les options avancées.

   2. Cliquez sur la liste déroulante Aligneur, puis sur le centile de latence à afficher.

      Dans la plupart des cas, vous devez examiner la latence au 50e centile pour connaître le temps de latence habituel ou la latence au 99e centile pour connaître la latence correspondant aux 1 % de requêtes les plus lentes.

Pour ajouter des métriques d'utilisation du processeur au graphique, procédez comme suit :

1. Cliquez sur Ajouter une métrique ().
2. Dans le champ Rechercher un type de ressource et une métrique, saisissez la valeur spanner.googleapis.com/instance/cpu/utilization, puis cliquez sur la ligne qui s'affiche en dessous.
3. Dans le champ Filtre, saisissez la valeur instance_id, puis indiquez l'ID de l'instance à examiner et cliquez sur Appliquer.
4. Dans la liste déroulante Agrégateur, cliquez sur max.

Vous disposez maintenant d'un graphique qui affiche les métriques d'utilisation et de latence du processeur Cloud Spanner. Si les deux métriques sont simultanément plus élevées que prévu, vous pouvez prendre des mesures supplémentaires pour corriger le problème.

Pour en savoir plus sur la création de graphiques personnalisés, consultez la documentation sur Cloud Monitoring.

Créer des alertes pour les métriques Spanner

Lorsque vous créez une instance Spanner, vous choisissez la capacité de calcul pour l'instance. Lorsque la charge de travail de l'instance évolue, Spanner n'ajuste pas automatiquement la capacité de calcul de l'instance. Ainsi, vous devez configurer plusieurs alertes pour vous assurer que l'instance respecte les valeurs maximales recommandées pour l'utilisation du processeur et la limite recommandée pour le volume de stockage.

Les exemples suivants montrent comment configurer des règles d'alerte pour certaines métriques Spanner. Pour obtenir la liste complète des métriques disponibles, consultez la section Liste des métriques Spanner.

Utilisation du processeur, priorité élevée

Pour créer une règle d'alerte qui se déclenche lorsque l'utilisation du processeur à priorité élevée pour Spanner dépasse le seuil recommandé, utilisez les paramètres suivants.

Procédure permettant de créer une règle d'alerte

Pour créer une règle d'alerte, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Alertes :

   Accéder à l'interface des alertes

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Surveillance.

2. Si vous n'avez pas créé vos canaux de notification et que vous souhaitez être averti, cliquez sur Modifier les canaux de notification et ajoutez vos canaux de notification. Revenez à la page Alertes après avoir ajouté vos canaux.
3. Sur la page Alertes, cliquez sur Créer une règle.
4. Pour sélectionner la ressource, la métrique et les filtres, développez le menu Sélectionner une métrique, puis utilisez les valeurs du tableau Nouvelle condition :
   1. (Facultatif) Pour limiter le menu aux entrées pertinentes, saisissez le nom de la ressource ou de la métrique dans la barre de filtre.
   2. Sélectionner un type de ressource Par exemple, sélectionnez Instance de VM.
   3. Sélectionnez une catégorie de métriques. Par exemple, sélectionnez instance.
   4. Sélectionnez une métrique. Par exemple, sélectionnez Utilisation du processeur.
   5. Sélectionnez Appliquer.
5. Cliquez sur Suivant, puis configurez le déclencheur de règle d'alerte. Pour renseigner ces champs, utilisez les valeurs du tableau Configurer le déclencheur d'alerte.
6. Cliquez sur Suivant.

7. Facultatif : Pour ajouter des notifications à votre règle d'alerte, cliquez sur Canaux de notification. Dans la boîte de dialogue, sélectionnez un ou plusieurs canaux de notification dans le menu, puis cliquez sur OK.

   Pour recevoir une notification en cas d'ouverture et de fermeture d'un incident, cochez la case Notifier en cas de fermeture des incidents. Par défaut, les notifications ne sont envoyées que lorsque des incidents sont ouverts.

8. (Facultatif) Mettez à jour la durée de fermeture automatique de l'incident. Ce champ détermine à quel moment Monitoring ferme les incidents en l'absence de données de métriques.
9. Facultatif : Cliquez sur Documentation, puis ajoutez les informations à inclure dans le message de notification.
10. Cliquez sur Nom de l'alerte et saisissez un nom pour la règle d'alerte.
11. Cliquez sur Créer une règle.

ChampNouvelle condition	Valeur
Ressource et métrique	Dans le menu Resources (Ressources), sélectionnez Spanner Instance (Instance Spanner). Dans le menu Catégories de métriques, sélectionnez Instance. Dans le menu Métriques, sélectionnez Utilisation du processeur selon la priorité. (Le type de métrique est spanner.googleapis.com/instance/cpu/utilization_by_priority.)
Filter	instance_id = YOUR_INSTANCE_ID priority = high
Dans toutes les séries temporelles Regrouper les séries temporelles par	location pour les instances multirégionales ; laissez le champ vide pour les instances régionales.
Dans toutes les séries temporelles Agrégation de séries temporelles	sum
Fenêtre glissante	10 m
Fenêtrage glissant	mean

Champ Configurer le déclencheur d'alerte	Valeur
Type de condition	Threshold
Déclencheur d'alerte	Any time series violates
Position du seuil	Above threshold
Valeur du seuil	45% pour les instances multirégionales ; 65% pour les instances régionales.
Fenêtre du nouveau test	10 minutes

Utilisation du processeur, moyenne glissante de 24 heures

Pour créer une règle d'alerte qui se déclenche lorsque la moyenne glissante sur 24 heures associée à l'utilisation du processeur pour Spanner dépasse le seuil recommandé, utilisez les paramètres suivants :

Procédure permettant de créer une règle d'alerte

Pour créer une règle d'alerte, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Alertes :

   Accéder à l'interface des alertes

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Surveillance.

2. Si vous n'avez pas créé vos canaux de notification et que vous souhaitez être averti, cliquez sur Modifier les canaux de notification et ajoutez vos canaux de notification. Revenez à la page Alertes après avoir ajouté vos canaux.
3. Sur la page Alertes, cliquez sur Créer une règle.
4. Pour sélectionner la ressource, la métrique et les filtres, développez le menu Sélectionner une métrique, puis utilisez les valeurs du tableau Nouvelle condition :
   1. (Facultatif) Pour limiter le menu aux entrées pertinentes, saisissez le nom de la ressource ou de la métrique dans la barre de filtre.
   2. Sélectionner un type de ressource Par exemple, sélectionnez Instance de VM.
   3. Sélectionnez une catégorie de métriques. Par exemple, sélectionnez instance.
   4. Sélectionnez une métrique. Par exemple, sélectionnez Utilisation du processeur.
   5. Sélectionnez Appliquer.
5. Cliquez sur Suivant, puis configurez le déclencheur de règle d'alerte. Pour renseigner ces champs, utilisez les valeurs du tableau Configurer le déclencheur d'alerte.
6. Cliquez sur Suivant.

7. Facultatif : Pour ajouter des notifications à votre règle d'alerte, cliquez sur Canaux de notification. Dans la boîte de dialogue, sélectionnez un ou plusieurs canaux de notification dans le menu, puis cliquez sur OK.

   Pour recevoir une notification en cas d'ouverture et de fermeture d'un incident, cochez la case Notifier en cas de fermeture des incidents. Par défaut, les notifications ne sont envoyées que lorsque des incidents sont ouverts.

8. (Facultatif) Mettez à jour la durée de fermeture automatique de l'incident. Ce champ détermine à quel moment Monitoring ferme les incidents en l'absence de données de métriques.
9. Facultatif : Cliquez sur Documentation, puis ajoutez les informations à inclure dans le message de notification.
10. Cliquez sur Nom de l'alerte et saisissez un nom pour la règle d'alerte.
11. Cliquez sur Créer une règle.

ChampNouvelle condition	Valeur
Ressource et métrique	Dans le menu Resources (Ressources), sélectionnez Spanner Instance (Instance Spanner). Dans le menu Catégories de métriques, sélectionnez Instance. Dans le menu Métriques, sélectionnez Utilisation lissée du processeur. (Le type de métrique est spanner.googleapis.com/instance/cpu/smoothed_utilization.)
Filter	instance_id = YOUR_INSTANCE_ID
Dans toutes les séries temporelles Agrégation de séries temporelles	sum
Fenêtre glissante	10 m
Fenêtrage glissant	mean

Champ Configurer le déclencheur d'alerte	Valeur
Type de condition	Threshold
Déclencheur d'alerte	Any time series violates
Position du seuil	Above threshold
Seuil	90%
Fenêtre du nouveau test	10 minutes

Stockage

Pour créer une règle d'alerte qui se déclenche lorsque l'espace de stockage l'instance Spanner dépasse le seuil recommandé, utilisez les paramètres suivants.

Procédure permettant de créer une règle d'alerte

Pour créer une règle d'alerte, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Alertes :

   Accéder à l'interface des alertes

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Surveillance.

2. Si vous n'avez pas créé vos canaux de notification et que vous souhaitez être averti, cliquez sur Modifier les canaux de notification et ajoutez vos canaux de notification. Revenez à la page Alertes après avoir ajouté vos canaux.
3. Sur la page Alertes, cliquez sur Créer une règle.
4. Pour sélectionner la ressource, la métrique et les filtres, développez le menu Sélectionner une métrique, puis utilisez les valeurs du tableau Nouvelle condition :
   1. (Facultatif) Pour limiter le menu aux entrées pertinentes, saisissez le nom de la ressource ou de la métrique dans la barre de filtre.
   2. Sélectionner un type de ressource Par exemple, sélectionnez Instance de VM.
   3. Sélectionnez une catégorie de métriques. Par exemple, sélectionnez instance.
   4. Sélectionnez une métrique. Par exemple, sélectionnez Utilisation du processeur.
   5. Sélectionnez Appliquer.
5. Cliquez sur Suivant, puis configurez le déclencheur de règle d'alerte. Pour renseigner ces champs, utilisez les valeurs du tableau Configurer le déclencheur d'alerte.
6. Cliquez sur Suivant.

7. Facultatif : Pour ajouter des notifications à votre règle d'alerte, cliquez sur Canaux de notification. Dans la boîte de dialogue, sélectionnez un ou plusieurs canaux de notification dans le menu, puis cliquez sur OK.

   Pour recevoir une notification en cas d'ouverture et de fermeture d'un incident, cochez la case Notifier en cas de fermeture des incidents. Par défaut, les notifications ne sont envoyées que lorsque des incidents sont ouverts.

8. (Facultatif) Mettez à jour la durée de fermeture automatique de l'incident. Ce champ détermine à quel moment Monitoring ferme les incidents en l'absence de données de métriques.
9. Facultatif : Cliquez sur Documentation, puis ajoutez les informations à inclure dans le message de notification.
10. Cliquez sur Nom de l'alerte et saisissez un nom pour la règle d'alerte.
11. Cliquez sur Créer une règle.

ChampNouvelle condition	Valeur
Ressource et métrique	Dans le menu Resources (Ressources), sélectionnez Spanner Instance (Instance Spanner). Dans le menu Catégories de métriques, sélectionnez Instance. Dans le menu Métriques, sélectionnez Espace de stockage utilisé. (Le type de métrique est spanner.googleapis.com/instance/storage/utilization).
Filter	instance_id = YOUR_INSTANCE_ID
Dans toutes les séries temporelles Agrégation de séries temporelles	sum
Fenêtre glissante	10 m
Fenêtrage glissant	max

Champ Configurer le déclencheur d'alerte	Valeur
Type de condition	Threshold
Condition triggers if (déclenchement de la condition)	Any time series violates
Position du seuil	Above threshold
Valeur du seuil	Vous n'avez pas besoin de définir un seuil spécifique pour la capacité de stockage maximale par nœud. Toutefois, nous vous recommandons pour lequel vous avez configuré une alerte lorsque vous approchez de la limite de stockage maximale. Pour en savoir plus, consultez la section Métriques d'utilisation du stockage.
Fenêtre du nouveau test	10 minutes

Remarque : Les volumes d'utilisation de Spanner sont exprimés en téraoctets binaires, où 1 To équivaut à 2⁴⁰ octets. Cette unité de mesure est également connue sous le nom de tébioctet (Tio).

Étape suivante

• Découvrez en détail les métriques d'utilisation du processeur et de latence pour Spanner.
• Utilisez la console Google Cloud pour afficher un bref aperçu des métriques les plus importantes concernant votre instance.
• Obtenez davantage d'informations sur Cloud Monitoring.