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.

     

     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 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 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.

     

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

     Tipo de registro	Formato de 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.

   

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.

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.

Versión del registro: 2021-08-01

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.
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.

Registro detallado de ejemplo

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, 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>

Versión del registro: 2018-10-01

En la versión 2018-10-01 del registro de unidades, la carga de datos genera un registro de errores y un registro detallado. Ambos registros tienen el mismo formato e incluyen descripciones XML de los eventos que se produjeron al copiar los datos del disco en la cuenta de Azure Storage.

El registro detallado contiene información completa acerca del estado de la operación de copia de todos los blobs o archivos, mientras que el registro de errores contiene solo la información de los blobs o archivos que encontraron errores durante la carga.

El registro de errores tiene la misma estructura que el registro detallado, pero filtra las operaciones correctas.

Registro detallado de ejemplo

A continuación se muestra un ejemplo de _verbose.xml. En este caso, el pedido se ha completado correctamente sin errores.

<?xml version="1.0" encoding="utf-8"?>
<DriveLog Version="2018-10-01">
  <DriveId>184020D95632</DriveId>
  <Blob Status="Completed">
    <BlobPath>$root/botetapageblob.vhd</BlobPath>
    <FilePath>\PageBlob\botetapageblob.vhd</FilePath>
    <Length>1073742336</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <PageRangeList>
      <PageRange Offset="0" Length="4194304" Status="Completed" />
      <PageRange Offset="4194304" Length="4194304" Status="Completed" />
      <PageRange Offset="8388608" Length="4194304" Status="Completed" />
      --------CUT-------------------------------------------------------
      <PageRange Offset="1061158912" Length="4194304" Status="Completed" />
      <PageRange Offset="1065353216" Length="4194304" Status="Completed" />
      <PageRange Offset="1069547520" Length="4194304" Status="Completed" />
      <PageRange Offset="1073741824" Length="512" Status="Completed" />
    </PageRangeList>
  </Blob>
  <Blob Status="Completed">
    <BlobPath>$root/botetablockblob.txt</BlobPath>
    <FilePath>\BlockBlob\botetablockblob.txt</FilePath>
    <Length>19</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <BlockList>
      <Block Offset="0" Length="19" Status="Completed" />
    </BlockList>
  </Blob>
  <File Status="Completed">
    <FileStoragePath>botetaazurefilesfolder/botetaazurefiles.txt</FileStoragePath>
    <FilePath>\AzureFile\botetaazurefilesfolder\botetaazurefiles.txt</FilePath>
    <Length>20</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <FileRangeList>
      <FileRange Offset="0" Length="20" Status="Completed" />
    </FileRangeList>
  </File>
  <Status>Completed</Status>
</DriveLog>

Registros de errores de ejemplo

A continuación se muestra un ejemplo de _error.xml para el mismo pedido.

<?xml version="1.0" encoding="utf-8"?>
<DriveLog Version="2018-10-01">
  <DriveId>184020D95632</DriveId>
  <Summary>
    <ValidationErrors>
      <None Count="3" />
    </ValidationErrors>
    <CopyErrors>
      <None Count="3" Description="No errors encountered" />
    </CopyErrors>
  </Summary>
  <Status>Completed</Status>
</DriveLog>

A continuación se muestra un ejemplo de _error.xml en el que el pedido se ha completado con errores.

En este caso, el archivo de error tiene una sección Summary y otra sección que contiene todos los errores de nivel de archivo.

Summary contiene ValidationErrors y CopyErrors. En este caso, se cargaron 8 archivos o carpetas en Azure y no hubo ningún error de validación. Cuando los datos se copiaron en la cuenta de Azure Storage, se cargaron correctamente 5 archivos o carpetas. Se cambió el nombre de los 3 archivos o carpetas restantes según las convenciones de nomenclatura de contenedores de Azure y, después, se cargaron correctamente en Azure.

Los estados de nivel de archivo están incluidos en BlobStatus, que describe las acciones que se realizan para cargar los blobs. En este caso, se cambia el nombre de tres contenedores porque las carpetas en las que se copiaron los datos no se ajustaban a las convenciones de nomenclatura de Azure para los contenedores. En el caso de los blobs cargados en esos contenedores, se incluye el nuevo nombre de contenedor, la ruta de acceso del blob en Azure, la ruta de acceso de archivo no válida original y el tamaño del blob.

 <?xml version="1.0" encoding="utf-8"?>
  <DriveLog Version="2018-10-01">
    <DriveId>18041C582D7E</DriveId>
    <Summary>
      <ValidationErrors>
        <None Count="8" />
      </ValidationErrors>
      <CopyErrors>
        <Completed Count="5" Description="No errors encountered" />
        <ContainerRenamed Count="3" Description="Renamed the container as the original container name does not follow Azure conventions." />
      </CopyErrors>
    </Summary>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/private.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\private.vhd</OriginalFilePath>
      <SizeInBytes>10490880</SizeInBytes>
    </Blob>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/resource.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\resource.vhd</OriginalFilePath>
      <SizeInBytes>71528448</SizeInBytes>
    </Blob>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/role.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\role.vhd</OriginalFilePath>
      <SizeInBytes>10490880</SizeInBytes>
    </Blob>
    <Status>CompletedWithErrors</Status>
  </DriveLog>

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.

Versión del registro: 2021-08-01

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.

Versión del registro: 2018-10-01

En la tabla siguiente se resumen los errores generados al cargar los datos en Azure. Este conjunto de errores se encuentra en el registro de errores 2018-10-01.

Código de error	Descripción
Renamed	El nombre del blob se cambió correctamente.
CompletedWithErrors	La carga se completó con errores. Los detalles de los archivos con errores se incluyen en el archivo de registro.
Corrupted	El valor de CRC calculado durante la ingesta de datos no coincide con el valor de CRC calculado durante la carga.
StorageRequestFailed	La solicitud de Azure Storage no se realizó.
LeasePresent	Esté artículo se ha concedido y lo usa otro usuario.
StorageRequestForbidden	No se pudo cargar debido a problemas de autenticación.
ManagedDiskCreationTerminalFailure	No se pudo cargar como discos administrados. Los archivos están disponibles en la cuenta de almacenamiento provisional como blobs en páginas. Puede convertir manualmente los blobs en páginas a discos administrados.
DiskConversionNotStartedTierInfoMissing	Puesto que el archivo de disco duro virtual se copió fuera de las carpetas del nivel creadas previamente, no se ha creado un disco administrado. El archivo se carga como blob en páginas en la cuenta de almacenamiento provisional que se especificó durante la creación del pedido. Puede convertirlo manualmente en un disco administrado.
InvalidWorkitem	No se pudieron cargar los datos ya que no se ajustan a las convenciones de nomenclatura y límites de Azure.
InvalidPageBlobUploadAsBlockBlob	Se cargaron como blobs en bloques en un contenedor con el prefijo databoxdisk-invalid-pb-.
InvalidAzureFileUploadAsBlockBlob	Se cargaron como blobs en bloques en un contenedor con el prefijo databoxdisk-invalid-af-.
InvalidManagedDiskUploadAsBlockBlob	Se cargaron como blobs en bloques en un contenedor con el prefijo databoxdisk-invalid-md-.
InvalidManagedDiskUploadAsPageBlob	Se cargaron como blobs en páginas en un contenedor con el prefijo databoxdisk-invalid-md-.
MovedToOverflowShare	Los archivos se cargaron en un nuevo recurso compartido porque el tamaño del recurso compartido original superaba el límite de tamaño máximo de Azure. El nombre del nuevo recurso compartido es el nombre original con el sufijo -2.
MovedToDefaultAzureShare	Los archivos que no formaban parte de ninguna carpeta se cargaron en un recurso compartido predeterminado. El nombre del recurso compartido comienza por databox-.
ContainerRenamed	El contenedor de estos archivos no se ajustaba a las convenciones de nomenclatura de Azure y se le cambió el nombre. El nuevo nombre empieza por databox- e incluye el hash SHA1 del nombre original como sufijo.
ShareRenamed	El recurso compartido de estos archivos no se ajustaba a las convenciones de nomenclatura de Azure y se le cambió el nombre. El nuevo nombre empieza por databox- e incluye el hash SHA1 del nombre original como sufijo.
BlobRenamed	Estos archivos no se ajustaban a las convenciones de nomenclatura de Azure y se les cambió el nombre. Compruebe el nuevo nombre en el campo BlobPath.
FileRenamed	Estos archivos no se ajustaban a las convenciones de nomenclatura de Azure y se les cambió el nombre. Compruebe el nuevo nombre en el campo FileStoragePath.
DiskRenamed	Estos archivos no se ajustaban a las convenciones de nomenclatura de Azure y se les cambió el nombre. Compruebe el nuevo nombre en el campo BlobPath.

Pasos siguientes

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