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 des extensions. 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

Afficher les journaux d'extension de VM

Pour afficher les journaux des extensions de VM, utilisez la console Google Cloud , 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 période (par exemple, 2024-01-01T00:00:00Z).
    • END_TIME : fin de la période (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 commande logging read. 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 période (par exemple, 2024-01-01T00:00:00Z).
  • END_TIME : fin de la période (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 période (par exemple, 2024-01-01T00:00:00Z).
  • END_TIME : fin de la période (par exemple, 2024-02-01T00:00:00Z).
  • PROJECT_ID : ID de votre projet Google Cloud .

Entrée de journal d'événements 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 de l'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. Google choisit automatiquement la révision appropriée pour une VM spécifique. Fournir cet ID de révision à l'équipe d'assistance Google peut aider à déterminer si le bon binaire 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 avec succès, mais qu'elle a ensuite cessé de fonctionner.
  • INSTALL_FAILED : l'installation de l'extension a échoué.
  • INSTALLED : l'extension a été installée et démarrée avec succès.
  • ROLLBACK_FAILED : le rollback de l'extension a échoué.
  • ROLLED_BACK : le rollback de l'extension a réussi.
  • INCOMPATIBLE : aucun des candidats à la révision de l'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é.