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 aufrufen, um Probleme mit Ihren VM-Erweiterungen zu überwachen und zu beheben.

Hinweis

Logs für VM-Erweiterungen ansehen

Wählen Sie eine der folgenden Optionen aus, um VM-Erweiterungslogs aufzurufen:

Console

So rufen Sie VM-Erweiterungslogs in der Google Cloud Console auf:

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

    In der folgenden Beispielabfrage werden Logs für die Erweiterung ops-agent auf der Instanz 123456 gefiltert:

    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

Wenn Sie VM-Erweiterungslogs mit der Google Cloud CLI suchen möchten, führen Sie den Befehl logging read mit einem Filter für Ihre VM-Instanz und Erweiterung aus:

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="EXTENSION_NAME" AND \
    timestamp >= "START_TIME" AND \
    timestamp <= "END_TIME"'

Ersetzen Sie die folgenden Variablen durch Werte für Ihre Umgebung:

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

REST

Wenn Sie VM-Erweiterungslogs mithilfe der REST API abrufen möchten, senden Sie eine POST-Anfrage an die Logging V2 API mit dem Parameter filter im Anfragetext:

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 die folgenden Variablen durch Werte für Ihre Umgebung:

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

Ereignisprotokolleintrag für VM-Erweiterung

Das folgende JSON-Snippet zeigt einen Beispiel-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 in den Ereignisprotokollen der VM-Erweiterung angezeigt werden:

Feld Beschreibung
eventMessage Eine Nachricht, die das Ereignis beschreibt, einschließlich des Erzwingungsstatus und des Erweiterungszustands.
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 Erweiterungsversion, die VM Extension Manager für die Installation ausgewählt hat. Dieser Wert ist entweder die Version, die Sie in der Erweiterungsrichtlinie angepinnt haben, oder die neueste verfügbare Version.
revisionId Eine bestimmte Binärdatei einer Erweiterungsversion. Jede Erweiterungsversion kann mehrere Überarbeitungen haben, um verschiedene Betriebssysteme zu unterstützen. Google wählt automatisch die richtige Binärdatei für eine bestimmte VM aus. Wenn Sie sich an Cloud Customer Care wenden, geben Sie diese Revisions-ID an, damit geprüft werden kann, ob Google die richtige Binärdatei für Ihre VM ausgewählt hat.
eventType Art des Ereignisses. Mögliche Werte:
  • CRASHED: Die Erweiterung ist abgestürzt. Dieser Wert gibt an, dass der Gast-Agent die Erweiterung erfolgreich installiert und gestartet hat, die Erweiterung aber später nicht mehr ausgeführt wurde.
  • INSTALL_FAILED: Die Installation der Erweiterung ist fehlgeschlagen.
  • INSTALLED: Der Gast-Agent hat die Erweiterung 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 Erweiterungsversion erfüllt die Installationsanforderungen (z. B. Betriebssystem oder Architektur).
  • SERVICE_DISABLED: Der Dienst, für den diese Erweiterung erforderlich ist, ist deaktiviert.

Nächste Schritte