Usare i log per risolvere i problemi relativi alle importazioni e alle esportazioni tramite Importazione/Esportazione di Azure

  • Articolo

Quando il servizio Importazione/Esportazione di Microsoft Azure elabora le unità per un processo di importazione o esportazione, il servizio scrive i log di copia e i log dettagliati nell'account di archiviazione usato. Entrambi i log vengono salvati per ogni unità.

  • 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

Quando si usa il servizio Importazione/Esportazione per creare un processo di importazione o esportazione in Azure Data Box, si visualizzerà il processo di importazione/esportazione insieme alle altre risorse Data Box.

Usare la procedura seguente per individuare lo stato delle copie dei dati per un processo di importazione/esportazione:

  1. Accedere al portale di Azure.

  2. Cercare azure data box.

    Screenshot che mostra come cercare i processi di Data Box nel portale di Azure. La casella di ricerca e il servizio Azure Data Box selezionato sono evidenziati.

  3. Per filtrare i processi di importazione/esportazione di Azure, immettere "Importazione/Esportazione" nella casella di ricerca.

    Screenshot che mostra come filtrare le risorse di Data Box nel portale di Azure per visualizzare Importazione/Esportazione processi. La casella di ricerca è evidenziata.

    Nella pagina viene visualizzato un elenco di processi di importazione/esportazione.

    Screenshot delle risorse di Data Box nel portale di Azure filtrato in Importa processi di esportazione. Il nome del processo, il tipo di trasferimento, lo stato e il modello sono evidenziati.

  4. Visualizzare i dettagli del processo selezionando un nome di processo.

    Lo stato dell'ordine corrente del processo selezionato e i dettagli della copia dei dati vengono visualizzati per ogni unità.

    • Se si ha accesso all'account di archiviazione, è possibile selezionare un Percorso log di copia o Percorso log dettagliato per visualizzare il log.

    • Selezionare un ID unità per aprire un pannello con le informazioni complete sulla copia, inclusi il file manifesto e l'hash.

    Screenshot della panoramica di un processo di importazione/esportazione nel portale di Azure. Lo stato dell'ordine e gli URL di log e stato copia dati per un'unità sono evidenziati.

Un log di copia viene salvato automaticamente. Se si è scelto di salvare i log dettagliati al momento dell'ordine, verrà visualizzato anche il percorso del log dettagliato.

I log vengono caricati in un contenitore (per le importazioni e le esportazioni di 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
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 i processi di esportazione, nel disco viene salvato anche un file manifesto.

Ogni trasferimento dei dati per un disco genera un log di copia. Se si è scelto di salvare un log dettagliato al momento della creazione dell'ordine, nella stessa cartella sarà presente anche un log dettagliato.

Nota

Per gli ordini precedenti, è possibile trovare un log degli errori (_error.xml) insieme al log dettagliato in un contenitore waies nell'account di archiviazione. L'oggetto DriveLog Version, visualizzato nel riepilogo del log degli errori, sarà 2018-10-01. I formati dei log differiscono da quelli descritti in questo articolo.

Esaminare i log di importazione

Durante un'importazione, il servizio Importazione/Esportazione genera un log dettagliato e un log di copia per ogni disco.

Log dettagliato

Il log dettagliato è un file facoltativo che è possibile abilitare durante l'ordinamento. È un semplice elenco di tutti i file importati correttamente dall'unità. Il log dettagliato fornisce 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 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: importazione

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>

Log di copia

Il log di copia contiene una voce di errore per ogni file di cui non è riuscita l'importazione o l'esportazione, con i dettagli dell'errore. Il log di copia termina con un riepilogo degli errori di convalida e copia che si sono verificati durante il trasferimento dei dati.

Ogni voce di errore contiene le informazioni seguenti.

Campo Descrizione
Percorso Condivisione di destinazione all'interno del contenitore o della condivisione file.
Categoria Identifica la categoria di errore. Per altre informazioni, vedere Errori di trasferimento dei dati.
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 dell'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: importazione

L'esempio seguente è un log di copia per un'importazione sia in File di Azure che in Archiviazione BLOB di Azure.

Questa copia non è riuscita, senza errori di convalida ma con tre errori di copia. Una condivisione file è stata rinominata (errore ShareRenamed) e due contenitori sono stati rinominati (errore ContainerRenamed). 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>

Esaminare i log di esportazione

Durante un'esportazione, il servizio Importazione/Esportazione genera un log dettagliato e un log di copia per ogni trasferimento di dati da Archiviazione di Azure a un disco. Esiste anche un file manifesto, che viene salvato sul disco.

Log dettagliato

Il log dettagliato per un'esportazione è un semplice elenco di tutti i file che sono stati esportati correttamente dall'account di archiviazione di Azure all'unità. Il log dettagliato fornisce le informazioni seguenti per ogni file. Il log dettagliato non fornisce informazioni di riepilogo.

Campo Descrizione
CloudFormat BlockBlob, PageBlob o AzureFile.
ETag Tag di entità (ETag) per la risorsa, che viene usato per il controllo della concorrenza durante il trasferimento dei dati.
Percorso Percorso del file all'interno dell'account di archiviazione.
Dimensione Dimensioni del file o BLOB.
crc64 Checksum del controllo di ridondanza ciclico 64 (CRC64) calcolato durante l'esportazione dei dati su disco.

Log dettagliato di esempio: esportazione

Nel log dettagliato di esempio seguente il processo di esportazione ha trasferito correttamente tre BLOB da Archiviazione BLOB di Azure.

<File CloudFormat="BlockBlob" ETag="0x8D804D87F976907" Path="export-blobs/movie/sc%3Aifi/block.blob" Size="4096" crc64="16033727819182370206">
</File><File CloudFormat="BlockBlob" ETag="0x8D804D889880CC6" Path="export-blobs/movie/sc#Aifi/block.blob" Size="4096" crc64="16033727819182370206">
</File><File CloudFormat="BlockBlob" ETag="0x8D804D8F1BC81C0" Path="export-blobs/@GMT-2001.03.30-14.44.00/block.blob" Size="4096" crc64="16033727819182370206">
</File>

Log di copia

Il log di copia per un'esportazione contiene una voce di errore per ogni file che non è stato trasferito correttamente da Archiviazione di Azure al disco, con i dettagli dell'errore. Il log di copia termina con un riepilogo degli errori di convalida e copia che si sono verificati durante il trasferimento dei dati.

Il log di copia per un'esportazione segnala problemi, ad esempio un trasferimento di dati che ha esito negativo a causa di un'unità danneggiata o di una chiave dell'account di archiviazione modificata durante il trasferimento dei dati. Per un elenco dei problemi, vedere Errori di trasferimento dei dati.

Log di copia di esempio: esportazione

L'esempio seguente è un log di copia per un'esportazione in cui sono stati rilevati tre errori del file system (UploadErrorWin32) che hanno causato l'esito negativo dell'esportazione di tre file. L'errore 267 indica che il nome della directory non è valido. L'errore 123 indica un nome file, un nome di directory o una sintassi dell'etichetta del volume non corretta.

<ErroredEntity CloudFormat="BlockBlob" Path="export-ut-invaliddirblobpath/movie/sc:Aifi/block.blob">
  <Category>UploadErrorWin32</Category>
  <ETag>0x8D804D8840B92C9</ETag>
  <ErrorCode>267</ErrorCode>
  <ErrorMessage>File Create failed</ErrorMessage>
  <Type>File</Type>
</ErroredEntity><ErroredEntity CloudFormat="BlockBlob" Path="export-ut-invaliddirblobpath/movie/sc-Aifi/block.blob">
  <Category>UploadErrorWin32</Category>
  <ETag>0x8D804D8AD026B2A</ETag>
  <ErrorCode>123</ErrorCode>
  <ErrorMessage>File Create failed</ErrorMessage>
  <Type>File</Type>
</ErroredEntity><ErroredEntity CloudFormat="BlockBlob" Path="export-ut-invaliddirblobpath/movie/sc*Aifi/block.blob">
  <Category>UploadErrorWin32</Category>
  <ETag>0x8D804D8A858F705</ETag>
  <ErrorCode>123</ErrorCode>
  <ErrorMessage>File Create failed</ErrorMessage>
  <Type>File</Type>
</ErroredEntity><CopyLog Summary="Summary">
  <DriveLogVersion>2021-08-01</DriveLogVersion>
  <DriveId>cb57dbe8-0b67-45e0-ad40-a08fb5305c60</DriveId>
  <Status>Failed</Status>
  <TotalFiles_Blobs>9</TotalFiles_Blobs>
  <FilesErrored>6</FilesErrored>
  <Summary>
    <ValidationErrors>
      <None Count="3" />
    </ValidationErrors>
    <CopyErrors>
      <UploadErrorWin32 Count="3" Description="File Create failed because of UploadErrorWin32 exception" />
    </CopyErrors>
  </Summary>
</CopyLog>

Errori di trasferimento dei dati

Nei log di copia per i processi di importazione e/o di esportazione sono presenti gli errori seguenti.

Categoria di errore Error message Importazioni Esportazioni
UploadErrorWin32 Errore del file system. Sì Sì
UploadErrorCloudHttp Tipo di BLOB non supportato. Per altre informazioni sugli errori in questa categoria, vedere Riepilogo degli errori di caricamento. Sì Sì
UploadErrorDataValidationError Il CRC calcolato durante l'inserimento dati non corrisponde al CRC calcolato durante il caricamento. Sì Sì
UploadErrorManagedConversionError Le dimensioni del BLOB in fase di importazione non sono valide. Dimensioni BLOB: <blob-size> byte. Le dimensioni supportate sono comprese tra 20971520 byte e 8192 GiB. Per altre informazioni, vedere Riepilogo degli errori di caricamento. Sì Sì
UploadErrorUnknownType Errore sconosciuto. Sì Sì
ContainerRenamed Il contenitore è stato rinominato perché il nome del contenitore originale non segue le convenzioni di denominazione di Azure. Il contenitore originale è stato rinominato in DataBox-<GUID> da <nome contenitore originale>. No Sì
ShareRenamed La condivisione è stata rinominata perché il nome della condivisione originale non segue le convenzioni di denominazione di Azure. La condivisione originale è stata rinominata in DataBox-<GUID> da <nome cartella originale>. No Sì
BlobRenamed Il BLOB è stato rinominato perché il nome del BLOB originale non segue le convenzioni di denominazione di Azure. Il BLOB originale è stato rinominato in BlockBlob/DataBox-<GUID> da <nome originale>. No Sì
FileRenamed Il file è stato rinominato perché il nome del file originale non segue le convenzioni di denominazione di Azure. Il file originale è stato rinominato in AzureFile/DataBox-<GUID> da <nome originale>. No Sì
DiskRenamed Il file del disco gestito è stato rinominato perché il nome del file originale non segue le convenzioni di denominazione di Azure per i dischi gestiti. Il file del disco gestito originale è stato rinominato in ManagedDisk/DataBox-<GUID> da <nome originale>. No Sì
FileNameTrailsWithSlash Il nome del BLOB o del file termina con una barra finale. Un nome BLOB o un nome file che termina con una barra rovesciata finale o una barra non può essere esportato su disco. No Sì
ExportCloudHttp Tipo di BLOB non supportato. No Sì

Passaggi successivi