Surveiller les extensions de VM

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. La surveillance de l'état des extensions et de la consommation des ressources vous aide à suivre l'utilisation du processeur et de la mémoire, et à détecter les échecs d'installation ou d'exécution dans votre parc de VM.

Dans ce document, vous allez apprendre à effectuer les tâches suivantes :

• Consultez 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 services et aux API Google Cloud . 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 console Google Cloud pour accéder aux services et aux API Google Cloud , vous n'avez pas besoin de configurer l'authentification.

  gcloud

  1. Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez la Google Cloud CLI en exécutant la commande suivante :

     gcloud init

     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, puis connectez-vous à 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'authentification Google Cloud .

Avant de commencer

Avant de surveiller vos extensions, assurez-vous de remplir les conditions préalables suivantes :

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

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour surveiller les métriques, créer des tableaux de bord et configurer des règles d'alerte, 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, créer des tableaux de bord et configurer des règles d'alerte, 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, créer des tableaux de bord et configurer des règles d'alerte. 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, créer des tableaux de bord et configurer des règles d'alerte :

• 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, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via 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'extensions, 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 l'extension de VM	compute.googleapis.com/vm_extensions/extension/health_status	État d'une extension de VM. Les libellés incluent extension_name et status. Pour obtenir la liste des noms d'extensions, consultez Extensions compatibles. Les valeurs possibles pour status sont les suivantes : HEALTH_STATUS_UNSPECIFIED STARTING RUNNING STOPPING STOPPED CRASHED
Utilisation maximale du processeur par 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.
Nombre maximal d'octets de mémoire utilisés par l'extension de VM	compute.googleapis.com/vm_extensions/extension/memory/used_bytes	Mémoire maximale utilisée par 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 console Google Cloud , 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 une métrique, développez le menu Sélectionner une métrique, puis procédez comme suit :
   1. Pour Ressources actives, sélectionnez Instance de VM.
   2. Dans le champ Catégorie de métrique, sélectionnez Vm_extensions.
   3. Pour Métrique, sélectionnez une métrique, par exemple État de l'extension de VM. Pour obtenir la liste des métriques disponibles, consultez Métriques disponibles pour les 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 d'une extension passe à CRASHED.

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

1. Dans la console Google Cloud , 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, configurez la condition d'alerte en procédant comme suit :
   1. Pour sélectionner une métrique, développez le menu Sélectionner une métrique, puis procédez comme suit :
      1. Pour Ressources actives, sélectionnez Instance de VM.
      2. Dans le champ Catégorie de métrique, sélectionnez Vm_extensions.
      3. Pour 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 les extensions de VM.
      4. Cliquez sur Appliquer.
   2. Configurez les conditions de déclenchement, par exemple si l'étiquette status est égale à 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.

Étapes suivantes

• Pour inspecter la progression du déploiement et l'état de l'extension, consultez Afficher les détails et l'état d'une extension de VM.
• Pour interroger l'historique des événements d'application et auditer les enregistrements d'installation ou de plantage dans Cloud Logging, consultez Afficher les journaux des extensions de VM.
• Pour diagnostiquer les échecs de déploiement, vérifier les processus invités en cours d'exécution ou inspecter les journaux de débogage de l'agent invité, consultez Résoudre les problèmes liés aux extensions de VM.
• Pour modifier les paramètres de configuration, changer les versions épinglées ou supprimer les agents déployés, consultez Gérer les extensions de VM à l'aide de règles d'extension.