Übertragungslogs konfigurieren

Auf dieser Seite wird beschrieben, wie Sie Cloud Logging für Storage Transfer Service-Logs konfigurieren. Informationen zum Lesen von Übertragungslogs finden Sie unter Übertragungslogs lesen.

Informationen zu 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 Anleitung zur Zugriffssteuerung.

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

Logging-Konfiguration erstellen

In einer Logging-Konfiguration werden die Übertragungsaktionen und Status der Übertragungsaktionen beschrieben, die Sie für das Logging festgelegt haben. Die Aktionen, die Sie protokollieren können, sind beispielsweise das Suchen, Löschen und Kopieren von Dateien. Die Status der Aktionen, die Sie protokollieren können, sind „erfolgreich“ und „fehlgeschlagen“. Sie erstellen eine Logging-Konfiguration für jeden Übertragungsjob, den Sie protokollieren möchten.

Verwenden Sie zum Erstellen einer Logging-Konfiguration transferJobs.create mit einer LoggingConfig:

{
  "name":"transferJobs/myFirstTransfer",
  "description": "My First Transfer",
  "status": "ENABLED",
  "projectId": "test-id-001",
  "schedule": {
      "scheduleStartDate": {
          "year": 2021,
          "month": 10,
          "day": 20
      },
      "scheduleEndDate": {
          "year": 2024,
          "month": 10,
          "day": 22
      },
  },
  "loggingConfig": {
     "logActions": ["FIND", "DELETE", "COPY"],
     "logActionStates": ["SUCCEEDED", "FAILED"],
  },
  "transferSpec": {
      "awsS3DataSource": {
          "bucketName": "AWS_SOURCE_NAME",
          "awsAccessKey": {
              "accessKeyId": "AWS_ACCESS_KEY_ID",
              "secretAccessKey": "AWS_SECRET_ACCESS_KEY"
          }
      },
      "gcsDataSink": {
           "bucketName": "destination_bucket"
           "path": "foo/bar/"
      },
   }
}

Sie können loggingConfig anpassen, um bestimmte logActions aufzunehmen, an denen Sie interessiert sind. Wenn Sie beispielsweise protokollieren möchten, welche Kopier- und Suchaktionen fehlschlagen, können Sie die folgende loggingConfig angeben:

"loggingConfig": {
  "logActions": ["COPY", "FIND"],
  "logActionStates": ["FAILED"],
}

Logging-Konfiguration aktualisieren

Verwenden Sie transferJobs.patch mit LoggingConfig, um die Logging-Konfiguration einer vorhandenen Übertragung zu aktualisieren:

{
  "projectId: "test-id-001",
  transferJob: {
    "loggingConfig": {
       "logActions": ["FIND", "DELETE", "COPY"],
       "logActionStates": ["SUCCEEDED", "FAILED"],
    },
  },
  "updateTransferJobFieldMask": "loggingConfig"
}

Nächste Schritte