Surveiller les jobs d'application de correctifs

Une fois que vous avez créé un job d'application de correctifs, vous pouvez utiliser Cloud Monitoring pour configurer des alertes permettant de surveiller le processus de correction.

Lorsqu'un job d'application de correctifs est créé, VM Manager publie l'état global de la VM dans l'API Cloud Monitoring. Cet état est publié toutes les minutes après le démarrage du job d'application de correctifs. La publication de l'état s'arrête 15 minutes après la fin du job d'application de correctifs.

Pour surveiller vos jobs d'application de correctifs à l'aide d'alertes, procédez comme suit :

  1. Démarrez un job d'application de correctifs. Consultez Créer des jobs d'application de correctifs.
  2. Configurez des métriques dans Cloud Monitoring pour votre job d'application de correctifs.
  3. Créez des alertes d'application de correctifs.

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 :

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la 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.

    2. Set a default region and zone.

    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. Une fois que la Google Cloud CLI est installée, initialisez-la 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.

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

Configurer les métriques

Dans cette section, vous configurez des métriques de suivi pour votre job d'application de correctifs à l'aide de l'explorateur de métriques. Pour plus d'informations sur l'utilisation de l'explorateur de métriques, consultez Sélectionner des métriques lorsque vous utilisez l'explorateur de métriques.

Vous pouvez utiliser Cloud Monitoring pour suivre les ressources de plusieurs projets. Pour afficher les métriques des jobs d'application de correctifs situés dans des projets distincts, ajoutez vos projets au même espace de travail de surveillance. Pour en savoir plus, consultez Afficher les métriques de plusieurs projets.

  1. Dans la console Google Cloud , accédez à la page Cloud Monitoring > Explorateur de métriques.

    Accéder à la page "Explorateur de métriques"

  2. Dans la section Sélectionner une métrique, sélectionnez Job d'application de correctifs.

  3. Sélectionnez la liste de catégorie de métrique active Correctif, puis sélectionnez État du correctif de l'instance de VM.

  4. Cliquez sur Appliquer.

  5. Examinez les métriques.

  6. Facultatif. Créez un graphique. Pour en savoir plus, consultez Créer un graphique avec l'explorateur de métriques.

Créer des alertes d'application de correctifs

Dans Cloud Monitoring, vous pouvez configurer une règle d'alerte qui fournit des notifications sur l'état du correctif afin que vous puissiez résoudre ces problèmes en temps opportun. Pour en savoir plus sur les règles d'alerte, consultez la Présentation des alertes.

États des correctifs d'instances de VM

Pour créer l'alerte pour les jobs d'application de correctifs, utilisez l'état du correctif de l'instance de VM comme condition de filtre de l'alerte. Les états de correctif d'instance de VM suivants sont disponibles :

  • ACKED : l'agent OS Config a reçu la notification d'application de correctifs, mais n'a pas encore commencé à appliquer les correctifs
  • APPLYING_PATCHES : l'agent OS Config applique les correctifs sur la VM
  • DOWNLOADING_PATCHES : l'agent OS Config télécharge les correctifs sur la VM
  • FAILED : le job d'application de correctifs a échoué
  • INACTIVE : la VM n'est pas en cours d'exécution
  • NO_AGENT_DETECTED : le service Patch ne peut pas communiquer avec l'agent OS Config sur la VM. Assurez-vous que vos VM sont correctement connectées. Pour en savoir plus, consultez Configurer VM Manager.
  • NOTIFIED : l'agent OS Config sur la VM est notifié, mais le job d'application de correctifs n'a pas démarré
  • PATCH_STATE_UNSPECIFIED : l'état du job d'application de correctifs est inconnu
  • PENDING : la VM n'a pas encore reçu de job d'application de correctifs. Cela se produit parce que le job d'application de correctifs a démarré récemment ou parce que la VM attend un déploiement progressif.
  • REBOOTING : la VM redémarre
  • RUNNING_PRE_PATCH_STEP : l'agent OS Config exécute les étapes préliminaires à l'application des correctifs
  • RUNNING_POST_PATCH_STEP : l'agent OS Config exécute les étapes consécutives à l'application des correctifs
  • STARTED : le job d'application de correctifs a démarré sur la VM
  • SUCCEEDED : le job d'application de correctifs s'est terminé avec succès
  • SUCCEEDED_REBOOT_REQUIRED : le job d'application de correctifs s'est terminé avec succès, mais un redémarrage de la VM est nécessaire
  • TIMED_OUT : le processus d'application de correctif a expiré

Exemple d'alerte d'application de correctifs

L'exemple suivant crée une alerte d'application de correctifs qui vous avertit en cas de défaillance de plus de cinq VM dans un job d'application de correctifs récent.

Vous pouvez créer des alertes à l'aide de la console Google Cloud ou de l'API Cloud Monitoring. L'exemple suivant utilise la console Google Cloud . Pour en savoir plus sur la création d'une alerte à l'aide de la console Google Cloud , consultez Créer une règle d'alerte.

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

    Accéder à Monitoring

  2. Dans le volet de navigation de Monitoring, cliquez sur Paramètres.

  3. Cliquez sur Créer une règle.

  4. Cliquez sur Ajouter une condition.

    1. Dans le menu déroulant Type de ressource, sélectionnez Job d'application de correctifs.
    2. Dans le menu déroulant Métrique, sélectionnez État du correctif d'instance de VM.
    3. Dans le champ Filtre, spécifiez state=FAILED.
    4. Dans la section Configuration, définissez Any time series violate = 5..
    5. Cliquez sur Ajouter.

      Configurer une alerte d'application de correctifs.

  5. Cliquez sur Suivant pour accéder à la section des notifications.

    1. Configurez des canaux de notification.

  6. Cliquez sur Suivant pour passer à la section de documentation.

    1. Définissez un nom de règle d'alerte
    2. Indiquez des instructions de correction

  7. Cliquez sur Enregistrer.

Étapes suivantes