Afficher les journaux d'extension de VM

Lorsque vous utilisez VM Extension Manager pour gérer les extensions sur vos instances Compute Engine (VM), l'agent invité de chaque VM enregistre les événements liés à l'application de l'extension. Utilisez Cloud Logging pour afficher ces journaux dans l'explorateur de journaux afin de surveiller et de résoudre les problèmes liés à vos extensions de VM.

Avant de commencer

  • Consultez la documentation de VM Extension Manager.
  • Découvrez comment utiliser l'explorateur de journaux.
  • 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.

  • 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.

Afficher les journaux d'extension de VM

Pour afficher les journaux d'extension de VM, utilisez la Google Cloud console, la Google Cloud CLI ou REST.

Console

  1. Dans la console Google Cloud , accédez à la page Explorateur de journaux.

    Accéder à l'explorateur de journaux

  2. Dans le champ Requête, saisissez la requête suivante :

    resource.type="gce_instance"
resource.labels.instance_id="INSTANCE_ID"
jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent"
jsonPayload.extensionName="EXTENSION_NAME"
timestamp >= START_TIME
timestamp <= END_TIME

    Remplacez les éléments suivants :

    • INSTANCE_ID : ID de l'instance de VM.
    • EXTENSION_NAME: nom de l'extension (par exemple, ops-agent).
    • START_TIME: début de la plage de dates (par exemple, 2024-01-01T00:00:00Z).
    • END_TIME: fin de la plage de dates (par exemple, 2024-02-01T00:00:00Z).

    Exemple de requête :

    resource.type="gce_instance"
resource.labels.instance_id="projects/7654321/zones/us-central1-a/instances/123456"
jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent"
jsonPayload.extensionName="ops-agent"
timestamp >= "2024-01-01T00:00:00Z"
timestamp <= "2024-02-01T01:00:00Z"

  3. Cliquez sur Exécuter la requête.

gcloud

Pour rechercher les journaux d'extension de VM, utilisez la logging read commande. Exemple :

gcloud logging read 'resource.type="gce_instance" AND \
    resource.labels.instance_id="INSTANCE_ID" AND \
    jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent" AND \
    jsonPayload.extensionName="YOUR_EXTENSION_NAME" AND \
    timestamp >= "START_TIME" AND \
    timestamp <= "END_TIME"'

Remplacez les éléments suivants :

  • INSTANCE_ID : ID de l'instance de VM.
  • YOUR_EXTENSION_NAME: nom de l'extension (par exemple, ops-agent).
  • START_TIME: début de la plage de dates (par exemple, 2024-01-01T00:00:00Z).
  • END_TIME: fin de la plage de dates (par exemple, 2024-02-01T00:00:00Z).

REST

Envoyez une requête à l'API Logging V2. Le corps de la requête doit contenir le paramètre filter. Exemple :

POST https://logging.googleapis.com/v2/entries:list

{
  "filter": "resource.type="gce_instance" AND
            "resource.labels.instance_id="INSTANCE_ID" AND
            "jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent" AND
            "jsonPayload.extensionName="EXTENSION_NAME" AND
            "timestamp >= "START_TIME" AND
            "timestamp <= "END_TIME",
  "pageSize": 10,
  "resourceNames": [
    "projects/PROJECT_ID"
  ]
}

Remplacez les éléments suivants :

  • INSTANCE_ID : ID de l'instance de VM.
  • EXTENSION_NAME: nom de l'extension (par exemple, ops-agent).
  • START_TIME: début de la plage de dates (par exemple, 2024-01-01T00:00:00Z).
  • END_TIME: fin de la plage de dates (par exemple, 2024-02-01T00:00:00Z).
  • PROJECT_ID: ID de votre Google Cloud projet.

Entrée de journal d'événement d'extension de VM

Voici un exemple d'entrée de journal pour un événement d'extension de VM :

{
  "insertId": "rsiudxbck",
  "jsonPayload": {
    "eventMessage": "Enforcement State: Installing ops-agent@4bda61add3e5c989.; Extension Health: Plugin is running ok",
    "timestamp": "2026-03-23T16:13:40.496755675Z",
    "extensionName": "ops-agent",
    "revisionId": "4bda61add3e5c989",
    "@type": "type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent",
    "eventType": "INSTALLED"
  },
  "resource": {
    "type": "gce_instance",
    "labels": {
      "project_id": "27654321",
      "instance_id": "projects/7654321/zones/us-west1-a/instances/1234567",
      "zone": "us-west1-a"
    }
  },
  "timestamp": "2026-03-23T16:13:40.496854498Z",
  "severity": "INFO",
  "logName": "projects/my-project/logs/compute.googleapis.com%2Fvm_extension_policies",
  "receiveTimestamp": "2026-03-23T16:13:40.906133199Z"
}

Détails de l'entrée de journal

Le tableau suivant décrit les paramètres que vous pouvez trouver dans les journaux d'extension de VM :

Champ Description
eventMessage Message décrivant l'événement, y compris l'état d'application et l'état de l'extension.
extensionName Nom de l'extension (par exemple, ops-agent).

Pour obtenir la liste des extensions compatibles et de leurs noms, consultez Extensions compatibles.
extensionVersion Version de l'extension sélectionnée pour l'installation. Il s'agit de la version épinglée dans la règle d'extension ou de la dernière version si aucune version n'a été épinglée.
revisionId Binaire spécifique d'une version d'extension. Chaque version d'extension peut comporter plusieurs révisions pour prendre en charge différents systèmes d'exploitation, et Google choisit automatiquement la version appropriée pour une VM spécifique. Fournir cet ID de révision à l'équipe d'assistance Google peut aider à déterminer si le binaire approprié a été choisi pour la VM.
eventType Type d'événement. Il peut s'agir de l'une des valeurs suivantes :
  • CRASHED : l'extension a planté. Cette valeur indique que l'extension a été installée et démarrée correctement, mais qu'elle a ensuite cessé de s'exécuter.
  • INSTALL_FAILED : l'installation de l'extension a échoué.
  • INSTALLED : l'extension est installée et a démarré correctement.
  • ROLLBACK_FAILED : la restauration de l'extension a échoué.
  • ROLLED_BACK : la restauration de l'extension a réussi.
  • INCOMPATIBLE : aucun des candidats de révision d'extension ne répond aux exigences d'installation (par exemple, système d'exploitation ou architecture).
  • SERVICE_DISABLED : le service nécessitant cette extension est désactivé.