Cloud Logging para o Serviço de transferência de armazenamento

Esta página descreve como configurar e ver o Cloud Logging para os registos do Serviço de transferência de armazenamento.

O Cloud Logging para o Serviço de transferência de armazenamento é suportado para todas as transferências. FIND As operações não são registadas para transferências baseadas em agentes.

As transferências do sistema de ficheiros podem configurar adicionalmente os registos de transferência do sistema de ficheiros.

Antes de começar

Antes de começar, verifique se tem acesso ao Cloud Logging. Recomendamos a função de gestão de identidades e acessos Logs Viewer (roles/logging.viewer). Para mais informações sobre o acesso ao registo, consulte o artigo Controlo de acesso com a IAM.

As seguintes descrições explicam como validar e conceder acesso ao IAM:

Ações registáveis

As seguintes ações podem ser registadas:

  • FIND: encontrar trabalho a fazer, como listar ficheiros num diretório, listar objetos num contentor ou listar pastas geridas num contentor. Não suportado para transferências baseadas em agentes.
  • COPY: copiar ficheiros ou objetos para o Cloud Storage.
  • DELETE: eliminar ficheiros ou objetos na origem ou no destino. Para transferências entre dois sistemas de ficheiros, também regista a eliminação de ficheiros do contentor do Cloud Storage intermediário.

Estados registáveis

Para cada ação, pode optar por registar um ou mais dos seguintes estados:

  • SUCCEEDED: a ação foi bem-sucedida.
  • FAILED: a ação falhou.
  • SKIPPED: aplica-se apenas à ação COPY e só é suportado para tarefas de transferência baseadas em agentes. Tem de ser definido através da gcloud ou da API REST. Este estado significa que a cópia foi ignorada. Isto ocorre quando o ficheiro já existe no destino e a tarefa de transferência está configurada para ignorar os ficheiros existentes.

Ative o registo

Para ativar o registo, especifique as ações e os estados a registar.

CLI gcloud

Quando criar uma tarefa de transferência com gcloud transfer jobs create, use as seguintes flags para ativar o registo:

gcloud transfer jobs create SOURCE DESTINATION \
  --log-actions=copy,delete,find \
  --log-action-states=succeeded,failed,skipped

Tem de especificar, pelo menos, um valor para cada indicador.

REST

Para criar uma configuração de registo, use transferJobs.create com um LoggingConfig:

{
  "name":"transferJobs/myFirstTransfer",
  "status": "ENABLED",
  "projectId": "test-id-001",
  "loggingConfig": {
     "logActions": ["FIND", "DELETE", "COPY"],
     "logActionStates": ["SUCCEEDED", "FAILED", "SKIPPED"], #SKIPPED is