Gérer la PMU dans les VM

Ce document explique comment modifier le type d'unité de surveillance des performances (PMU) activé dans une instance de machine virtuelle (VM) ou le désactiver. Pour en savoir plus sur la PMU, consultez la présentation de la PMU.

Une fois que vous avez activé la PMU dans une VM et exécuté un logiciel de surveillance des performances sur la VM, vous pouvez effectuer les opérations suivantes :

  • Modifiez le type de PMU activé dans la VM. Cette modification est utile lorsque vous souhaitez suivre différents types d'événements CPU de bas niveau.

  • Désactivez la PMU dans la VM. Cette action est utile lorsque vous n'avez plus besoin d'accéder aux compteurs de performances dans l'unité PMU.

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:

    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 .

Rôles requis

Pour obtenir les autorisations nécessaires pour modifier le type de PMU activé dans une VM ou le désactiver, demandez à votre administrateur de vous accorder le rôle IAM Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour modifier le type de PMU activé dans une VM ou le désactiver. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Vous devez disposer des autorisations suivantes pour modifier le type de PMU activé dans une VM ou le désactiver :

  • Pour mettre à jour une VM : compute.instances.update sur la VM

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Modifier le type de PMU dans une VM

Avant de modifier le type de PMU activé dans une VM C4A ou C4 existante, affichez les détails de la VM à l'aide de la CLI gcloud ou de l'API REST Google Cloud. Dans le résultat de la commande ou de la requête API, vérifiez les points suivants :

  1. Pour vérifier le type de PMU activé dans la VM, vérifiez la valeur du champ performanceMonitoringUnit. Si le champ est manquant, l'unité PMU est désactivée.

  2. Si vous souhaitez activer le type PMU amélioré, assurez-vous que la VM utilise un type de machine C4 avec 96 ou 192 processeurs virtuels en vérifiant la valeur du champ machineType. Si ce n'est pas le cas, modifiez le type de machine de la VM.

Vous n'avez pas besoin d'arrêter la VM pour modifier le type de PMU activé. Toutefois, pour que la modification prenne effet, vous devez redémarrer la VM comme décrit dans cette section.

Pour modifier le type de PMU activé dans une VM existante, sélectionnez l'une des options suivantes :

gcloud

  1. Créez un fichier YAML vide.

  2. Pour exporter les propriétés d'une VM dans le fichier YAML que vous venez de créer, utilisez la commande gcloud compute instances export :

    gcloud compute instances export VM_NAME \
    --destination=YAML_FILE \
    --zone=ZONE

    Remplacez les éléments suivants :

    • VM_NAME : Nom de la VM.

    • YAML_FILE : chemin d'accès au fichier YAML que vous avez créé à l'étape précédente.

    • ZONE : zone où se trouve la VM.

  3. Dans le fichier de configuration YAML, recherchez le champ performanceMonitoringUnit et modifiez sa valeur pour spécifier un autre type de PMU :

    advancedMachineFeatures:
  performanceMonitoringUnit: PMU_TYPE

    Remplacez PMU_TYPE par l'une des valeurs suivantes :

    • Type de PMU architectural : ARCHITECTURAL

    • Type de PMU standard : STANDARD

    • Type de PMU amélioré : ENHANCED

  4. Pour mettre à jour la VM et la redémarrer, utilisez la commande gcloud compute instances update-from-file avec l'option --most-disruptive-allowed-action définie sur RESTART :

    gcloud compute instances update-from-file VM_NAME \
    --most-disruptive-allowed-action=RESTART \
    --source=YAML_FILE \
    --zone=ZONE

    Remplacez les éléments suivants :

    • VM_NAME : Nom de la VM.

    • YAML_FILE : chemin d'accès au fichier YAML contenant les données de configuration que vous avez modifiées à l'étape précédente.

    • ZONE : zone où se trouve la VM.

REST

  1. Créez un fichier JSON vide.

  2. Pour afficher les propriétés d'une VM existante, envoyez une requête GET à la méthode instances.get :

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet dans lequel se trouve la VM.

    • ZONE : zone où se trouve la VM.

    • VM_NAME : nom d'une VM existante.

  3. Dans le fichier JSON vide que vous avez créé lors des étapes précédentes, procédez comme suit :

    1. Saisissez les propriétés de la VM à partir de la sortie de la requête GET.

    2. Recherchez le champ performanceMonitoringUnit, puis modifiez sa valeur pour spécifier un autre type de PMU :

      "advancedMachineFeatures": {
  "performanceMonitoringUnit": "PMU_TYPE"
}

      Remplacez PMU_TYPE par l'une des valeurs suivantes :

      • Type de PMU architectural : ARCHITECTURAL

      • Type de PMU standard : STANDARD

      • Type de PMU amélioré : ENHANCED

  4. Pour mettre à jour la VM et la redémarrer, envoyez une requête PUT à la méthode instances.update. Dans la requête, procédez comme suit :

    • Dans l'URL de la requête, incluez le paramètre de requête mostDisruptiveAllowedAction défini sur RESTART.

    • Pour le corps de la requête, utilisez les propriétés de la VM du fichier JSON que vous avez créé et mis à jour aux étapes précédentes.

    La requête se présente comme suit :

    PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME?mostDisruptiveAllowedAction=RESTART

{
  "advancedMachineFeatures": {
    "performanceMonitoringUnit": "PMU_TYPE"
  },
  ...
}

Pour en savoir plus sur la mise à jour des propriétés d'une VM, consultez la section Mettre à jour les propriétés d'une VM.

Désactiver la PMU dans une VM

Vous n'avez pas besoin d'arrêter la VM pour désactiver la PMU. Toutefois, pour que la modification prenne effet, vous devez redémarrer la VM comme décrit dans cette section.

Pour désactiver la PMU dans une VM existante, sélectionnez l'une des options suivantes :

gcloud

  1. Créez un fichier YAML vide.

  2. Pour exporter les propriétés d'une VM dans le fichier YAML que vous venez de créer, utilisez la commande gcloud compute instances export :

    gcloud compute instances export VM_NAME \
    --destination=YAML_FILE \
    --zone=ZONE

    Remplacez les éléments suivants :

    • VM_NAME : Nom de la VM.

    • YAML_FILE : chemin d'accès au fichier YAML que vous avez créé à l'étape précédente.

    • ZONE : zone où se trouve la VM.

  3. Dans le fichier de configuration YAML, recherchez le champ performanceMonitoringUnit et définissez sa valeur sur NONE :

    advancedMachineFeatures:
  performanceMonitoringUnit: NONE

  4. Pour mettre à jour la VM et la redémarrer, utilisez la commande gcloud compute instances update-from-file avec l'option --most-disruptive-allowed-action définie sur RESTART :

    gcloud compute instances update-from-file VM_NAME \
    --most-disruptive-allowed-action=RESTART \
    --source=YAML_FILE \
    --zone=ZONE

    Remplacez les éléments suivants :

    • VM_NAME : Nom de la VM.

    • YAML_FILE : chemin d'accès au fichier YAML contenant les données de configuration que vous avez modifiées à l'étape précédente.

    • ZONE : zone où se trouve la VM.

REST

  1. Créez un fichier JSON vide.

  2. Pour afficher les propriétés d'une VM existante, envoyez une requête GET à la méthode instances.get :

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet dans lequel se trouve la VM.

    • ZONE : zone où se trouve la VM.

    • VM_NAME : nom d'une VM existante.

  3. Dans le fichier JSON vide que vous avez créé lors des étapes précédentes, procédez comme suit :

    1. Saisissez les propriétés de la VM à partir de la sortie de la requête GET.

    2. Recherchez le champ performanceMonitoringUnit, puis remplacez sa valeur par NONE :

      "advancedMachineFeatures": {
  "performanceMonitoringUnit": "NONE"
}

  4. Pour mettre à jour la VM et la redémarrer, envoyez une requête PUT à la méthode instances.update. Dans la requête, procédez comme suit :

    • Dans l'URL de la requête, incluez le paramètre de requête mostDisruptiveAllowedAction défini sur RESTART.

    • Pour le corps de la requête, utilisez les propriétés de la VM du fichier JSON que vous avez créé et mis à jour aux étapes précédentes.

    La requête se présente comme suit :

    PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME?mostDisruptiveAllowedAction=RESTART

{
  "advancedMachineFeatures": {
    "performanceMonitoringUnit": "NONE"
  },
  ...
}

Pour en savoir plus sur la mise à jour des propriétés d'une VM, consultez la section Mettre à jour les propriétés d'une VM.

Étapes suivantes