Condividi tramite


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

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 di 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 è scelto di salvare i log dettagliati quando è stato effettuato l'ordine, viene visualizzato anche il percorso del log dettagliato.

      Screenshot del Riquadro Panoramica per un ordine di Data Box Disk con lo stato

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

      Tipo di log Formato URL
      Log di copia < 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.

      Schermata del riquadro di riepilogo per un ordine precedente di Data Box Disk con copie completate. I percorsi dei log di copia sono evidenziati.

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

      Tipo di log Formato 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

    Annotazioni

    I log nel contenitore databoxcopylog hanno un formato diverso rispetto ai log nel waies contenitore. Per ottenere aiuto con l'interpretazione dei log, utilizzare le istruzioni per la versione del log dell'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 dei log degli errori e dei log verbosi in un account di archiviazione per un ordine di Azure Data Box Disk. I log nei contenitori W-A-I-E-S sono evidenziati.

  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 del rilascio dell'unità.

Per individuare il rilascio del log sia per il log di copia sia 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 DriveLogVersion nel riepilogo di un log di copia.

Illustrazione della sezione Riepilogo di un log di copia per un ordine di Data Box Disk. Il Drive Log Version è evidenziato.

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 hai scelto di salvare un log dettagliato quando hai effettuato l'ordine, c'è anche un log dettagliato nella stessa cartella.

Log dettagliato

Il log dettagliato è un file facoltativo che è possibile abilitare durante il processo di ordinazione. 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 Description
CloudFormat BlockBlob, PageBlob o AzureFile.
Percorso Percorso del file all'interno dell'account di archiviazione.
Misura Dimensioni del file o BLOB.
crc64 Checksum del controllo 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 le importazioni di BLOB in blocchi, BLOB di pagine e 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 Description
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.
messaggio di errore Descrive l'errore.

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

  • Versione del registro di guida (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 relativo all'operazione di copia per un'importazione sia nei file di Azure che nello spazio di archiviazione Azure Blob.

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 in questa tabella.

Categoria di errore Description
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 in fase di importazione non sono valide. La dimensione del blob è di <blob-size> byte. 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 <> dal < nome >.
ShareRenamed Rinominata la condivisione perché il nome della condivisione originale non segue le convenzioni di denominazione di Azure. La condivisione originale è stata rinominata in <> dal < nome >.
BlobRenamed Rinominato il BLOB perché il nome del BLOB originale non rispetta le convenzioni di denominazione di Azure. Il BLOB originale è stato rinominato in BlockBlob/<DataBox-GUID> da <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/<> dal <nome> originale.
ExportCloudHttp Tipo di BLOB non supportato.

Passaggi successivi

Contattare il supporto tecnico Microsoft.