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 von VM-Erweiterungen ansehen

Wenn Sie VM-Erweiterungslogs aufrufen möchten, 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.

    Beispielanfrage:

    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 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 Zeitbereichs, 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 Zeitbereichs, 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 .

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 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 neueste 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 dem Google-Supportteam diese Revisions-ID mitteilen, kann es leichter herausfinden, ob das richtige Binärprogramm für die VM ausgewählt wurde.
eventType Art des Ereignisses. Der Wert kann einer der folgenden sein:
  • 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: Der Rollback der Erweiterung ist fehlgeschlagen.
  • ROLLED_BACK: Das Rollback der Erweiterung war erfolgreich.
  • INCOMPATIBLE: Keiner 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.