Logs von VM-Erweiterungen ansehen

Wenn Sie den VM Extension Manager verwenden, um Erweiterungen auf Ihren Compute Engine-Instanzen (VMs) zu verwalten, protokolliert der Gast-Agent auf jeder VM Ereignisse zur Erzwingung der Erweiterung. Mit Cloud Logging können Sie diese Logs im Log-Explorer ansehen, um Probleme mit Ihren VM-Erweiterungen zu beobachten und zu beheben.

Hinweis

Logs von VM-Erweiterungen ansehen

Verwenden Sie die Google Cloud Console, die Google Cloud CLI oder REST, um Logs von VM-Erweiterungen anzusehen.

Console

  1. Rufen Sie in der Console von Google Cloud die Seite Log-Explorer auf.

    Zum Log-Explorer

  2. Geben Sie im Feld Query die folgende Abfrage ein:

    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

    Ersetzen Sie Folgendes:

    • INSTANCE_ID: die ID der VM-Instanz.
    • EXTENSION_NAME: der Name der Erweiterung, z. B. ops-agent.
    • START_TIME: der Beginn des Zeitraums, z. B. 2024-01-01T00:00:00Z.
    • END_TIME: das Ende des Zeitraums, z. B. 2024-02-01T00:00:00Z.

    Beispielabfrage:

    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. Klicken Sie auf Abfrage ausführen.

gcloud

Verwenden Sie den logging read Befehl, um Logs von VM-Erweiterungen zu suchen. Beispiel:

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"'

Ersetzen Sie Folgendes:

  • INSTANCE_ID: die ID der VM-Instanz.
  • YOUR_EXTENSION_NAME: der Name der Erweiterung, z. B. ops-agent.
  • START_TIME: der Beginn des Zeitraums, z. B. 2024-01-01T00:00:00Z.
  • END_TIME: das Ende des Zeitraums, z. B. 2024-02-01T00:00:00Z.

REST

Stellen Sie eine Anfrage an die Logging V2 API. Der Anfragetext muss den Parameter filter enthalten. Beispiel:

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"
  ]
}

Ersetzen Sie Folgendes:

  • INSTANCE_ID: die ID der VM-Instanz.
  • EXTENSION_NAME: der Name der Erweiterung, z. B. ops-agent.
  • START_TIME: der Beginn des Zeitraums, z. B. 2024-01-01T00:00:00Z.
  • END_TIME: das Ende des Zeitraums, z. B. 2024-02-01T00:00:00Z.
  • PROJECT_ID: Ihre Google Cloud Projekt-ID.

Logeintrag für VM-Erweiterungsereignis

Das folgende Beispiel zeigt einen Logeintrag für ein VM-Erweiterungsereignis:

{
  "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"
}

Details zum Logeintrag

In der folgenden Tabelle werden die Parameter beschrieben, die in den Logs von VM-Erweiterungen enthalten sein können:

Feld Beschreibung
eventMessage Eine Nachricht, die das Ereignis beschreibt, einschließlich des Erzwingungsstatus und des Zustands der Erweiterung.
extensionName Der Name der Erweiterung, z. B. ops-agent.

Eine Liste der unterstützten Erweiterungen und ihrer Namen finden Sie unter Unterstützte Erweiterungen.
extensionVersion Die Version der Erweiterung, die für die Installation ausgewählt wurde. Diese Version ist entweder die in der Erweiterungsrichtlinie angepinnte Version oder die neueste Version, wenn keine Version angepinnt wurde.
revisionId Eine bestimmte Binärdatei einer Erweiterungsversion. Jede Erweiterungsversion kann mehrere Überarbeitungen haben, um verschiedene Betriebssysteme zu unterstützen, und Google wählt automatisch die richtige für eine bestimmte VM aus. Wenn Sie dem Google-Supportteam diese Überarbeitungs-ID mitteilen, kann es leichter herausfinden, ob die richtige Binärdatei für die VM ausgewählt wurde.
eventType Art des Ereignisses. Mögliche Werte:
  • CRASHED: Die Erweiterung ist abgestürzt. Dieser Wert gibt an, dass die Erweiterung einmal installiert und erfolgreich gestartet wurde, dann aber nicht mehr ausgeführt wurde.
  • INSTALL_FAILED: Die Installation der Erweiterung ist fehlgeschlagen.
  • INSTALLED: Die Erweiterung wurde installiert und erfolgreich gestartet.
  • ROLLBACK_FAILED: Das Rollback der Erweiterung ist fehlgeschlagen.
  • ROLLED_BACK: Das Rollback der Erweiterung war erfolgreich.
  • INCOMPATIBLE: Keine der Kandidaten für die Erweiterungsüberarbeitung erfüllt die Installationsanforderungen (z. B. Betriebssystem oder Architektur).
  • SERVICE_DISABLED: Der Dienst, für den diese Erweiterung erforderlich ist, ist deaktiviert.