Utiliser des journaux pour résoudre les problèmes de chargement dans Azure Data Box Disk

Cet article décrit les problèmes que vous voyez lorsque vous chargez des données dans le centre de données Azure à l’aide d’Azure Data Box Disk.

À propos des journaux de chargement

Lorsque les données d’un disque Data Box sont chargées dans le centre de données Azure, un journal de copie/erreur et un journal détaillé sont générés pour chaque compte de stockage. Ces journaux d’activité sont chargés sur le même compte de stockage que celui utilisé pour charger des données.

Le journal de copie signale les événements pour toutes les opérations de copie ayant échoué entre le disque et le compte de stockage Azure. Le journal de copie se termine par un résumé des erreurs par catégorie d’erreur.
Le journal détaillé contient une liste de toutes les opérations de copie ayant réussi sur chaque objet blob et fichier.

Localiser les journaux

Pour trouver les logs de données d’un chargement, suivez ces étapes.

Ouvrez votre commande dans le portail Azure.

À mesure que le chargement des données se termine pour chaque disque, le volet Vue d’ensemble affiche l’état du disque et les chemins d’accès aux journaux de diagnostic du disque.

Pour les nouvelles commandes, les détails du disque ressemblent à ceux de l’écran suivant. Un journal de copie est enregistré automatiquement. Si vous avez choisi d’enregistrer des journaux détaillés au moment de passer votre commande, vous verrez également le chemin du journal détaillé.

Capture d’écran du volet Vue d’ensemble d’une commande Data Box Disk indiquant l’état La copie des données s’est terminée avec des avertissements. Un chemin du journal de copie et un chemin du journal détaillé sont mis en évidence.

Les journaux sont chargés vers un conteneur (pour les importations d’objets blob) ou un partage (pour les importations dans Azure Files) dans le compte de stockage. Le conteneur est nommé databoxcopylog. Les URL ont ces formats :

Type de log	Format d’URL
copier le journal	< storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_CopyLog_<job-ID>.xml
journal détaillé	< storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_VerboseLog_<job-ID>.xml

Pour vos commandes antérieures, l’affichage peut ressembler à l’écran suivant.

S’il existe des erreurs lors du chargement des données dans Azure, les journaux de copie affichent un chemin d’accès au dossier où se trouvent les journaux de diagnostic.

Capture d’écran du volet Vue d’ensemble d’une commande Data Box Disk antérieure avec des copies terminées. Les chemins du journal de copie sont mis en surbrillance.

Les journaux sont téléchargés vers un conteneur waies dans le compte de stockage. Les URL ont ces formats :

Type de log	Format d’URL
journal des erreurs	< storage-account-name>/databoxlogs-<order-name>/waies/ri-<order-name>-guid_<drive-ID>_<timestamp>_error.xml
journal détaillé	< storage-account-name>/databoxlogs-<order-name>/waies/ri-<order-name>-guid_<drive-ID>_<timestamp>_verbose.xml

Note

Les journaux du conteneur databoxcopylog ont un format différent de celui des journaux dans le conteneur waies. Pour obtenir de l’aide sur l’interprétation des journaux, suivez les instructions relatives à la version du journal du lecteur associé. Pour plus d’informations, consultez Identifier la version du journal.

Pour afficher les journaux, ouvrez le conteneur qui stocke les journaux dans votre compte de stockage. L’illustration suivante montre les journaux dans un conteneur waies.
Sélectionnez chaque fichier journal et téléchargez une copie locale.

Identifier la version du log

Il existe deux versions du journal des erreurs/de copie et du journal détaillé, avec différents formats. Les versions du journal sont abordées séparément dans les sections qui suivent.

Avec le journal détaillé, vous verrez un journal de copie (_copy.xml) ou un journal des erreurs (_error.xml), en fonction de la version du lecteur.

Pour déterminer la version du journal pour le journal des erreurs et le journal de copie, consultez la version du journal de lecteur dans le journal des erreurs/de copie.

Nom du fichier journal	Champ	Version du journal du lecteur
_copy.xml	DriveLogVersion	2021-08-01
_error.xml	Version de DriveLog	2018-10-01

L’illustration suivante montre DriveLogVersion dans la section Résumé d’un journal de copie.

Illustration de la section Résumé d’un journal de copie d’une commande Data Box Disk. La version du journal du lecteur est mise en évidence.

Exemples de journaux de chargement

Les formats de journal du journal de copie/erreur et du journal détaillé diffèrent pour les deux versions de journal. Si vous ne savez pas quelle version des journaux vous avez, consultez Identifier la version du journal.

Version du log : 2021-08-01
Version du journal : 2018-10-01

Chaque transfert de données pour un disque génère un journal de copie. Si vous avez choisi d’enregistrer un journal détaillé lorsque vous avez passé votre commande, il existe également un journal détaillé dans le même dossier.

Journal détaillé

Le journal détaillé est un fichier facultatif que vous pouvez activer lors de la commande. Il s’agit d’une liste simple de tous les fichiers qui ont été importés avec succès à partir du lecteur, avec les informations suivantes pour chaque fichier. Le journal détaillé ne fournit pas d’informations récapitulatives.

Champ	Descriptif
CloudFormat	BlockBlob, PageBlob ou AzureFile.
Chemin	Chemin d’accès au fichier dans le compte de stockage.
Taille	Taille du fichier ou du blob.
crc64	Somme de contrôle du contrôle de redondance cyclique 64 (CRC64) qui a été utilisée pour vérifier l’intégrité des données pendant le transfert de données.

Exemple de journal détaillé

L’exemple de journal détaillé suivant contient des exemples d’entrées de fichiers pour des importations d’objets blob de blocs, d’objets blob de pages et de fichiers 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>

Copier le fichier journal

Le journal de copie contient une entrée d’erreur pour chaque fichier qui n’a pas pu être importé, avec des détails d’erreur. Le journal de copie se termine par un résumé de la validation et des erreurs de copie qui se sont produites pendant l’importation.

Chaque entrée d’erreur contient les informations suivantes.

Champ	Descriptif
Chemin	Partage de destination dans le conteneur ou le partage de fichiers.
Catégorie	Une des 15 catégories d’erreurs. Pour plus d’informations, consultez Erreurs de chargement de données pour la version de journal 2021-08-01.
ErrorCode	Code numérique de l’erreur.
Message d'erreur	Décrit l’erreur.

Le résumé à la fin du journal (recherche CopyLog Summary) fournit les informations suivantes :

Version du journal du lecteur (dans le cas présent, 2021-08-01)
ID de lecteur de disque
État de la copie des données
Résumé des erreurs de validation par catégorie d’erreur
Résumé des erreurs de copie par catégorie d’erreur

Exemple de journal de copie

L’exemple suivant est un journal de copie pour une importation dans Azure Files et Azure Blob Storage.

Cette copie a échoué, sans erreur de validation, mais avec trois erreurs de copie. Un partage de fichiers a été renommé (ShareRenamed erreur), et deux conteneurs ont été renommés (ContainerRenamed erreur). L’entrée d’erreur donne les noms de fichiers d’origine et de nouveaux fichiers.

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

Dans le journal de lecteur version 2018-10-01, le chargement de données génère un journal des erreurs et un journal détaillé. Les deux journaux sont au même format et contiennent des descriptions XML des événements qui se sont produits lors de la copie des données du disque vers le compte de stockage Azure.

Le journal détaillé contient l’état de l’opération de copie pour chaque objet blob ou fichier, tandis que le journal des erreurs contient uniquement les informations relatives aux objets blob ou aux fichiers qui ont rencontré des erreurs pendant le chargement.

Le journal des erreurs a la même structure que le journal détaillé, mais filtre les opérations réussies.

Exemple de journal détaillé

Voici un exemple de _verbose.xml. Dans ce cas, l’ordre s’est terminé correctement sans erreur.


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

Exemples de logs d’erreurs

Pour le même ordre, un exemple du _error.xml est montré ici.


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

Un exemple de la _error.xml commande est illustré ici où la commande s’est terminée avec des erreurs.

Dans ce cas, le fichier d’erreur comporte une Summary section et une autre section qui contient toutes les erreurs au niveau du fichier.

Summary contient le ValidationErrors et le CopyErrors. Dans ce cas, huit fichiers ou dossiers ont été chargés sur Azure et aucune erreur de validation n’a été détectée. Lorsque les données ont été copiées dans le compte stockage Azure, cinq fichiers ou dossiers ont été chargés avec succès. Les trois autres fichiers ou dossiers ont été renommés conformément aux conventions d’affectation de noms de conteneur Azure, puis chargés avec succès sur Azure.

L’état au niveau des fichiers indique BlobStatus, ce qui décrit les mesures prises pour charger les objets blob. Dans ce cas, trois conteneurs sont renommés, car les dossiers dans lesquels les données ont été copiées ne sont pas conformes aux conventions d’affectation de noms Azure pour les conteneurs. Pour les objets blob chargés dans ces conteneurs, le nouveau nom du conteneur, le chemin d’accès de l’objet blob dans Azure, le chemin d’accès du fichier non valide d’origine et la taille de l’objet blob sont inclus.

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

Erreurs de chargement des données

Les erreurs signalées dans les journaux de bord varient légèrement dans les deux versions de journaux. Si vous ne savez pas quelle version des journaux vous avez, consultez Identifier la version du journal.

Version du log : 2021-08-01
Version du journal : 2018-10-01

Les erreurs détectées dans le journal de copie 2018-10-01 sont décrites dans ce tableau.

Catégorie d’erreur	Descriptif
`UploadErrorWin32`	Erreur du système de fichiers.
`UploadErrorCloudHttp`	Type d’objet blob non pris en charge. Pour plus d’informations sur les erreurs de cette catégorie, consultez Résumé des erreurs de chargement.
`UploadErrorDataValidationError`	Le CRC calculé pendant l’ingestion des données ne correspond pas au CRC calculé pendant le chargement.
`UploadErrorManagedConversionError`	La taille de l’objet blob importé n’est pas valide. La taille de l’objet blob est <blob-size> octets. Les tailles prises en charge sont comprises entre 20 971 520 octets et 8 192 GiB. Pour plus d’informations, consultez Résumé des erreurs de chargement.
`UploadErrorUnknownType`	Erreur inconnue.
`ContainerRenamed`	Renommé le conteneur, car le nom du conteneur d’origine ne suit pas les conventions d’affectation de noms Azure. Le conteneur d’origine a été renommé DataBox-GUID<> à partir du nom <du >.
`ShareRenamed`	Le partage a été renommé car le nom original ne respecte pas les normes de nommage Azure. Le partage d’origine a été renommé DataBox-<GUID> à partir du <nom du dossier d’origine>.
`BlobRenamed`	Le blob a été renommé, car le nom d’objet blob d’origine ne respecte pas les Conventions d’affectation de noms Azure. L’objet blob d’origine a été renommé BlockBlob/DataBox-<GUID> à partir du <nom d’origine>.
`FileRenamed`	Renommé le fichier, car le nom de fichier d’origine ne suit pas les conventions d’affectation de noms Azure. L’objet blob d’origine a été renommé AzureFile/DataBox-<GUID> à partir du <nom d’origine>.
`DiskRenamed`	Renommé le fichier de disque managé, car le nom de fichier d’origine ne suit pas les conventions d’affectation de noms Azure. Le fichier de disque managé d’origine a été renommé ManagedDisk/DataBox-<GUID> à partir du <nom d’origine>.
`ExportCloudHttp`	Type d’objet blob non pris en charge.

Les erreurs générées lors du chargement des données dans Azure sont résumées dans le tableau suivant. Ce jeu d’erreurs se trouve dans le journal des erreurs du 01-10-2018.

Code d’erreur	Descriptif
`Renamed`	Objet blob renommé avec succès.
`CompletedWithErrors`	Chargement terminé avec des erreurs. Les détails des fichiers en erreur sont inclus dans le fichier journal.
`Corrupted`	Le CRC calculé pendant l’ingestion des données ne correspond pas au CRC calculé pendant le chargement.
`StorageRequestFailed`	Échec de la demande de stockage Azure.
`LeasePresent`	Cet élément est loué et utilisé par un autre utilisateur.
`StorageRequestForbidden`	Impossible de charger en raison de problèmes d’authentification.
`ManagedDiskCreationTerminalFailure`	Impossible de charger en tant que disques managés. Les fichiers sont disponibles dans le compte de stockage de mise en scène sous forme de blobs de page. Vous pouvez convertir manuellement des objets blob de pages en disques gérés.
`DiskConversionNotStartedTierInfoMissing`	Étant donné que le fichier VHD a été copié en dehors des dossiers de niveau précréé, un disque managé n’a pas été créé. Le fichier est téléchargé en tant qu’objet blob de pages pour le compte de stockage intermédiaire tel que spécifié lors de la création de l’ordre. Vous pouvez le convertir manuellement en disque managé.
`InvalidWorkitem`	Impossible de charger les données, car elles ne sont pas conformes aux conventions d’affectation de noms et de limites Azure.
`InvalidPageBlobUploadAsBlockBlob`	Chargé en tant qu’objets blob de blocs dans un conteneur avec préfixe `databoxdisk-invalid-pb-`.
`InvalidAzureFileUploadAsBlockBlob`	Téléchargés comme objets blob de blocs dans un conteneur avec le préfixe `databoxdisk-invalid-af`-.
`InvalidManagedDiskUploadAsBlockBlob`	Téléchargés comme objets blob de blocs dans un conteneur avec le préfixe `databoxdisk-invalid-md`-.
`InvalidManagedDiskUploadAsPageBlob`	Chargé en tant que blobs de pages dans un conteneur avec le préfixe `databoxdisk-invalid-md-`.
`MovedToOverflowShare`	Les fichiers ont été chargés vers un nouveau partage, car la taille du partage d'origine dépassait la limite de taille maximale d'Azure. Le nouveau nom de partage de fichiers a le nom d’origine suffixé avec `-2`.
`MovedToDefaultAzureShare`	Fichiers téléchargés qui ne faisaient partie d'aucun dossier ont été placés dans un partage par défaut. Le nom du partage commence par `databox-`.
`ContainerRenamed`	Le conteneur de ces fichiers n’est pas conforme aux conventions d’affectation de noms Azure et est renommé. Le nouveau nom commence par `databox-` et est suivi du suffixe SHA1 du nom d’origine
`ShareRenamed`	Le partage de ces fichiers n’a pas été conforme aux conventions d’affectation de noms Azure et est renommé. Le nouveau nom commence par `databox-` et est suffixé du hachage SHA1 du nom d’origine.
`BlobRenamed`	Ces fichiers ne sont pas conformes aux conventions d’affectation de noms Azure et ont été renommés. Vérifiez le `BlobPath` champ du nouveau nom.
`FileRenamed`	Ces fichiers ne sont pas conformes aux conventions d’affectation de noms Azure et ont été renommés. Vérifiez le `FileStoragePath` champ du nouveau nom.
`DiskRenamed`	Ces fichiers ne sont pas conformes aux conventions d’affectation de noms Azure et ont été renommés. Vérifiez le `BlobPath` champ du nouveau nom.

Étapes suivantes

Contactez le support Microsoft.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-10-02

Partager via

Utiliser des journaux pour résoudre les problèmes de chargement dans Azure Data Box Disk

À propos des journaux de chargement

Localiser les journaux

Identifier la version du log

Exemples de journaux de chargement

Journal détaillé

Exemple de journal détaillé

Copier le fichier journal

Exemple de journal de copie

Erreurs de chargement des données

Étapes suivantes

Commentaires

Ressources supplémentaires