Übertragungslogs lesen

Auf dieser Seite wird beschrieben, wie Sie Cloud Logging for Storage Transfer Service-Logs und das Format der Logs aufrufen. Informationen zum Konfigurieren von Storage Transfer Service-Logs finden Sie unter Konfigurieren von Übertragungslogs.

Informationen zum Transfer Service for On Premises Data-Logs finden Sie unter Übertragung für lokales Logformat.

Hinweis

Prüfen Sie zuerst, ob Sie Zugriff auf Cloud Logging haben. Wir empfehlen die Identitäts- und Zugriffsverwaltungsrolle Logbetrachter (roles/logging.viewer). Weitere Informationen zum Logging-Zugriff finden Sie unter Zugriffssteuerung mit IAM.

Im Folgenden wird beschrieben, wie Sie den IAM-Zugriff überprüfen und gewähren:

Sehen Sie sich die aktuellen Zugriffsrechte an, um den Zugriff der einzelnen Hauptkonten zu prüfen.
Weisen Sie den entsprechenden Hauptkonten in Ihrem Projekt eine Rolle zu.

Logs ansehen

So rufen Sie Übertragungslogs auf:

Google Cloud Console

Rufen Sie das Google Cloud-Navigationsmenü auf und wählen Sie Logging > Log-Explorer aus:<br\></br\>

Zu „Log-Explorer“
Wählen Sie ein Cloud-Projekt aus.
Wechseln Sie im Menü Upgrade von Legacy-Loganzeige zu Log-Explorer.
Wenn Sie Ihre Logs so filtern möchten, dass nur Storage Transfer Service-Einträge angezeigt werden, geben Sie in das Abfragefeld storage_transfer_job ein und klicken Sie auf Abfrage ausführen.
Klicken Sie im Bereich Abfrageergebnisse auf Zeit bearbeiten, um den Zeitraum zu ändern, für den Ergebnisse zurückgegeben werden sollen.

Informationen zur Verwendung des Log-Explorers finden Sie unter Log-Explorer verwenden.

Cloud Logging API

Verwenden Sie die Cloud Logging API-Methode entries.list.

Verwenden Sie das Feld filter, um Ihre Ergebnisse so zu filtern, dass nur Einträge in Storage Transfer Service enthalten sind. Unten finden Sie ein Beispiel für ein JSON-Anfrageobjekt.

{
"resourceNames":
  [
    "projects/my-project-name"
  ],
  "orderBy": "timestamp desc",
  "filter": "resource.type=\"storage_transfer_job\""
}

gcloud-CLI

Wenn Sie mit dem gcloud-Befehlszeilentool nach Logs des Storage Transfer Service suchen möchten, verwenden Sie den Befehl gcloud logging read.

Geben Sie einen Filter an, um Ihre Ergebnisse auf Storage Transfer Service-Logs zu beschränken.

gcloud logging read "resource.type=storage_transfer_job"

Format von Übertragungslogs

Im folgenden Abschnitt werden die Felder für Storage Transfer Service-Logs beschrieben:

Alle spezifischen Felder für Storage Transfer Service sind in einem jsonPayload-Feld enthalten.

`FIND`-Aktionen

jsonPayload: {
  @type: "type.googleapis.com/google.storagetransfer.logging.TransferActivityLog"
  action: "FIND"
  completeTime: "2021-12-16T18:58:49.344509695Z"
  destinationContainer: {
    gcsBucket: {
      bucket: "my-bucket-2"
    }
    type: "GCS"
  }
  operation: "transferOperations/transferJobs-7876027868280507149--3019866490856027148"
  sourceContainer: {
    gcsBucket: {
      bucket: "my-bucket-1"
    }
    type: "GCS"
  }
  status: {
    statusCode: "OK"
  }
}

`COPY`- und `DELETE`-Aktionen

jsonPayload: {
  @type: "type.googleapis.com/google.storagetransfer.logging.TransferActivityLog"
  action: "COPY"
  completeTime: "2021-12-16T18:59:00.510509049Z"
  destinationObject: {
    gcsObject: {
      bucket: "my-bucket-2"
      objectKey: "README.md"
    }
    type: "GCS"
  }
  operation: "transferOperations/transferJobs-7876027868280507149--3019866490856027148"
  sourceObject: {
    gcsObject: {
      bucket: "my-bucket-1"
      lastModifiedTime: "2021-12-07T16:41:09.456Z"
      md5: "WgnCOIdfCXNTUDpQJSKb2w=="
      objectKey: "README.md"
    }
    type: "GCS"
  }
  status: {
    statusCode: "OK"
  }
}

Logfeld	Beschreibung

`@type`	Der Wert ist immer `type.googleapis.com/google.storagetransfer.logging.TransferActivityLog`
`action`	Beschreibt die Aktion dieser bestimmten Aufgabe. Beispiele: `FIND`: Zu suchende Aufgaben finden, z. B. zum Auflisten von Dateien in einem Verzeichnis oder zum Auflisten von Objekten in einem Bucket. `COPY`: Dateien oder Objekte in Cloud Storage kopieren. `DELETE`: Dateien oder Objekte an der Quelle oder am Ziel löschen.
`completeTime`	Der ISO 8601-konforme Zeitstempel, zu dem der Vorgang abgeschlossen wurde.
`destinationContainer`	Nur für `FIND`-Vorgänge vorhanden. Der Zielcontainer für diese Übertragung. Nur Logging-Buckets werden unterstützt. Enthält zwei untergeordnete Felder: `gcsBucket.bucket`: Der Name des Cloud Storage-Ziel-Buckets. `type`: Immer `GCS`.
`destinationObject`	Nur für `COPY`- und `DELETE`-Vorgänge vorhanden. Informationen zum Objekt, wie es in Cloud Storage geschrieben wurde Enthält zwei untergeordnete Felder: `gcsObject`, das selbst zwei Unterfelder enthält, `bucket` und `objectKey`. Gemeinsam definieren diese den Cloud Storage-Pfad des Objekts. `type` ist immer `GCS`. Beispiel: destinationObject: { gcsObject: { bucket: "my-bucket-2" objectKey: "README.md" } type: "GCS" }
`operation`	Der vollständig qualifizierte `transferOperations`-Name.
`sourceContainer`	Nur für `FIND`-Vorgänge vorhanden. Der Quellcontainer für diese Übertragung. Enthält zwei untergeordnete Felder: Einen Eintrag, der den Quellspeicherort angibt. Das Feld ist gemäß dem Quelltyp benannt. Folgende Felder sind möglich: `awsS3Bucket.bucket`: Der Name des AWS S3-Buckets. `azureBlobContainer`: Enthält untergeordnete Felder `account` und `container`, die zusammen den Microsoft Azure Blob-Speicher-URI definieren. `gcsBucket.bucket`: der Name des Cloud Storage-Buckets. `httpManifest.url`: Die URL einer URL-Liste mit öffentlich verfügbaren Dateien, die von einem HTTP(S)-Server heruntergeladen werden können. `type` ist wahlweise `AWS_S3`, `AZURE_BLOB`, `GCS` oder `HTTP`. Beispiel: sourceContainer: { gcsBucket: { bucket: "my-bucket-1" } type: "GCS" }
`sourceObject`	Nur für `COPY`- und `DELETE`-Vorgänge vorhanden. Informationen zum Quellobjekt. Enthält zwei untergeordnete Felder: Ein Eintrag, der für den Host des Quellobjekts spezifisch ist. Das Feld ist gemäß dem Quelltyp benannt und enthält Unterfelder für Metadaten. Folgende Felder sind möglich: `awsS3Object`: Ein AWS-S3-Objekt. `azureBlob`: Eine Datei in Azure Blob Storage. `gcsObject`: Ein Cloud Storage-Objekt. `httpFile`: Eine Datei, die durch eine URL-Liste angegeben wurde. `type` ist wahlweise `AWS_S3`, `AZURE_BLOB`, `GCS` oder `HTTP`. Beispiel: sourceObject: { gcsObject: { bucket: "my-bucket-1" lastModifiedTime: "2021-12-07T16:41:09.456Z" md5: "WgnCOIdfCXNTUDpQJSKb2w==" objectKey: "README.md" } type: "GCS" }
`status`	Der Status der Aktion. Wenn `status.statusCode` den Wert `OK` hat, war die Aktion erfolgreich. Andernfalls ist die Aktion fehlgeschlagen. Die Felder `status.errorType` und `status.errorMessage` werden nur ausgefüllt, wenn der Status nicht `OK` lautet.

Außerdem enthält das übergeordnete Feld resource die folgenden Felder.

resource: {
  labels: {
    job_id: "transferJobs/7876027868280507149"
    project_id: "my-project-id"
  }
  type: "storage_transfer_job"
}

Logfeld	Beschreibung
`resource.labels.job_id`	Der Name des Storage Transfer Service-Jobs, zu dem dieses Log gehört.
`resource.labels.project_id`	Die Google Cloud-Projekt-ID für diese Übertragung.