Configurar registros de transferência

Veja nesta página como configurar os registros do Cloud Logging para o Serviço de transferência do Cloud Storage. Saiba mais sobre como ler registros de transferência em Ler registros de transferência.

Saiba mais sobre os registros do serviço de transferência de dados locais em Formato de registros de transferência local.

Antes de começar

Antes de começar, verifique se você tem acesso ao Cloud Logging. Recomendamos o papel Leitor de registros (roles/logging.viewer). do Identity and Access Management. Saiba mais sobre o acesso ao Logging no Guia de controle de acesso.

Veja a seguir como verificar e conceder o acesso ao IAM:

Criar uma configuração de geração de registros

Uma configuração de geração de registros descreve as ações de transferência e os estados das ações de transferência que você tem interesse em registrar. Por exemplo, as ações que você pode registrar são buscar, excluir e copiar arquivos. Os estados das ações que podem ser registrados são sucesso e falha. Crie uma configuração de geração de registros para cada job de transferência que você quer registrar.

Para criar uma configuração de geração de registros, use transferJobs.create com um 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/"
      },
   }
}

É possível ajustar loggingConfig para incluir logActions específicos em que você tem interesse. Por exemplo, para registrar quando as ações de copiar e buscar falharem, forneça o seguinte loggingConfig:

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

Atualizar uma configuração de geração de registros

Para atualizar uma configuração de geração de registros de uma transferência atual, use transferJobs.patch com LoggingConfig:

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

A seguir