Formato de registro de transferencia local

En este documento, se describe el formato actual del registro de transferencias del servicio de transferencia de datos locales.

Descripción del formato

El servicio de transferencia para registros de datos locales se guarda en formato de valores separados por tabulaciones (TSV) y contiene una fila de encabezado con nombres de campo. El orden en que se muestran los campos suele ser estable, pero no están garantizados y deben inferirse de la fila del encabezado.

Cada línea representa un solo registro, que es una actualización de estado en parte de la operación de transferencia general.

En la siguiente tabla, se describen los campos del archivo de registro:

Campo de registro Descripción
Marca de tiempo Marca de tiempo compatible con ISO 8601 cuando grabamos el evento.
Nombre de la operación El nombre completamente calificado de la operación.
Acción Describe la acción de esta tarea en particular. Uno de los siguientes:
  • FIND: buscar trabajo para hacer, como enumerar archivos locales
  • TRANSFER: subir archivos
  • DELETE: eliminar archivos en el destino
ActionStatus El estado de alto nivel de la acción. Uno de los siguientes:
  • SUCCEEDED: la acción se completó correctamente.
  • FAILED: Se produjo un error con la acción. Puedes encontrar más información sobre la falla en los campos de FailureDetails.
FailureDetails.ErrorType Una string que representa el tipo de error encontrado. Por ejemplo, FILE_NOT_FOUND. Se propaga solo si se encontró un error.
FailureDetails.GrpcCode Es un valor de string del código RPC de Google. Por ejemplo, FAILED_PRECONDITION. Se propaga solo si se encontró un error.
FailureDetails.Message Un mensaje de error legible de la falla. Se propaga solo si se encontró un error.
Src.Type String que describe el tipo de sistema de almacenamiento de la fuente. Siempre es ON_PREM.
Src.File.Path Ruta de acceso al archivo de datos locales transferido.
Src.File.LastModified La hora modificada de POSIX (mtime) del archivo local
Src.FileSize El tamaño del archivo en bytes.
Src.File.Crc32C La suma de verificación CRC32C del contenido del archivo.
Dst.Type String que describe el tipo de sistema de almacenamiento de destino. Siempre es GCS.
Dst.Gcs.BucketName El nombre del depósito de destino de Cloud Storage.
Dst.Gcs.ObjectName Prefijo de objeto perteneciente al objeto de destino.
Dst.Gcs.LastModified La hora modificada POSIX (mtime) del objeto de destino.
Dst.Gcs.Size El tamaño del objeto en bytes.
Dst.Gcs.Crc23C La suma de verificación CRC32C del contenido del objeto.
Dst.Md5 La suma de verificación de MD5 del objeto final en Cloud Storage

Ejemplo de una entrada de registro

A continuación, se muestra un ejemplo de dos líneas de resultados de registro, un encabezado y una línea de datos:

Timestamp       OperationName   Action  ActionStatus    FailureDetails.ErrorType        FailureDetails.GrpcCode FailureDetails.Message     Src.Type        Src.File.Path   Src.File.LastModified   Src.File.Size   Src.File.Crc32C Dst.Type   Dst.Gcs.BucketName      Dst.Gcs.ObjectName      Dst.Gcs.LastModified    Dst.Gcs.Size    Dst.Gcs.Crc32C  Dst.Gcs.Md5
2019-10-18T21:06:17Z    transferOperations/agent-manual_transferJobs/OPI1494275376193533620_0000000001571432448     TRANSFER        SUCCEEDED                               ON_PREM_FILE    /mnt/disks/disk-1/directory1/file.txt      1561409931      406     3089075447      GCS_OBJECT      destination-gcs-bucket    file.txt  1571432776      406     3089075447      FDjya7dWbd0OrgnZ7g9ZJw==