Surveiller les extensions de VM

La surveillance de l'état et des performances de vos extensions de VM vous aide à gérer l'utilisation des ressources et à résoudre les problèmes sur l'ensemble de votre parc d'instances Compute Engine. Vous pouvez utiliser des tableaux de bord Cloud Monitoring pour visualiser l'utilisation des ressources, comme la consommation de processeur ou de mémoire, et configurer des règles d'alerte pour recevoir des notifications lorsqu'un événement se produit, par exemple un échec d'installation.

Ce document explique comment surveiller les extensions de VM gérées par VM Extension Manager sur vos instances Compute Engine à l'aide de Cloud Monitoring, et vous aide à effectuer les opérations suivantes :

• Comprendre les métriques disponibles pour les extensions de VM
• Créer des tableaux de bord de surveillance personnalisés
• Configurer des règles d'alerte

Avant de commencer

• Si ce n'est pas déjà fait, configurez l'authentification. L'authentification permet de valider votre identité pour accéder aux Google Cloud services et aux API. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes :

  Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

  Console

  Lorsque vous utilisez la Google Cloud console pour accéder aux Google Cloud services et aux API, vous n'avez pas besoin de configurer l'authentification.

  gcloud

  1. Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisezla en exécutant la commande suivante :

     gcloud init

     Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

     Remarque : Si vous avez déjà installé la gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update.
• Définissez une région et une zone par défaut.

REST

Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.

Installez la Google Cloud CLI.

Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l' Google Cloud authentification.

Avant de commencer

Avant de surveiller vos extensions, assurez-vous d'avoir effectué les opérations suivantes :

• Installez les extensions de VM en créant des règles d'extension.
• Consultez les principes de base de VM Extension Manager.
• Consultez les périodes de conservation et les tarifs de Monitoring.

Rôles IAM requis

Pour obtenir les autorisations nécessaires pour surveiller les métriques et créer des tableaux de bord, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet.

Pour obtenir les autorisations nécessaires pour surveiller les métriques et gérer les tableaux de bord, demandez à votre administrateur de vous accorder les rôles IAM suivants :

• Pour afficher les métriques et les tableaux de bord : Lecteur Monitoring (roles/monitoring.viewer) sur le projet
• Pour créer et gérer des tableaux de bord et des règles d'alerte : Éditeur Monitoring (roles/monitoring.editor) sur le projet

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 surveiller les métriques et gérer les tableaux de bord. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour surveiller les métriques et gérer les tableaux de bord :

• Pour afficher les tableaux de bord: monitoring.dashboards.get sur le projet
• Pour créer des tableaux de bord: monitoring.dashboards.create sur le projet
• Pour configurer des alertes: monitoring.alertPolicies.create sur le projet

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 l'attribution de rôles, consultez Gérer l'accès aux projets, 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.

Métriques disponibles pour les extensions de VM

Les métriques suivantes sont disponibles pour surveiller vos extensions de VM dans Monitoring :

Nom de la métrique	Type de métrique	Description
État d'application de l'extension de VM	compute.googleapis.com/vm_extensions/extension/enforcement_status	État d'application d'une extension de VM Compute Engine. Les libellés incluent extension_name et status. Pour obtenir la liste des noms d'extension, consultez Extensions compatibles. Les valeurs possibles pour status sont les suivantes : ENFORCEMENT_STATE_UNSPECIFIED INSTALLING INSTALL_FAILED INSTALLED ROLLING_BACK ROLLBACK_FAILED ROLLED_BACK INCOMPATIBLE REMOVING SERVICE_DISABLED APPLYING_CONFIG
État de santé de l'extension de VM	compute.googleapis.com/vm_extensions/extension/health_status	État de santé d'une extension de VM. Les libellés incluent extension_name et status. Pour obtenir la liste des noms d'extension, consultez Extensions compatibles. Les valeurs possibles pour status sont les suivantes : HEALTH_STATUS_UNSPECIFIED STARTING RUNNING STOPPING STOPPED CRASHED
Utilisation maximale du processeur de l'extension de VM	compute.googleapis.com/vm_extensions/extension/cpu/max_usage	Temps CPU maximal utilisé par l'extension de VM, exprimé en pourcentage.
Octets de mémoire maximale utilisés par l'extension de VM	compute.googleapis.com/vm_extensions/extension/memory/used_bytes	Utilisation maximale de la mémoire de l'extension de VM, en octets.

Créer des tableaux de bord de surveillance personnalisés

Vous pouvez créer des tableaux de bord Monitoring contenant les graphiques d'extension de VM les plus pertinents pour votre cas d'utilisation. Pour ajouter un graphique à un tableau de bord, procédez comme suit :

1. Dans la Google Cloud console, sélectionnez Monitoring:

   Accéder à Monitoring

2. Dans le volet de navigation, sélectionnez Tableaux de bord.
3. Cliquez sur Créer un tableau de bord.
4. Cliquez sur Ajouter un widget.
5. Dans la fenêtre Ajouter un widget , sélectionnez Métrique dans le champ Données.
6. Pour sélectionner la métrique, développez le menu Sélectionner une métrique , puis procédez comme suit :
   1. Dans le champ Ressources actives, sélectionnez Instance de VM.
   2. Dans le champ Catégorie de métrique, sélectionnez Vm_extensions.
   3. Dans le champ Métrique, sélectionnez une métrique, par exemple État de santé de l'extension de VM Status. Pour obtenir la liste des métriques disponibles, consultez Métriques disponibles pour la surveillance des extensions de VM.
   4. Cliquez sur Appliquer.

Vous pouvez ajouter autant de graphiques que vous le souhaitez au tableau de bord. Pour en savoir plus, consultez Créer et gérer des tableaux de bord personnalisés.

Configurer des règles d'alerte

Monitoring vous permet de créer des alertes et de recevoir des notifications lorsqu'une métrique dépasse un seuil spécifié. Par exemple, vous pouvez recevoir une notification lorsque l'état de santé d'une extension passe à CRASHED.

1. Dans la Google Cloud console, sélectionnez Monitoring.

   Accéder à Monitoring

2. Dans le volet de navigation, sélectionnez Alertes.
3. Cliquez sur Créer une règle.
4. Sur la page Créer une règle d'alerte, définissez les conditions d'alerte et les canaux de notification.
   1. Pour sélectionner la métrique, développez le menu Sélectionner une métrique , puis procédez comme suit :
      1. Dans le champ Ressources actives, sélectionnez Instance de VM.
      2. Dans le champ Catégorie de métrique, sélectionnez Vm_extensions.
      3. Dans le champ Métrique, sélectionnez une métrique, par exemple État d'application de l'extension de VM. Pour obtenir la liste des métriques disponibles, consultez Métriques disponibles pour la surveillance des extensions de VM.
      4. Cliquez sur Appliquer.
   2. Configurez les conditions de déclenchement, par exemple en vérifiant si le libellé status est INSTALL_FAILED.
5. Suivez les instructions pour ajouter des canaux de notification et nommer la règle.
6. Cliquez sur Créer une règle.

Pour en savoir plus, consultez Créer des règles d'alerte.

Étape suivante

• Afficher les journaux des extensions de VM
• Gérer les extensions de VM à l'aide de règles d'extension
• En savoir plus sur Monitoring