Uso de registros para solucionar problemas de carga en Azure Data Box Disk

En este artículo se describen los problemas que aparecen al cargar datos en el centro de datos de Azure mediante Azure Data Box Disk.

Acerca de los registros de carga

Cuando los datos de una unidad Data Box Disk se cargan en el centro de datos de Azure, se generan un registro de copia o error y un registro detallado para cada cuenta de almacenamiento. Estos registros se cargan en la misma cuenta de almacenamiento que se usó para cargar los datos.

  • 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

Para buscar los registros de una carga de datos, siga estos pasos:

  1. Abra el pedido en Azure Portal.

  2. A medida que se completa la carga de datos para cada disco, el panel Información general muestra el estado del disco y las rutas de acceso a los registros de diagnóstico del disco.

    • En el caso de los pedidos nuevos, los detalles del disco son parecidos a los que se muestran en la pantalla siguiente. 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.

      Screenshot of the Overview pane for a Data Box Disk order with Copy Completed With Warnings status. A Copy Log Path and Verbose Log Path are highlighted.

      Los registros se cargan en un contenedor (para importaciones 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 dirección 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>_CopyLog_<job-ID>.xml
    • Para los pedidos anteriores, la pantalla podría tener un aspecto parecido al que se muestra a continuación.

      Si se producen errores durante la carga de los datos en Azure, la opción Copiar registros muestra la ruta de acceso a la carpeta donde se encuentran los registros de diagnóstico.

      Screenshot of the Overview pane for an earlier Data Box Disk order with completed copies. The Copy Log Paths are highlighted.

      Los registros se cargan en un waies contenedor de la cuenta de almacenamiento. Las direcciones URL tienen estos formatos:

      Tipo de registro Formato de dirección URL
      registro de errores <storage-account-name>/databoxlogs-<order-name>/waies/ri-<order-name>-guid_<drive-ID>_<timestamp>_error.xml
      registro detallado <storage-account-name>/databoxlogs-<order-name>/waies/ri-<order-name>-guid_<drive-ID>_<timestamp>_verbose.xml

    Nota

    Los registros del contenedor databoxcopylog tienen un formato diferente a los del contenedor waies. Para obtener ayuda para interpretar los registros, use las instrucciones para la versión de registro de unidad asociada. Consulte Identificación de la versión del registro para obtener más información.

  3. Para ver los registros, abra el contenedor que almacena los registros en la cuenta de almacenamiento. La siguiente ilustración muestra los registros en un contenedor waies.

    Screenshot of error logs and verbose logs in a storage account for an Azure Data Box Disk order. The logs in the W-A-I-E-S containers are highlighted.

  4. Seleccione cada registro y descargue una copia local.

Identificación de la versión del registro

Hay dos versiones del registro de copia o error y el registro detallado, con formatos diferentes. Las versiones de registro se tratan por separado en las secciones siguientes.

Junto con el registro detallado, verá un registro de copia (_copy.xml) o un registro de errores (_error.xml) en función de la versión de la unidad.

Para conocer la versión del registro de copia o error y el registro detallado que lo acompaña, compruebe la versión del registro de unidad en el registro de copia o error.

Nombre del archivo de registro Campo Versión del registro de unidad
_copy.xml DriveLogVersion 2021-08-01
_error.xml Versión de DriveLog 2018-10-01

La siguiente ilustración muestra el campo DriveLogVersion en la sección de resumen de un registro de copia.

Illustration of the Summary section of a copy log for a Data Box Disk order. The Drive Log Version is highlighted.

Ejemplos de registros de carga

Los formatos del registro de copia o error y el registro detallado difieren en las dos versiones de registro. Si no está seguro de la versión que tiene de los registros, consulte Identificación de la versión del registro.

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

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, con la siguiente información para cada archivo. El registro detallado no proporciona información de resumen.

Campo Descripción
CloudFormat BlockBlob, PageBlob o AzureFile.
Ruta de acceso 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.

Registro detallado de ejemplo

El siguiente registro detallado de ejemplo tiene entradas de archivo de ejemplo para blob en bloques, blob 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, con detalles del error. El registro de copia finaliza con un resumen de los errores de copia y validació nque se produjeron durante la importación.

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 Una de las 15 categorías de error. Para obtener más información, consulte Errores de carga de datos para la versión de registro 2021-08-01.
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

Registro de copia de ejemplo

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>

Errores de carga de datos

Los errores notificados en los registros varían ligeramente en las dos versiones de registro. Si no está seguro de la versión que tiene de los registros, consulte Identificación de la versión del registro.

A continuación se describen los errores encontrados en el registro de copia 2018-10-01.

Categoría del error Descripción
UploadErrorWin32 Error del sistema de archivos.
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.
UploadErrorDataValidationError El valor de CRC calculado durante la ingesta de datos no coincide con el valor de CRC calculado durante la carga.
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.
UploadErrorUnknownType Error desconocido.
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>.
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>.
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>.
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 blob original a AzureFile/DataBox-<GUID> a partir del <nombre original>.
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. El nombre del archivo de disco administrado original se ha cambiado a ManagedDisk/DataBox-<GUID> a partir del <nombre original>.
ExportCloudHttp Tipos de blob no admitidos.

Pasos siguientes

Póngase en contacto con Soporte técnico de Microsoft.