Usar los registros para solucionar problemas de importación y exportación a través de Azure Import/Export

  • Artículo

Cuando el servicio Microsoft Azure Import/Export procesa las unidades para un trabajo de importación o exportación, el servicio escribe los registros de copia y los registros detallados en la cuenta de almacenamiento que usó. Ambos registros se guardan para cada unidad.

  • El registro de copia notifica los eventos de todas las operaciones de copia con error entre el disco y la cuenta de Azure Storage. El registro de copia finaliza con un resumen de errores por categoría de error.

  • El registro detallado incluye una lista de todas las operaciones de copia que se realizaron correctamente en cada blob y archivo.

Búsqueda de los registros

Cuando usa el servicio Import/Export para crear un trabajo de importación o exportación en Azure Data Box, verá el trabajo de Import/Export junto con los demás recursos Data Box.

Siga los siguientes pasos para conocer el estado de las copias de datos de un trabajo de Import/Export:

  1. Inicie sesión en Azure Portal.

  2. Busque Azure Data Box.

    Captura de pantalla que muestra cómo buscar los trabajos de Data Box en Azure Portal. El cuadro de búsqueda y el servicio de Azure Data Box seleccionado están resaltados.

  3. Para filtrar por trabajos de Azure Import/Export, escriba "Import/Export" en el cuadro de búsqueda.

    Captura de pantalla que muestra cómo filtrar los recursos de Data Box en Azure Portal para mostrar los trabajos de Import/Export. El cuadro de búsqueda está resaltado.

    Aparece en la página una lista de los trabajos de Import/Export.

    Captura de pantalla de los recursos de Data Box en Azure Portal filtrados por los trabajos de Import/Export. El nombre del trabajo, el tipo de transferencia, el estado y el modelo están resaltados.

  4. Para ver los detalles del trabajo, seleccione un nombre de trabajo.

    El Estado de orden actual del trabajo seleccionado y los Detalles de copia de datos se muestran para cada unidad.

    • Si tiene acceso a la cuenta de almacenamiento, puede seleccionar Copiar ruta de acceso del registro o Ruta de acceso del registro detallado para ver el registro.

    • Seleccione un identificador de unidad para abrir un panel con la información de copia completa, incluidos el archivo de manifiesto y el hash.

    Captura de pantalla de la información general de un trabajo de Import/Export en Azure Portal. Están resaltados el estado del pedido, el estado de la copia de datos y las direcciones URL de registro de una unidad.

Un registro de copia se guarda automáticamente. Si optó por guardar registros detallados al hacer el pedido, también verá la ruta de acceso al registro detallado.

Los registros se cargan en un contenedor (para importaciones y exportaciones de blobs) o en un recurso compartido (para importaciones a Azure Files) en la cuenta de almacenamiento. El nombre del contenedor es databoxcopylog. Las direcciones URL tienen estos formatos:

Tipo de registro Formato de URL
registro de copia <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_CopyLog_<job-ID>.xml
registro detallado <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_VerboseLog_<job-ID>.xml

Para los trabajos de exportación, también se guarda un archivo de manifiesto en el disco.

Cada transferencia de datos de un disco genera un registro de copia. Si ha optado por guardar un registro detallado al crear el pedido, también habrá un registro detallado en la misma carpeta.

Nota:

Para los pedidos anteriores, es posible que encuentre un registro de errores (_error.xml) junto con el registro detallado en un waiescontenedor de la cuenta de almacenamiento. El DriveLog Version que se muestra en el resumen del registro de errores, será 2018-10-01. Los formatos de registro son diferentes a los descritos en este artículo.

Revisión de los registros de importación

Durante una importación, el servicio de Import/Export genera un registro detallado y un registro de copia para cada disco.

Registro detallado

El registro detallado es un archivo opcional que se puede habilitar durante la ordenación. Se trata de una lista sencilla de todos los archivos que se importaron correctamente desde la unidad. El registro detallado proporciona la siguiente información para cada archivo. El registro detallado no proporciona información de resumen.

Campo Descripción
CloudFormat BlockBlob, PageBlob o AzureFile.
Path Ruta de acceso al archivo dentro de la cuenta de almacenamiento.
Size Tamaño de archivo o blob.
crc64 La suma de comprobación de redundancia cíclica 64 (CRC64) que se usó para comprobar la integridad de los datos durante la transferencia de datos.

Ejemplo de registro detallado: importar

El siguiente registro detallado de ejemplo tiene entradas de archivo de ejemplo para blobs en bloques, blobs en páginas e importaciones de archivos de Azure.

<File CloudFormat="BlockBlob" Path="$root\file26fd6b4bd-25f7-4019-8d0d-baa7355745df.vhd" Size="1024" crc64="14179624636173788226">
</File><File CloudFormat="BlockBlob" Path="$root\file49d220295-9cfd-469e-b69e-5c7c885133df.vhd" Size="1024" crc64="14179624636173788226">
</File>
----------CUT--------------------
<File CloudFormat="AzureFile" Path="e579954d-1f94-40cf-955f-afd39e9ca217\file1876f73ad-6213-43bc-9467-67fe0c794e99.block" Size="1024" crc64="1410470866535975213">
</File><File CloudFormat="AzureFile" Path="05407abe-81c8-4b44-b846-3a2c8c198316\file28d7868be-e6a7-4441-8d09-2b127f7d049e.vhd" Size="1024" crc64="1410470866535975213">
</File><File CloudFormat="AzureFile" Path="eb7666a7-c026-4375-9c08-3dea37a57713\file4448aeaf5-53dc-4bff-b798-4776e367ab5e.vhd" Size="1024" crc64="1410470866535975213">
</File>
----------CUT--------------------
<File CloudFormat="PageBlob" Path="tesdir8b1d0acd-2d37-46dd-96cf-edeb0f772e6b\file1.txt" Size="83886080" crc64="1680234237456714851">
</File><File CloudFormat="PageBlob" Path="tesdirf631630d-8098-4c84-be7b-40f6bbdb73fb\file_size0.txt" Size="0" crc64="0">
</File><File CloudFormat="PageBlob" Path="tesdirf631630d-8098-4c84-be7b-40f6bbdb73fb\Dir1/file_size0.txt" Size="0" crc64="0">
</File>

Registro de copia

El registro de copia contiene una entrada de error para cada archivo que no se pudo importar o exportar, con detalles del error. El registro de copia finaliza con un resumen de los errores de copia y validación que se produjeron durante la transferencia de datos.

Cada entrada de error contiene la siguiente información.

Campo Descripción
Path Recurso compartido de destino dentro del contenedor o recurso compartido de archivos.
Category Identifica la categoría de error. Para obtener más información, vea Errores de transferencia de datos.
ErrorCode Código numérico del error.
ErrorMessage Describe el error.

El resumen al final del registro (busque CopyLog Summary) proporciona la siguiente información:

  • Versión del registro de unidad (en este caso, 2021-08-01)
  • Id. de unidad
  • Estado de la copia de datos
  • Resumen de errores de validación por categoría de error
  • Resumen de errores de copia por categoría de error

Ejemplo de registro de copias: importación

El ejemplo siguiente es un registro de copia para una importación tanto a Azure Files como a Azure Blob Storage.

Esta copia ha fracasado, sin errores de validación pero con tres errores de copia. Se han cambiado el nombre de un recurso compartido de archivos (error ShareRenamed) y el nombre de dos contenedores (error ContainerRenamed). La entrada de error proporciona los nombres de archivo original y nuevo.

<ErroredEntity Path="New Folder">
  <Category>ShareRenamed</Category>
  <ErrorCode>1</ErrorCode>
  <ErrorMessage>The original container/share/Blob has been renamed to: DataBox-f55763d4-8ef7-458f-b029-f36b51ada34f :from: New Folder :because either name has invalid character(s) or length is not supported</ErrorMessage>
  <Type>Container</Type>
</ErroredEntity>
<ErroredEntity Path="CV">
  <Category>ContainerRenamed</Category>
  <ErrorCode>1</ErrorCode>
  <ErrorMessage>The original container/share/Blob has been renamed to: DataBox-6bcae46f-04c8-4385-8442-3a28b962c930 :from: CV :because either name has invalid character(s) or length is not supported</ErrorMessage>
  <Type>Container</Type>
</ErroredEntity><ErroredEntity Path="New_ShareFolder">
  <Category>ContainerRenamed</Category>
  <ErrorCode>1</ErrorCode>
  <ErrorMessage>The original container/share/Blob has been renamed to: DataBox-96d8e2ee-ffd4-4529-9ec0-f666674b70d9 :from: New_ShareFolder :because either name has invalid character(s) or length is not supported</ErrorMessage>
  <Type>Container</Type>
</ErroredEntity>
<CopyLog Summary="Summary">
  <DriveLogVersion>2021-08-01</DriveLogVersion>
  <DriveId>72a1914a-7fb2-4e34-a135-5c7176c3ee41</DriveId>
  <Status>Failed</Status>
  <TotalFiles_Blobs>60</TotalFiles_Blobs>
  <FilesErrored>0</FilesErrored>
  <Summary>
    <ValidationErrors>
      <None Count="3" />
    </ValidationErrors>
    <CopyErrors>
      <ShareRenamed Count="1" Description="Renamed the share as the original share name does not follow Azure conventions." />
      <ContainerRenamed Count="2" Description="Renamed the container as the original container name does not follow Azure conventions." />
    </CopyErrors>
  </Summary>
</CopyLog>

Revisar los registros de exportación

Durante una exportación, el servicio de Import/Export genera un registro detallado y un registro de copia para cada transferencia de datos desde Azure Storage a un disco. También hay un archivo de manifiesto, que se guarda en el disco.

Registro detallado

El registro detallado de una exportación es una simple lista de todos los archivos que se exportaron correctamente desde la cuenta de almacenamiento de Azure a la unidad. El registro detallado proporciona la siguiente información para cada archivo. El registro detallado no proporciona información de resumen.

Campo Descripción
CloudFormat BlockBlob, PageBlob o AzureFile.
Etag La etiqueta de entidad (ETag) para el recurso, que se utiliza para la comprobación de la concurrencia durante la transferencia de datos.
Path Ruta de acceso al archivo dentro de la cuenta de almacenamiento.
Size Tamaño de archivo o blob.
crc64 La suma de comprobación de redundancia cíclica 64 (CRC64) que se calculó al exportar los datos al disco.

Ejemplo de registro detallado: exportar

En el siguiente ejemplo de registro detallado, el trabajo de exportación transfirió correctamente tres blobs desde el almacenamiento de Azure Blob.

<File CloudFormat="BlockBlob" ETag="0x8D804D87F976907" Path="export-blobs/movie/sc%3Aifi/block.blob" Size="4096" crc64="16033727819182370206">
</File><File CloudFormat="BlockBlob" ETag="0x8D804D889880CC6" Path="export-blobs/movie/sc#Aifi/block.blob" Size="4096" crc64="16033727819182370206">
</File><File CloudFormat="BlockBlob" ETag="0x8D804D8F1BC81C0" Path="export-blobs/@GMT-2001.03.30-14.44.00/block.blob" Size="4096" crc64="16033727819182370206">
</File>

Registro de copia

El registro de copias para una exportación contiene una entrada de error para cada archivo que no se transfirió correctamente desde Azure Storage al disco, con el detalle del error. El registro de copia finaliza con un resumen de los errores de copia y validación que se produjeron durante la transferencia de datos.

El registro de copia para una exportación informa de problemas como una transferencia de datos que falla debido a una unidad dañada o una clave de cuenta de almacenamiento que cambió durante la transferencia de datos. Para obtener una lista de problemas, vea Errores de transferencia de datos.

Ejemplo de registro de copias: exportar

El ejemplo siguiente es un registro de copia para una exportación que se produjo con tres errores del sistema de archivos ( UploadErrorWin32) que provocaron un error en la exportación de tres archivos. El error 267 indica que el nombre del directorio no es válido. El error 123 indica un nombre de archivo, un nombre de directorio o una sintaxis de etiqueta de volumen incorrectos.

<ErroredEntity CloudFormat="BlockBlob" Path="export-ut-invaliddirblobpath/movie/sc:Aifi/block.blob">
  <Category>UploadErrorWin32</Category>
  <ETag>0x8D804D8840B92C9</ETag>
  <ErrorCode>267</ErrorCode>
  <ErrorMessage>File Create failed</ErrorMessage>
  <Type>File</Type>
</ErroredEntity><ErroredEntity CloudFormat="BlockBlob" Path="export-ut-invaliddirblobpath/movie/sc-Aifi/block.blob">
  <Category>UploadErrorWin32</Category>
  <ETag>0x8D804D8AD026B2A</ETag>
  <ErrorCode>123</ErrorCode>
  <ErrorMessage>File Create failed</ErrorMessage>
  <Type>File</Type>
</ErroredEntity><ErroredEntity CloudFormat="BlockBlob" Path="export-ut-invaliddirblobpath/movie/sc*Aifi/block.blob">
  <Category>UploadErrorWin32</Category>
  <ETag>0x8D804D8A858F705</ETag>
  <ErrorCode>123</ErrorCode>
  <ErrorMessage>File Create failed</ErrorMessage>
  <Type>File</Type>
</ErroredEntity><CopyLog Summary="Summary">
  <DriveLogVersion>2021-08-01</DriveLogVersion>
  <DriveId>cb57dbe8-0b67-45e0-ad40-a08fb5305c60</DriveId>
  <Status>Failed</Status>
  <TotalFiles_Blobs>9</TotalFiles_Blobs>
  <FilesErrored>6</FilesErrored>
  <Summary>
    <ValidationErrors>
      <None Count="3" />
    </ValidationErrors>
    <CopyErrors>
      <UploadErrorWin32 Count="3" Description="File Create failed because of UploadErrorWin32 exception" />
    </CopyErrors>
  </Summary>
</CopyLog>

Errores de transferencia de datos

En los registros de copia de los trabajos de importación y/o exportación se encuentran los siguientes errores.

Categoría del error Mensaje de error Importaciones Exportaciones
UploadErrorWin32 Error del sistema de archivos. Sí Sí
UploadErrorCloudHttp Tipos de blob no admitidos. Para obtener más información sobre los errores de esta categoría, consulte Resumen de errores de carga. Sí Sí
UploadErrorDataValidationError El valor de CRC calculado durante la ingesta de datos no coincide con el valor de CRC calculado durante la carga. Sí Sí
UploadErrorManagedConversionError El tamaño del blob que se quiere importar no es válido. El tamaño del blob es <tamaño de blob> bytes. Los tamaños admitidos se encuentran entre 20971520 bytes y 8192 GiB. Para obtener más información, consulte Resumen de errores de carga. Sí Sí
UploadErrorUnknownType Error desconocido. Sí Sí
ContainerRenamed Se ha cambiado el nombre del contenedor porque el nombre del contenedor original no sigue las convenciones de nomenclatura de Azure. Se ha cambiado el nombre del contenedor original a DataBox-<GUI> a partir del <nombre del contenedor original>. No Sí
ShareRenamed Se ha cambiado el nombre del recurso compartido porque el nombre del recurso compartido original no sigue las convenciones de nomenclatura de Azure. Se ha cambiado el nombre del contenedor original a DataBox-<GUID> a partir del <nombre de la carpeta original>. No Sí
BlobRenamed Se ha cambiado el nombre del blob porque el nombre del blob original no sigue las convenciones de nomenclatura de Azure. Se ha cambiado el nombre del blob original a BlockBlob/DataBox-<GUID> a partir del <nombre original>. No Sí
FileRenamed Se ha cambiado el nombre del archivo porque el nombre del archivo original no sigue las convenciones de nomenclatura de Azure. Se ha cambiado el nombre del archivo original a AzureFile/DataBox-<GUID> a partir del <nombre original>. No Sí
DiskRenamed Se ha cambiado el nombre del archivo de disco administrado porque el nombre del archivo original no sigue las convenciones de nomenclatura de Azure para los discos administrados. El nombre del archivo de disco administrado original se ha cambiado a ManagedDisk/DataBox-<GUID> a partir del <nombre original>. No Sí
FileNameTrailsWithSlash El nombre del blob o el nombre de archivo finaliza con una barra diagonal al final. Un nombre de blob o de archivo que termina con una barra diagonal inversa o una barra inclinada no puede exportarse al disco. No Sí
ExportCloudHttp Tipos de blob no admitidos. No Sí

Pasos siguientes