Usare i log per risolvere i problemi di caricamento in Azure Data Box Disk

  • Articolo

Questo articolo descrive i problemi che si verificano quando si caricano dati nel data center di Azure usando Azure Data Box Disk.

Informazioni sui log di caricamento

Quando i dati di un data box disk vengono caricati nel data center di Azure, vengono generati un log di copia/errore e un log dettagliato per ogni account di archiviazione. Questi log vengono caricati nello stesso account di archiviazione usato per caricare i dati.

  • Il log di copia segnala gli eventi per tutte le operazioni di copia non riuscite tra il disco e l'account Archiviazione di Azure. Il log di copia termina con un riepilogo degli errori per categoria di errore.

  • Il log dettagliato include un elenco di tutte le operazioni di copia riuscite in ogni BLOB e file.

Individuare i log

Per trovare i log da un caricamento dei dati, seguire questa procedura.

  1. Aprire l'ordine nel portale di Azure.

  2. Al termine del caricamento dei dati per ogni disco, nel riquadro Panoramica vengono visualizzati lo stato del disco e i percorsi dei log di diagnostica per il disco.

    • Per i nuovi ordini, i dettagli del disco sono simili a quelli nella schermata seguente. Un log di copia viene salvato automaticamente. Se si sceglie di salvare i log dettagliati al momento dell'ordine, verrà visualizzato anche il percorso del log dettagliato.

      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.

      I log vengono caricati in un contenitore (per le importazioni BLOB) o in una condivisione (per le importazioni in File di Azure) nell'account di archiviazione. Il contenitore è denominato databoxcopylog. Gli URL hanno questi formati:

      Tipo di registro Formato di URL
      copia log <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_CopyLog_<job-ID.xml>
      log dettagliato <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_VerboseLog_<job-ID.xml>

    • Per gli ordini precedenti, la visualizzazione potrebbe essere simile alla schermata seguente.

      Se si verificano errori durante il caricamento dei dati in Azure, i log di copia visualizzano un percorso alla cartella in cui si trovano i log di diagnostica.

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

      I log vengono caricati in un waies contenitore nell'account di archiviazione. Gli URL hanno questi formati:

      Tipo di registro Formato di URL
      log degli errori <storage-account-name>/databoxlogs-order-name<>/waies/ri-order-name-guid_><<drive-ID>_<timestamp>_error.xml
      log dettagliato <storage-account-name>/databoxlogs-order-name<>/waies/ri-order-name-guid_><<drive-ID>_<timestamp>_verbose.xml

    Nota

    I log nel contenitore databoxcopylog hanno un formato diverso rispetto ai log nel waies contenitore. Per facilitare l'interpretazione dei log, usare le istruzioni per la versione del log delle unità associata. Per altre informazioni, vedere Identificare la versione del log.

  3. Per visualizzare i log, aprire il contenitore in cui sono archiviati i log nell'account di archiviazione. La figura seguente mostra i log in un waies contenitore.

    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. Selezionare ogni log e scaricare una copia locale.

Identificare la versione del log

Esistono due versioni del log di copia/errore e del log dettagliato, con formati diversi. Le versioni dei log vengono illustrate separatamente nelle sezioni seguenti.

Insieme al log dettagliato, verrà visualizzato un log di copia (_copy.xml) o un log degli errori (_error.xml), a seconda della versione dell'unità.

Per individuare il rilascio del log sia per il log di copia che per quello dettagliato, controllare la versione del log dell'unità nel log di copia/errore.

Nome file di log Campo Versione del log unità
_copy.xml DriveLogVersion 2021-08-01
_error.xml Versione di DriveLog 2018-10-01

Nella figura seguente viene illustrato nella DriveLogVersion sezione di riepilogo di un log di copia.

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

Log di caricamento di esempio

I formati di log del log di copia/errore e del log dettagliato differiscono per le due versioni del log. Se non si è certi della versione dei log disponibili, vedere Identificare la versione del log.

Ogni trasferimento di dati per un disco genera un log di copia. Se si sceglie di salvare un log dettagliato al momento dell'ordine, è presente anche un log dettagliato nella stessa cartella.

Log dettagliato

Il log dettagliato è un file facoltativo che è possibile abilitare durante l'ordinamento. Si tratta di un semplice elenco di tutti i file importati correttamente dall'unità, con le informazioni seguenti per ogni file. Il log dettagliato non fornisce informazioni di riepilogo.

Campo Descrizione
CloudFormat BlockBlob, PageBlob o AzureFile.
Percorso Percorso del file all'interno dell'account di archiviazione.
Dimensione Dimensioni di file o BLOB.
crc64 Checksum di ridondanza ciclico 64 (CRC64) usato per verificare l'integrità dei dati durante il trasferimento dei dati.

Log dettagliato di esempio

Il log dettagliato di esempio seguente include voci di file di esempio per BLOB in blocchi, BLOB di pagine e importazioni di File di 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>

Copia log

Il log di copia contiene una voce di errore per ogni file che non è riuscito a importare, con dettagli sull'errore. Il log di copia termina con un riepilogo della convalida e degli errori di copia che si sono verificati durante l'importazione.

Ogni voce di errore contiene le informazioni seguenti.

Campo Descrizione
Percorso Condivisione di destinazione all'interno del contenitore o della condivisione file.
Categoria Una delle 15 categorie di errore. Per altre informazioni, vedere Errori di caricamento dei dati per log versione 2021-08-01.
ErrorCode Codice numerico per l'errore.
ErrorMessage Descrive l'errore.

Il riepilogo alla fine del log (cercare CopyLog Summary) fornisce le informazioni seguenti:

  • Versione del log unità (in questo caso, 2021-08-01)
  • ID unità
  • Stato della copia dei dati
  • Riepilogo degli errori di convalida per categoria di errore
  • Riepilogo degli errori di copia per categoria di errore

Log di copia di esempio

L'esempio seguente è un log di copia per un'importazione in File di Azure e archiviazione BLOB di Azure.

La copia non è riuscita, senza errori di convalida ma con tre errori di copia. Una condivisione file è stata rinominata (ShareRenamed errore) e due contenitori sono stati rinominati (ContainerRenamed errore). La voce di errore restituisce i nomi di file originali e nuovi.

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

Errori di caricamento dei dati

Gli errori segnalati nei log variano leggermente nelle due versioni del log. Se non si è certi della versione dei log disponibili, vedere Identificare la versione del log.

Gli errori rilevati nel log di copia 2018-10-01 sono descritti di seguito.

Categoria di errore Descrizione
UploadErrorWin32 Errore del file system.
UploadErrorCloudHttp Tipo di BLOB non supportato. Per altre informazioni sugli errori in questa categoria, vedere Riepilogo degli errori di caricamento.
UploadErrorDataValidationError Il CRC calcolato durante l'inserimento dati non corrisponde al CRC calcolato durante il caricamento.
UploadErrorManagedConversionError Le dimensioni del BLOB importato non sono valide. Le dimensioni del BLOB sono <byte di dimensioni> BLOB. Le dimensioni supportate sono comprese tra 20971520 byte e 8192 GiB. Per altre informazioni, vedere Riepilogo degli errori di caricamento.
UploadErrorUnknownType Errore sconosciuto.
ContainerRenamed Rinominato il contenitore perché il nome del contenitore originale non segue le convenzioni di denominazione di Azure. Il contenitore originale è stato rinominato in DataBox-GUID<> dal <nome> del contenitore originale.
ShareRenamed Rinominata la condivisione perché il nome della condivisione originale non segue le convenzioni di denominazione di Azure. La condivisione originale è stata rinominata in DataBox-GUID<> dal <nome> della cartella originale.
BlobRenamed Rinominato il BLOB perché il nome del BLOB originale non segue le convenzioni di denominazione di Azure. Il BLOB originale è stato rinominato in BlockBlob/DataBox-GUID<> dal <nome> originale.
FileRenamed Rinominato il file perché il nome file originale non segue le convenzioni di denominazione di Azure. Il BLOB originale è stato rinominato in AzureFile/DataBox-GUID<> dal <nome> originale.
DiskRenamed Rinominato il file del disco gestito perché il nome file originale non segue le convenzioni di denominazione di Azure. Il file del disco gestito originale è stato rinominato ManagedDisk/DataBox-GUID<> dal< nome> originale.
ExportCloudHttp Tipo di BLOB non supportato.

Passaggi successivi

Contatta supporto tecnico Microsoft.