Lettura dei log di trasferimento

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questa pagina descrive come visualizzare i log di Cloud Logging per Storage Transfer Service e il formato dei log. Per informazioni sulla configurazione dei log di Storage Transfer Service, vedi Configurare i log di trasferimento.

Per informazioni sul servizio di trasferimento per i log di dati on-premise, vedi Trasferimento per il formato del log on-premise.

Prima di iniziare

Prima di iniziare, verifica di avere accesso a Cloud Logging. Consigliamo di utilizzare il ruolo Visualizzatore log (roles/logging.viewer) per la gestione di identità e accessi. Per ulteriori informazioni sull'accesso a Logging, consulta il Controllo dell'accesso con IAM.

Di seguito viene descritto come verificare e concedere l'accesso IAM:

• Visualizza l'accesso attuale per verificare l'accesso di ogni entità.
• Concedi un ruolo alle entità pertinenti nel progetto.

Visualizza i log

Per visualizzare i log di trasferimento:

Google Cloud Console

1. Vai al menu di navigazione di Google Cloud e seleziona Logging > Esplora log :<br\></br\>

   Vai a Esplora log

2. Seleziona un progetto Cloud.

3. Nel menu Upgrade, passa da Visualizzatore log legacy a Esplora log.

4. Per filtrare i log in modo da visualizzare solo le voci di Storage Transfer Service, digita storage_transfer_job nel campo della query e fai clic su Esegui query.

5. Nel riquadro Risultati delle query, fai clic su Modifica ora per modificare il periodo di tempo in cui restituire i risultati.

Per scoprire di più sull'utilizzo di Esplora log, consulta la sezione Utilizzo di Esplora log.

API di Cloud Logging

Utilizza il metodo entries.list API Cloud Logging.

Per filtrare i risultati in modo da includere solo voci relative a Storage Transfer Service, utilizza il campo filter. Di seguito è riportato un oggetto richiesta JSON di esempio.

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

Interfaccia a riga di comando gcloud

Per utilizzare lo strumento a riga di comando gcloud per cercare i log di Storage Transfer Service, utilizza il comando gcloud logging read.

Specifica un filtro per limitare i risultati ai log di Storage Transfer Service.

gcloud logging read "resource.type=storage_transfer_job"

Trasferisci formato del log

Nella sezione seguente sono descritti i campi dei log di Storage Transfer Service.

Tutti i campi specifici di Storage Transfer Service sono contenuti in un campo jsonPayload.

FIND azione

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 e DELETE azione

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"
  }
}

Campo log	Descrizione
@type	Il valore è sempre type.googleapis.com/google.storagetransfer.logging.TransferActivityLog.
action	Descrive l'azione di questa attività specifica. Il valore sarà uno dei seguenti: FIND: individuazione delle operazioni da eseguire, ad esempio l'elenco di file in una directory o l'inserimento di oggetti in un bucket. COPY: copia di file o oggetti in Cloud Storage. DELETE: eliminazione di file o oggetti nell'origine o nella destinazione.
completeTime	Il timestamp conforme alla norma ISO 8601 in cui è stata completata l'operazione.
destinationContainer	Presente solo per le operazioni FIND. Il contenitore di destinazione per questo trasferimento. Per il logging sono supportati solo i bucket Cloud Storage. Contiene due campi secondari: gcsBucket.bucket: nome del bucket Cloud Storage di destinazione. type: sempre GCS.
destinationObject	Presente solo per le operazioni COPY e DELETE. Informazioni sull'oggetto così come sono state scritte in Cloud Storage. Contiene due campi secondari: gcsObject, che a sua volta contiene due sottocampi, bucket e objectKey. Insieme, questi definiscono il percorso Cloud Storage dell'oggetto. type è sempre GCS. Ad esempio: destinationObject: { gcsObject: { bucket: "my-bucket-2" objectKey: "README.md" } type: "GCS" }
operation	Il nome completo transferOperations.
sourceContainer	Presente solo per le operazioni FIND. Il contenitore di origine per questo trasferimento. Contiene due campi secondari: Una voce che specifica la posizione dell'origine. Il campo è denominato in base al tipo di origine. I campi possibili sono i seguenti. awsS3Bucket.bucket: il nome del bucket AWS S3. azureBlobContainer: contiene i sottocampi account e container, che insieme definiscono l'URI di archiviazione BLOB di Microsoft Azure. gcsBucket.bucket: nome del bucket Cloud Storage. httpManifest.url: l'URL di un elenco di URL che specifica i file disponibili pubblicamente da scaricare da un server HTTP(S). type è uno di AWS_S3, AZURE_BLOB, GCS o HTTP. Ad esempio: sourceContainer: { gcsBucket: { bucket: "my-bucket-1" } type: "GCS" }
sourceObject	Presente solo per le operazioni COPY e DELETE. Informazioni sull'oggetto di origine. Contiene due campi secondari: Una voce specifica per l'host dell'oggetto di origine. Il campo è denominato in base al tipo di origine e contiene sottocampi per i metadati. I campi possibili sono i seguenti. awsS3Object: un oggetto AWS S3. azureBlob: un file dell'archiviazione BLOB di Azure. gcsObject: oggetto Cloud Storage. httpFile: un file specificato da un elenco di URL. type è uno di AWS_S3, AZURE_BLOB, GCS o HTTP. Ad esempio: sourceObject: { gcsObject: { bucket: "my-bucket-1" lastModifiedTime: "2021-12-07T16:41:09.456Z" md5: "WgnCOIdfCXNTUDpQJSKb2w==" objectKey: "README.md" } type: "GCS" }
status	Lo stato dell'azione. Se status.statusCode è OK, l'azione è andata a buon fine. In caso contrario, l'azione non è riuscita. I campi status.errorType e status.errorMessage vengono compilati solo se lo stato non è OK.

Inoltre, il campo di primo livello resource contiene i seguenti campi.

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

Campo log	Descrizione
resource.labels.job_id	Il nome del job di Storage Transfer Service a cui appartiene questo log.
resource.labels.project_id	L'ID progetto Google Cloud per questo trasferimento.