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 überwachen und zu beheben.

Hinweis

Logs von VM-Erweiterungen ansehen

Zum Aufrufen von VM-Erweiterungslogs verwenden Sie die Google Cloud Console, die Google Cloud CLI oder REST.

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="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 Befehl logging read, um VM-Erweiterungslogs aufzurufen. 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: Projekt-ID in Google Cloud .

Protokolleintrag 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": "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 Sie in den VM-Erweiterungslogs finden können:

Feld Beschreibung
eventMessage Eine Nachricht, in der das Ereignis beschrieben wird, einschließlich des Durchsetzungsstatus und des Status 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 aktuelle Version, wenn keine Version angepinnt wurde.
revisionId Ein bestimmtes Binärprogramm einer Erweiterungsversion. Jede Erweiterungsversion kann mehrere Überarbeitungen haben, um verschiedene Betriebssysteme zu unterstützen. Google wählt automatisch die richtige für eine bestimmte VM aus. Wenn Sie diese Revisions-ID an das Google-Supportteam weitergeben, kann es leichter feststellen, ob die richtige Binärdatei für die VM ausgewählt wurde.
eventType Art des Ereignisses. Das Attribut kann einen der folgenden Werte annehmen:
  • 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 wurde erfolgreich durchgeführt.
  • INCOMPATIBLE: Keiner der Kandidaten für die Erweiterungsrevision erfüllt die Installationsanforderungen (z. B. Betriebssystem oder Architektur).
  • SERVICE_DISABLED: Der Dienst, für den diese Erweiterung erforderlich ist, ist deaktiviert.