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

En este artículo se describen los problemas que se ven 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 datos.

• El registro de copia notifica eventos para todas las operaciones de copia con errores 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 nuevos pedidos, los detalles del disco tienen un aspecto similar al de la siguiente pantalla. 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 contenedor se denomina 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>_VerboseLog_<job-ID>.xml

   • Para los pedidos anteriores, la pantalla podría tener un aspecto parecido al que se muestra a continuación.

     Si hay algún error al cargar los datos en Azure, copiar registros muestra una 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 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 al de los registros del waies contenedor. Para obtener ayuda con la interpretación de los registros, use las instrucciones para la versión del 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. En la ilustración siguiente se muestran los registros de un waies contenedor.

   

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

Registros de carga de ejemplo

Los formatos del registro de copia o error y el registro detallado difieren en las dos versiones de registro. Si no está seguro de qué versión de los registros tiene, 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 puede habilitar durante el pedido. Es 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	Description
CloudFormat	BlockBlob, PageBlob o AzureFile.
Ruta	Ruta de acceso al archivo dentro de la cuenta de almacenamiento.
Tamaño	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

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 de error. El registro de copia finaliza con un resumen de los errores de validación y copia que se produjeron durante la importación.

Cada entrada de error contiene la siguiente información.

Campo	Description
Ruta	Recurso compartido de destino dentro del contenedor o recurso compartido de archivos.
Categoría	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 log 2021-08-01.
ErrorCode	Código numérico del error.
Mensaje de error	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 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 copia de seguridad

El ejemplo siguiente es un registro de copia para una importación en Azure Files y Azure Blob Storage.

No se pudo realizar esta copia, sin errores de validación, pero con tres errores de copia. Se cambió el nombre de un recurso compartido de archivos (ShareRenamed error) y se cambió el nombre de dos contenedores (ContainerRenamed error). La entrada de error proporciona los nombres de archivo originales y nuevos.

<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 y contienen descripciones XML de los eventos que se produjeron al copiar los datos del disco a 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.

Ejemplo de registro detallado

Aquí se muestra un ejemplo de _verbose.xml . En este caso, el orden se completó 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

Para el mismo orden, se muestra un ejemplo de _error.xml aquí.

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

Aquí se muestra un ejemplo del _error.xml donde el pedido se completó con errores.

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

El Summary contiene el ValidationErrors y el CopyErrors. En este caso, se cargaron ocho archivos o carpetas en Azure y no se produjeron errores de validación. Cuando los datos se copiaron en la cuenta de Azure Storage, cinco archivos o carpetas se cargaron correctamente. Se cambió el nombre de los tres archivos o carpetas restantes según las convenciones de nomenclatura de contenedores de Azure y, a continuación, se cargaron correctamente en Azure.

Los estados de nivel de archivo se encuentran en BlobStatus, que describe las acciones realizadas para cargar los blobs. En este caso, se cambia el nombre de tres contenedores porque las carpetas a las que se copiaron los datos no se ajustaban a las convenciones de nomenclatura de Azure para los contenedores. Para los blobs cargados en esos contenedores, se incluye el nuevo nombre del contenedor, la ruta de acceso del blob en Azure, la ruta de acceso del archivo original no válida 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 qué versión de los registros tiene, consulte Identificación de la versión del registro.

Versión del registro: 2021-08-01

Los errores encontrados en el registro de copia 2018-10-01 se describen en esta tabla.

Categoría del error	Description
UploadErrorWin32	Error del sistema de archivos.
UploadErrorCloudHttp	Tipo de blob no admitido. Para obtener más información sobre los errores de esta categoría, vea Resumen de errores de carga.
UploadErrorDataValidationError	CRC calculado durante la ingesta de datos no coincide con el 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 <blob-size> bytes. Los tamaños admitidos están 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-GUID<> a partir del < nombre >.
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 de archivo original no sigue las convenciones de nomenclatura de Azure. Se ha cambiado el nombre del blob original a AzureFile/DataBox-<GUID> desde el <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. Se cambió el nombre del archivo de disco administrado original a ManagedDisk/DataBox-GUID<> a partir del <nombre> original.
ExportCloudHttp	Tipo de blob no admitido.

Versión del registro: 2018-10-01

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

Código de error	Description
Renamed	Se ha cambiado correctamente el nombre del blob.
CompletedWithErrors	Carga completada con errores. Los detalles de los archivos en error se incluyen en el archivo de registro.
Corrupted	CRC calculado durante la ingesta de datos no coincide con el CRC calculado durante la carga.
StorageRequestFailed	Error en la solicitud de Almacenamiento de Azure.
LeasePresent	Este elemento está arrendado y lo está utilizando 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 de páginas a discos administrados.
DiskConversionNotStartedTierInfoMissing	Dado que el archivo VHD se copió fuera de las carpetas de nivel precreadas, no se creó 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 ajusta 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	Se han cargado archivos en un nuevo recurso compartido, ya que el tamaño del recurso compartido original superó el límite máximo de tamaño de Azure. El nuevo nombre del recurso compartido de archivos tiene el nombre original con el sufijo -2.
MovedToDefaultAzureShare	Se cargaron archivos que no estaban en ninguna carpeta a un recurso compartido predeterminado. El nombre del recurso compartido comienza por databox-.
ContainerRenamed	El contenedor de estos archivos no se ajusta a las convenciones de nomenclatura de Azure y se cambia el nombre. El nuevo nombre comienza por databox- y se sufijo con el hash SHA1 del nombre original.
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 comienza por databox- y se sufijo con el hash SHA1 del nombre original.
BlobRenamed	Estos archivos no se ajustaban a las convenciones de nomenclatura de Azure y se cambiaron el nombre. Compruebe el BlobPath campo para el nuevo nombre.
FileRenamed	Estos archivos no se ajustaban a las convenciones de nomenclatura de Azure y se cambiaron el nombre. Compruebe el FileStoragePath campo para el nuevo nombre.
DiskRenamed	Estos archivos no se ajustaban a las convenciones de nomenclatura de Azure y se cambiaron el nombre. Compruebe el BlobPath campo para el nuevo nombre.

Pasos siguientes

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