Aktivitätslogs aufrufen

Compute Engine-Aktivitätslogs sind veraltet. Verwenden Sie stattdessen Audit-Logs. Weitere Informationen finden Sie unter Von Aktivitätslogs zu Audit-Logs migrieren.

Compute Engine-Aktivitätslogs sind nicht das Gleiche wie Audit-Logs. Audit-Logs enthalten dieselben Informationen wie Legacy-Aktivitätslogs und noch mehr. Wir empfehlen, anstelle von Aktivitätslogs Audit-Logs zu verwenden. Wenn Sie bereits Aktivitätslogs verwenden, lesen Sie Von Aktivitätslogs zu Audit-Logs migrieren.

Compute Engine stellt Aktivitätslogs bereit, mit denen Sie bestimmte Ereignisse wie API-Aufrufe und Systemereignisse verfolgen können, die sich auf Ihr Projekt auswirken. Im Einzelnen bieten Aktivitätslogs Informationen zu Folgendem:

• Compute Engine API-Aufrufe: GCE_API_CALL-Ereignisse sind API-Aufrufe, durch die der Zustand einer Ressource geändert wird. In Aktivitätslogs werden beispielsweise API-Aufrufe zum Erstellen eines Datenträgers, zum Aktualisieren von Instanzmetadaten, zum Erstellen einer Instanzgruppe und zum Ändern eines Maschinentyps erfasst. API-Aufrufe, die eine Ressource nicht aktualisieren, wie beispielsweise get- und list-Anfragen, werden nicht erfasst.
• Vorgangslogs: GCE_OPERATION_DONE-Ereignisse werden protokolliert, wenn ein API-Aufruf für Änderungen am Status einer Ressource beendet wird. Compute Engine meldet dann ein abgeschlossenes Vorgangsereignis, das in Ihren Aktivitätslogs erfasst wird.
• Systemlog: GCE_SYSTEM_EVENT-Ereignisse werden protokolliert, wenn Compute Engine ein Systemereignis ausführt. Dies wird im Aktivitätslog erfasst. Zum Beispiel wird ein transparentes Wartungsereignis als Systemereignis protokolliert.

Bei einem API-Ereignis enthält ein Aktivitätslog beispielsweise Informationen wie die Start- und Endzeit eines API-Aufrufs, die Einzelheiten des Abfragetexts, den autorisierten Nutzer, der die API-Abfrage gestellt hat, und den Endpunkt der Abfrage. Sie können Aktivitätsprotokolle herunterladen, um nach bestimmten API-Abfragen zu suchen oder von Compute Engine initiierte Systemereignisse zu überprüfen.

Aktivitätsprotokolle liefern keine Abrechnungs- oder Nutzungsinformationen zu einem Projekt, etwa wie lange eine VM-Instanz bereits ausgeführt wird oder wie viel sie kostet. Weitere Informationen zu Abrechnungslogs finden Sie unter Abrechnungsdaten exportieren. Weitere Informationen zu Nutzungslogs finden Sie unter Nutzungsberichte ansehen.

Aktivitätslogs werden als Teil des Cloud Logging-Dienstes bereitgestellt. Weitere Informationen zu Logging im Allgemeinen finden Sie in der Dokumentation zu Cloud Logging.

Hinweise

• Machen Sie sich mit Cloud Logging vertraut.
• Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud-Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren.
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

  2. Set a default region and zone.

  REST

  Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

  Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie die folgende Berechtigung:

• logging.logServiceIndexes.list für das Projekt
• logging.logServices.list für das Projekt

Logs ansehen

Die Protokollierung von Aktivitäten ist für alle Compute Engine-Projekte standardmäßig aktiviert.

Die Aktivitätslogs Ihres Projekts finden Sie im Log-Explorer der Google Cloud Console:

1. Rufen Sie in der Google Cloud Console die Seite Logging auf.

   Zur Seite "Logging"

2. Wählen Sie im Log Explorer den Ressourcentyp aus der ersten Drop-down-Liste aus und filtern Sie danach.
3. Wählen Sie in der Drop-down-Liste Alle Logs die Option compute.googleapis.com/activity_log aus, um Compute Engine-Aktivitätsprotokolle anzeigen zu lassen.

Routing-Logs

Informationen zum Exportieren von Aktivitätslogs finden Sie in der Cloud Logging-Dokumentation unter Senken konfigurieren und verwalten.

Logdateien identifizieren

Wenn Sie Logs in Cloud Storage exportieren, werden die Logdateien in der Struktur gespeichert, die in der Dokumentation zu Logeintragsobjekten beschrieben wird.

Compute Engine-Logdateien werden mit der folgenden Verzeichnisstruktur gespeichert:

<bucket>/compute.googleapis.com/activity_log/<year>/<month>/<day>

Der folgende Beispiel-Logdateiname ist in einem Cloud Storage-Bucket namens my-bucket gespeichert:

my-bucket/compute.googleapis.com/activity_log/2014/10/31/20:00:00_20:59:59_S0.json

In BigQuery werden Aktivitätslogs in einer Reihe von Tabellen gespeichert (eine Tabelle je Logtyp und Tag) und die Tabellen sind im folgenden Format benannt:

<dataset>.compute_googleapis_com_activity_log_YYYYMMDD

Informationen zum Abfragen von Aktivitätslogs in BigQuery finden Sie unter Logeinträge in BigQuery.

Aktivitätslogs lesen

Aktivitätslogs werden in der Dokumentation Logeintragstypen beschrieben.

Compute Engine-Aktivitätsprotokolle haben:

• compute.googleapis.com/activity_log als Wert des Feldes log
• metadata, womit allgemeine Informationen wie der Zeitstempel beschrieben werden
• structPayload mit den spezifischen Inhalten des Logeintrags

Weitere Informationen zu den allgemeinen Feldern, die für jeden Logeintrag angegeben werden, finden SIe in der LogEntry-Beschreibung. Die Nutzlastinhalte von Aktivitätslogeinträgen sind jedoch spezifisch für Compute Engine und werden unten beschrieben.

Payload-Inhalte

Die Inhalte eines Logeintrags werden im JSON-Objektformat bereitgestellt und im Feld structPayload gespeichert. Das Feld structPayload enthält die folgenden Informationen:

"request": {
  "url": "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances\",
  "body": "{
    \"canIpForward\":"false",
    \"description\":\"\",
    \"disks\":[{
      \"autoDelete\":true,
      \"boot\":true,
      \"deviceName\":\"example-instance\",
      \"initializeParams\":{
        \"diskSizeGb\":\"10\",
        \"diskType\":\"https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/diskTypes/pd-standard\",
        \"sourceImage\":\"https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-8-jessie-v20150818\"
      },
      \"mode\":\"READ_WRITE\",
      \"type\":\"PERSISTENT\"
    }],
    \"machineType\":\"https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/machineTypes/n1-standard-1\",
    \"metadata\":{
      \"items\":[]
    },
    \"name\":\"example-instance\",
    \"networkInterfaces\":[{
        \"accessConfigs\":[{
          \"name\":\"External NAT\",
          \"type\":\"ONE_TO_ONE_NAT\"
        }],
        \"network\":\"https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default\"
      }],
    \"scheduling\":{
      \"automaticRestart\":true,
      \"onHostMaintenance\":\"MIGRATE\",
      \"preemptible\":false
    },
    \"serviceAccounts\":[{
      \"email\":\"default\",
      \"scopes\":[
        \"https://www.googleapis.com/auth/devstorage.read_only\",
        \"https://www.googleapis.com/auth/logging.write\"
      ]
    }],
    \"tags\":{
      \"items\":[]
    },
    \"zone\":\"https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f\"
  }"
}

"resource": {
  "type": "instance",
  "name": "example-instance",
  "id": "0",
  "zone": "us-central1-f"
}

trace_id: "operation-1442436581415-51fe3700bd85a-7fd317e3-f1a3555e"

Beispiellogeintrag

Ein Beispiellogeintrag, der eine API-Anfrage zum Erstellen einer VM beschreibt, sieht beispielsweise so aus:

{
  "log": "compute.googleapis.com/activity_log",
  "insertId": "2015-09-16|13:49:42.532185-07|10.106.9.208|335899593",
  "metadata": {
    "severity": "INFO",
    "projectId": "835469197146",
    "serviceName": "compute.googleapis.com",
    "zone": "us-central1-f",
    "labels":{
      "compute.googleapis.com/resource_id":"0",
      "compute.googleapis.com/resource_name":"example-instance",
      "compute.googleapis.com/resource_type":"instance",
      "compute.googleapis.com/resource_zone":"us-central1-f"
    },
    "timestamp": "2015-09-16T20:49:42.423637Z"
  },
  "structPayload": {
    "version": "1.2",
    "trace_id": "operation-1442436581415-51fe3700bd85a-7fd317e3-f1a3555e",
    "event_timestamp_us": "1442436582423637",
    "event_type": "GCE_API_CALL",
    "event_subtype": "compute.instances.insert",
    "resource": {
      "type": "instance",
      "name": "example-instance",
      "id": "0",
      "zone": "us-central1-f"
    },
    "actor": {
      "user": "user@example.com"
    },
    "ip_address": "",
    "user_agent": "apitools-client/1.0",
    "request": {
      "url": "https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances",
      "body": "{
        \"canIpForward\":false,
        \"description\":\"\",
        \"disks\":[{
          \"autoDelete\":true,
          \"boot\":true,
          \"deviceName\":\"example-instance\",
          \"initializeParams\":{
            \"diskSizeGb\":\"10\",
            \"diskType\":\"https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/diskTypes/pd-standard\",
            \"sourceImage\":\"https://www.googleapis.com/compute/v1/projects/debian-cloud/global/images/debian-8-jessie-v20150818\"
          },
          \"mode\":\"READ_WRITE\",
          \"type\":\"PERSISTENT\"
        }],
        \"machineType\":\"https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/machineTypes/n1-standard-1\",
        \"metadata\":{
          \"items\":[]
        },
        \"name\":\"example-instance\",
        \"networkInterfaces\":[{
            \"accessConfigs\":[{
              \"name\":\"External NAT\",
              \"type\":\"ONE_TO_ONE_NAT\"

            }],
            \"network\":\"https://www.googleapis.com/compute/v1/projects/myproject/global/networks/default\"
          }],
        \"scheduling\":{
          \"automaticRestart\":true,
          \"onHostMaintenance\":\"MIGRATE\",
          \"preemptible\":false
        },
        \"serviceAccounts\":[{
          \"email\":\"default\",
          \"scopes\":[
            \"https://www.googleapis.com/auth/devstorage.read_only\",
            \"https://www.googleapis.com/auth/logging.write\"
          ]
        }],
        \"tags\":{
          \"items\":[]
        },
        \"zone\":\"https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f\"
      }"
    },
    "operation": {
      "type": "operation",
      "name": "operation-1442436581415-51fe3700bd85a-7fd317e3-f1a3555e",
      "id": "291347737657178184",
      "zone": "us-central1-f"
    }
  }
}

Verworfene Aktivitätslogeinträge

Die folgenden Aktivitätslogeinträge werden am 1. Juni 2020 ersatzlos eingestellt: