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

  • Article

Cet article décrit les problèmes que vous rencontrez 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 Data Box Disk sont chargées dans le centre de données Azure, un journal de copie/d’erreur et un journal détaillé sont générés pour chaque compte de stockage. Ces journaux sont chargés sur le même compte de stockage utilisé pour charger des données.

  • Le journal de copie consigne les événements pour toutes les opérations de copie ayant échoué entre le disque et le compte 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 rechercher les journaux d’un chargement de données, procédez comme suit.

  1. Ouvrez votre commande dans le portail Azure.

  2. À 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 pour le disque.

    • Pour les nouvelles commandes, les détails du disque se présentent comme sur 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é.

      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.

      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 les formats suivants :

      Type de journal Format URL
      journal de copie <nom-compte-stockage>/databoxcopylog/<nom-commande>_<numéro-série-appareil>_CopyLog_<ID-tâche>.xml
      journal d’activité détaillé <nom-compte-stocckage>/databoxcopylog/<nom-commande>_<numéro-série-appareil>_VerboseLog_<ID-tâche>.xml

    • Pour vos commandes précédentes, l’affichage peut ressembler à l’écran suivant.

      Si des erreurs se produisent lors du chargement des données dans Azure, les Journaux de copie affichent un chemin d’accès au dossier dans lequel se trouvent les journaux de diagnostic.

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

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

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

    Remarque

    Les journaux dans le conteneur databoxcopylog ont un format différent de celui des journaux dans le conteneur waies. Pour 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.

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

    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. Sélectionnez chaque journal et téléchargez une copie locale.

Identifier la version du journal

Il existe deux versions du journal des erreurs/de copie et du journal détaillé, avec différents formats. Les versions des journaux sont présenté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 of the Summary section of a copy log for a Data Box Disk order. The Drive Log Version is highlighted.

Exemples de journaux de chargement

Les formats de journal de copie/des erreurs 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.

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é quand vous avez passé la commande, vous voyez également un journal détaillé dans le même dossier.

Journaux d’activité détaillés

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

Champ Description
CloudFormat BlockBlob, PageBlob ou AzureFile.
Chemin d’accès Chemin du fichier dans le compte de stockage.
Taille Taille du fichier ou de l’objet blob.
crc64 Somme de 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>

Journal de copie

Le journal de copie contient une entrée d’erreur pour chaque fichier dont l’importation a échoué, avec le détail de l’erreur. Le journal de copie se termine par un résumé des erreurs de validation et de copie qui se sont produites pendant l’importation.

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

Champ Description
Chemin d’accès Partage de destination dans le conteneur ou le partage de fichiers.
Catégorie L’une des 15 catégories d’erreur. 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.
ErrorMessage Décrit l’erreur.

Le résumé à la fin du journal (recherchez CopyLog Summary) donne 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 à la fois dans Azure Files et le Stockage Blob Azure.

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

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

Erreurs de chargement des données

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

Les erreurs trouvées dans le journal de copie version 2018-10-01 sont décrites ci-dessous.

Catégorie d’erreur Description
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écapitulatif des erreurs de chargement.
UploadErrorDataValidationError Le CRC calculé au cours de l’ingestion de données ne correspond pas au CRC calculé lors du chargement.
UploadErrorManagedConversionError La taille de l’objet blob importé n’est pas valide. La taille de l’objet blob est de <taille-blob> octets. Les tailles prises en charge sont comprises entre 20971520 octets et 8192 Gio. Pour plus d’informations, consultez Récapitulatif des erreurs de chargement.
UploadErrorUnknownType Erreur inconnue.
ContainerRenamed Le conteneur a été renommé, car le nom de conteneur d’origine ne respecte pas les conventions d’affectation de noms Azure. Le conteneur d’origine a été renommé DataBox-<GUID> à partir du <nom du conteneur d’origine>.
ShareRenamed Le partage a été renommé, car le nom de partage d’origine ne respecte pas les Conventions d’affectation de noms 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 Le fichier a été renommé, car le nom de fichier d’origine ne respecte 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 Le fichier de disque managé a été renommé, car le nom de fichier d’origine ne respecte 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.

Étapes suivantes

Contactez le support Microsoft.