配置转移日志

本页面介绍了如何配置 Cloud Logging for Storage Transfer Service 日志。如需了解如何读取转移日志,请参阅读取转移日志

如需了解 Transfer Service for On Premises Data 日志,请参阅本地转移日志格式

准备工作

在开始之前,请验证您是否有权访问 Cloud Logging。我们建议使用 Logs Viewer (roles/logging.viewer) Identity and Access Management 角色。如需详细了解 Logging 访问权限,请参阅访问权限控制指南

下文介绍了如何验证和授予 IAM 访问权限:

创建日志记录配置

日志记录配置描述您有兴趣记录的转移操作转移操作状态。例如,您可以记录的操作包括查找、删除和复制文件。您可以记录的操作状态是成功和失败。您可以为有兴趣记录的每项转移作业创建日志记录配置。

如需创建日志记录配置,请使用 transferJobs.createLoggingConfig

{
  "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/"
      },
   }
}

您可以调整 loggingConfig,以包含您感兴趣的特定 logActions。例如,如果要在复制和查找操作失败时进行记录,可以提供以下 loggingConfig

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

更新日志记录配置

如需更新现有转移作业的日志记录配置,请将 transferJobs.patchLoggingConfig 搭配使用:

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

后续步骤