Formato dei file di log del servizio Importazione/Esportazione di Azure

Articolo
01/23/2017

Quando il servizio Importazione/Esportazione di Microsoft Azure esegue un'azione in un'unità come parte di un processo di importazione o di esportazione, i log vengono scritti in BLOB in blocchi nell'account di archiviazione associato a tale processo.

Esistono due log che possono essere scritti dal servizio Importazione/Esportazione:

Il log degli errori viene sempre generato in caso di errore.
Il log dettagliato non è abilitato per impostazione predefinita, ma può essere abilitato impostando la proprietà EnableVerboseLog in un'operazione di tipo Put Job o Update Job Properties.

Posizione dei file di log

I log vengono scritti in BLOB in blocchi nel contenitore o nella directory virtuale specificata tramite l'impostazione ImportExportStatesPath, che è possibile impostare in un'operazione di tipo Put Job. La posizione in cui vengono scritti i log dipende da come viene specificata l'autenticazione per il processo e dal valore specificato per ImportExportStatesPath. L'autenticazione per il processo può essere specificata tramite una chiave dell'account di archiviazione o la firma di accesso condiviso di un contenitore.

Il nome del contenitore o della directory virtuale può essere il nome predefinito di waimportexport oppure il nome di un altro contenitore o di un'altra directory virtuale specificato dall'utente.

Nella tabella seguente vengono illustrate le opzioni possibili:

Metodo di autenticazione	Valore dell'elemento `ImportExportStatesPath`	Posizione dei BLOB di log
Chiave dell'account di archiviazione	Valore predefinito	Un contenitore denominato `waimportexport`, ovvero il contenitore predefinito. Ad esempio: `https://myaccount.blob.core.windows.net/waimportexport`
Chiave dell'account di archiviazione	Valore specificato dall'utente	Un contenitore denominato dall'utente. Ad esempio: `https://myaccount.blob.core.windows.net/mylogcontainer`
Firma di accesso condiviso del contenitore	Valore predefinito	Una directory virtuale denominata `waimportexport`, ovvero il nome predefinito, sotto il contenitore specificato nella firma di accesso condiviso. Ad esempio, se la firma di accesso condiviso specificata per il processo è `https://myaccount.blob.core.windows.net/mylogcontainer?sv=2012-02-12&se=2015-05-22T06%3A54%3A55Z&sr=c&sp=wl&sig=sigvalue`, il percorso del log sarà `https://myaccount.blob.core.windows.net/mylogcontainer/waimportexport`
Firma di accesso condiviso del contenitore	Valore specificato dall'utente	Una directory virtuale denominata dall'utente, sotto il contenitore specificato nella firma di accesso condiviso. Ad esempio, se la firma di accesso condiviso specificata per il processo è `https://myaccount.blob.core.windows.net/mylogcontainer?sv=2012-02-12&se=2015-05-22T06%3A54%3A55Z&sr=c&sp=wl&sig=sigvalue`e la directory virtuale specificata è denominata `mylogblobs`, il percorso del log sarà `https://myaccount.blob.core.windows.net/mylogcontainer/waimportexport/mylogblobs`.

È possibile recuperare l'URL per l'errore e i log dettagliati chiamando l'operazione Get Job. I log sono disponibili al termine dell'elaborazione dell'unità.

Formato di file dei log

Il formato è lo stesso per entrambi i log: un BLOB che contiene le descrizioni XML degli eventi che si sono verificati durante la copia dei BLOB tra il disco rigido e l'account del cliente.

Il log dettagliato contiene informazioni complete sullo stato dell'operazione di copia per ogni BLOB (per un processo di importazione) o file (per un processo di esportazione), mentre il log degli errori contiene solo le informazioni per i BLOB o i file che hanno rilevato errori durante il processo di importazione o esportazione.

Di seguito è mostrato il formato di log dettagliato. Il log degli errori presenta la stessa struttura, ma esclude le operazioni riuscite.

<DriveLog Version="2014-11-01">  
  <DriveId>drive-id</DriveId>  
  [<Blob Status="blob-status">  
   <BlobPath>blob-path</BlobPath>  
   <FilePath>file-path</FilePath>  
   [<Snapshot>snapshot</Snapshot>]  
   <Length>length</Length>  
   [<LastModified>last-modified</LastModified>]  
   [<ImportDisposition Status="import-disposition-status">import-disposition</ImportDisposition>]  
   [page-range-list-or-block-list]  
   [metadata-status]  
   [properties-status]  
  </Blob>]  
  [<Blob>  
    . . .  
  </Blob>]  
  <Status>drive-status</Status>  
</DriveLog>  
  
page-range-list-or-block-list ::= 
  page-range-list | block-list  
  
page-range-list ::=   
<PageRangeList>  
      [<PageRange Offset="page-range-offset" Length="page-range-length"   
       [Hash="md5-hash"] Status="page-range-status"/>]  
      [<PageRange Offset="page-range-offset" Length="page-range-length"   
       [Hash="md5-hash"] Status="page-range-status"/>]  
</PageRangeList>  
  
block-list ::=  
<BlockList>  
      [<Block Offset="block-offset" Length="block-length" [Id="block-id"]  
       [Hash="md5-hash"] Status="block-status"/>]  
      [<Block Offset="block-offset" Length="block-length" [Id="block-id"]   
       [Hash="md5-hash"] Status="block-status"/>]  
</BlockList>  
  
metadata-status ::=  
<Metadata Status="metadata-status">  
   [<GlobalPath Hash="md5-hash">global-metadata-file-path</GlobalPath>]  
   [<Path Hash="md5-hash">metadata-file-path</Path>]  
</Metadata>  
  
properties-status ::=  
<Properties Status="properties-status">  
   [<GlobalPath Hash="md5-hash">global-properties-file-path</GlobalPath>]  
   [<Path Hash="md5-hash">properties-file-path</Path>]  
</Properties>

Nella tabella seguente vengono illustrati gli elementi del file di log.

Elemento XML	Tipo	Descrizione
`DriveLog`	Elemento XML	Rappresenta un log di unità.
`Version`	Attributo, stringa	Versione del formato del log.
`DriveId`	string	Numero di serie dell'hardware dell'unità.
`Status`	string	Stato di elaborazione dell'unità. Per altre informazioni, vedere la tabella `Drive Status Codes` di seguito.
`Blob`	Elemento XML nidificato	Rappresenta un BLOB.
`Blob/BlobPath`	string	L'URI del BLOB.
`Blob/FilePath`	string	Il percorso relativo verso il file nell'unità.
`Blob/Snapshot`	Datetime	La versione dello snapshot del BLOB, solo per un processo di esportazione.
`Blob/Length`	Integer	La lunghezza totale dei BLOB in byte.
`Blob/LastModified`	Datetime	Data e ora dell'ultima modifica al BLOB, solo per un processo di esportazione.
`Blob/ImportDisposition`	string	La disposizione di importazione del BLOB, solo per un processo di importazione.
`Blob/ImportDisposition/@Status`	Attributo, stringa	Lo stato della disposizione di importazione.
`PageRangeList`	Elemento XML nidificato	Rappresenta un elenco di intervalli di pagine per un BLOB di pagine.
`PageRange`	Elemento XML	Rappresenta un intervallo di pagine.
`PageRange/@Offset`	Attributo, valore integer	L'offset iniziale dell'intervallo di pagine nel BLOB.
`PageRange/@Length`	Attributo, valore integer	La lunghezza in byte dell'intervallo di pagine.
`PageRange/@Hash`	Attributo, stringa	L'hash MD5 codificato in base 16 dell'intervallo di pagine.
`PageRange/@Status`	Attributo, stringa	Lo stato di elaborazione dell'intervallo di pagine.
`BlockList`	Elemento XML nidificato	Rappresenta un elenco di blocchi per un BLOB in blocchi.
`Block`	Elemento XML	Rappresenta un blocco.
`Block/@Offset`	Attributo, valore integer	L'offset iniziale del blocco nel BLOB.
`Block/@Length`	Attributo, valore integer	La lunghezza in byte del blocco.
`Block/@Id`	Attributo, stringa	L'ID del blocco.
`Block/@Hash`	Attributo, stringa	L'hash MD5 codificato in base 16 del blocco.
`Block/@Status`	Attributo, stringa	Lo stato di elaborazione del blocco.
`Metadata`	Elemento XML nidificato	Rappresenta i metadati del BLOB.
`Metadata/@Status`	Attributo, stringa	Lo stato di elaborazione dei metadati del BLOB.
`Metadata/GlobalPath`	string	Il percorso relativo verso il file di metadati globale.
`Metadata/GlobalPath/@Hash`	Attributo, stringa	L'hash MD5 codificato in base 16 del file di metadati globale.
`Metadata/Path`	string	Il percorso relativo verso il file di metadati.
`Metadata/Path/@Hash`	Attributo, stringa	L'hash MD5 codificato in base 16 del file di metadati.
`Properties`	Elemento XML nidificato	Rappresenta le proprietà del BLOB.
`Properties/@Status`	Attributo, stringa	Lo stato di elaborazione delle proprietà del BLOB, ad esempio file non trovato, completato e così via.
`Properties/GlobalPath`	string	Il percorso relativo verso il file di proprietà globale.
`Properties/GlobalPath/@Hash`	Attributo, stringa	L'hash MD5 codificato in base 16 del file di proprietà globale.
`Properties/Path`	string	Il percorso relativo verso il file di proprietà.
`Properties/Path/@Hash`	Attributo, stringa	L'hash MD5 codificato in base 16 del file di proprietà.
`Blob/Status`	string	Lo stato di elaborazione del BLOB.

Codici di stato per un'unità

Nella tabella seguente sono elencati i codici di stato per l'elaborazione di un'unità.

Codice stato	Descrizione
`Completed`	L'unità ha completato l'elaborazione senza errori.
`CompletedWithWarnings`	L'unità ha completato l'elaborazione con avvisi di uno o più BLOB in base alle disposizioni di importazione specificate per i BLOB.
`CompletedWithErrors`	L'unità ha completato l'elaborazione con errori in uno o più BLOB o blocchi.
`DiskNotFound`	Nessun disco trovato nell'unità.
`VolumeNotNtfs`	Il primo volume di dati sul disco non è in formato NTFS.
`DiskOperationFailed`	Si è verificato un errore sconosciuto durante l'esecuzione di operazioni sull'unità.
`BitLockerVolumeNotFound`	Non è stato trovato nessun volume BitLocker crittografabile.
`BitLockerNotActivated`	Nel volume non è abilitato BitLocker.
`BitLockerProtectorNotFound`	La protezione con chiave con password numerica non esiste nel volume.
`BitLockerKeyInvalid`	La password numerica specificata non può sbloccare il volume.
`BitLockerUnlockVolumeFailed`	Si è verificato un errore sconosciuto durante il tentativo di sbloccare il volume.
`BitLockerFailed`	Si è verificato un errore sconosciuto durante l'esecuzione di operazioni BitLocker.
`ManifestNameInvalid`	Il nome del file manifesto non è valido.
`ManifestNameTooLong`	Il nome del file manifesto è troppo lungo.
`ManifestNotFound`	Il file manifesto non è stato trovato.
`ManifestAccessDenied`	L'accesso al file manifesto è stato negato.
`ManifestCorrupted`	Il file manifesto è danneggiato (il contenuto non corrisponde all'hash).
`ManifestFormatInvalid`	Il contenuto del manifesto non è conforme al formato richiesto.
`ManifestDriveIdMismatch`	L'ID unità nel file manifesto non corrisponde a quello letto dall'unità.
`ReadManifestFailed`	Si è verificato un errore di I/O durante la lettura dal manifesto.
`BlobListFormatInvalid`	Il BLOB dell'elenco di BLOB di esportazione non è conforme al formato richiesto.
`BlobRequestForbidden`	Non è consentito l'accesso ai BLOB nell'account di archiviazione. Ciò potrebbe essere dovuto al fatto che la chiave dell'account di archiviazione o la firma di accesso condiviso del contenitore non sono validi.
`InternalError`	Si è verificato un errore interno durante l'elaborazione dell'unità.

Codici di stato per un BLOB

Nella tabella seguente sono elencati i codici di stato per l'elaborazione di un BLOB.

Codice stato	Descrizione
`Completed`	Il BLOB ha completato l'elaborazione senza errori.
`CompletedWithErrors`	Il BLOB ha completato l'elaborazione con errori in uno o più intervalli di pagine o blocchi, metadati o proprietà.
`FileNameInvalid`	Il nome del file non è valido.
`FileNameTooLong`	Il nome del file è troppo lungo.
`FileNotFound`	Il file non è stato trovato.
`FileAccessDenied`	L'accesso al file è stato negato.
`BlobRequestFailed`	La richiesta del servizio BLOB di accedere al BLOB ha avuto esito negativo.
`BlobRequestForbidden`	La richiesta del servizio BLOB di accedere al BLOB è vietata. Ciò potrebbe essere dovuto al fatto che la chiave dell'account di archiviazione o la firma di accesso condiviso del contenitore non sono validi.
`RenameFailed`	Impossibile rinominare il BLOB (per un processo di importazione) o il file (per un processo di esportazione).
`BlobUnexpectedChange`	Si è verificato un cambiamento imprevisto nel BLOB (per un processo di esportazione).
`LeasePresent`	È presente un lease nel BLOB.
`IOFailed`	Si è verificato un errore di I/O nel disco o nella rete durante l'elaborazione del BLOB.
`Failed`	Si è verificato un errore sconosciuto durante l'elaborazione del BLOB.

Codici di stato per una disposizione di importazione

Nella tabella seguente sono elencati i codici di stato per la risoluzione di una disposizione di importazione.

Codice stato	Descrizione
`Created`	Il BLOB è stato creato.
`Renamed`	Il BLOB è stato rinominato in base alla disposizione di importazione di ridenominazione. L'elemento `Blob/BlobPath` contiene l'URI per il BLOB rinominato.
`Skipped`	Il BLOB è stato ignorato in base alla disposizione di importazione `no-overwrite`.
`Overwritten`	Il BLOB ha sovrascritto un BLOB esistente in base alla disposizione di importazione `overwrite`.
`Cancelled`	Un errore precedente ha arrestato un'ulteriore elaborazione della disposizione di importazione.

Codici di stato per un intervallo/blocco di pagine

Nella tabella seguente sono elencati i codici di stato per l'elaborazione di un intervallo di pagine o un blocco.

Codice stato	Descrizione
`Completed`	L'intervallo di pagine o il blocco ha completato l'elaborazione senza errori.
`Committed`	Il commit del blocco è stato eseguito, ma non nell'elenco di blocchi completo perché gli altri blocchi non sono riusciti oppure l'operazione ha avuto esito negativo.
`Uncommitted`	Il blocco è stato caricato ma non è stato eseguito il commit.
`Corrupted`	L'intervallo di pagine o il blocco è danneggiato (il contenuto non corrisponde all'hash).
`FileUnexpectedEnd`	È stata rilevata una fine imprevista del file.
`BlobUnexpectedEnd`	È stata rilevata una fine imprevista del BLOB.
`BlobRequestFailed`	La richiesta del servizio BLOB di accedere all'intervallo di pagine o al blocco ha avuto esito negativo.
`IOFailed`	Si è verificato un errore di I/O nel disco o nella rete durante l'elaborazione dell'intervallo di pagine o del blocco.
`Failed`	Si è verificato un errore sconosciuto durante l'elaborazione dell'intervallo di pagine o del blocco.
`Cancelled`	Un errore precedente ha arrestato un'ulteriore elaborazione dell'intervallo di pagine o del blocco.

Codici di stato per i metadati

Nella tabella seguente sono elencati i codici di stato per l'elaborazione dei metadati del BLOB.

Codice stato	Descrizione
`Completed`	I metadati hanno completato l'elaborazione senza errori.
`FileNameInvalid`	Il nome del file di metadati non è valido.
`FileNameTooLong`	Il nome del file di metadati è troppo lungo.
`FileNotFound`	Il nome del file di metadati non è stato trovato.
`FileAccessDenied`	L'accesso al file di metadati è stato negato.
`Corrupted`	Il file di metadati è danneggiato (il contenuto non corrisponde all'hash).
`XmlReadFailed`	Il contenuto dei metadati non è conforme al formato richiesto.
`XmlWriteFailed`	La scrittura dell'elemento XML dei metadati ha avuto esito negativo.
`BlobRequestFailed`	La richiesta del servizio BLOB di accedere ai metadati ha avuto esito negativo.
`IOFailed`	Si è verificato un errore di I/O nel disco o nella rete durante l'elaborazione dei metadati.
`Failed`	Si è verificato un errore sconosciuto durante l'elaborazione dei metadati.
`Cancelled`	Un errore precedente ha arrestato un'ulteriore elaborazione dei metadati.

Codici di stato delle proprietà

Nella tabella seguente sono elencati i codici di stato per l'elaborazione delle proprietà del BLOB.

Codice stato	Descrizione
`Completed`	Le proprietà hanno completato l'elaborazione senza errori.
`FileNameInvalid`	Il nome del file di proprietà non è valido.
`FileNameTooLong`	Il nome del file di proprietà è troppo lungo.
`FileNotFound`	Il file di proprietà non è stato trovato.
`FileAccessDenied`	L'accesso al file di proprietà è stato negato.
`Corrupted`	Il file di proprietà è danneggiato (il contenuto non corrisponde all'hash).
`XmlReadFailed`	Il contenuto delle proprietà non è conforme al formato richiesto.
`XmlWriteFailed`	La scrittura dell'elemento XML delle proprietà ha avuto esito negativo.
`BlobRequestFailed`	La richiesta del servizio BLOB di accedere alle proprietà ha avuto esito negativo.
`IOFailed`	Si è verificato un errore di I/O nel disco o nella rete durante l'elaborazione delle proprietà.
`Failed`	Si è verificato un errore sconosciuto durante l'elaborazione delle proprietà.
`Cancelled`	Un errore precedente ha arrestato un'ulteriore elaborazione delle proprietà.

Esempi di registro

Di seguito è riportato un esempio di log dettagliato.

<?xml version="1.0" encoding="UTF-8"?>  
<DriveLog Version="2014-11-01">  
    <DriveId>WD-WMATV123456</DriveId>  
    <Blob Status="Completed">  
       <BlobPath>pictures/bob/wild/desert.jpg</BlobPath>  
       <FilePath>\Users\bob\Pictures\wild\desert.jpg</FilePath>  
       <Length>98304</Length>  
       <ImportDisposition Status="Created">overwrite</ImportDisposition>  
       <BlockList>  
          <Block Offset="0" Length="65536" Id="AAAAAA==" Hash=" 9C8AE14A55241F98533C4D80D85CDC68" Status="Completed"/>  
          <Block Offset="65536" Length="32768" Id="AQAAAA==" Hash=" DF54C531C9B3CA2570FDDDB3BCD0E27D" Status="Completed"/>  
       </BlockList>  
       <Metadata Status="Completed">  
          <GlobalPath Hash=" E34F54B7086BCF4EC1601D056F4C7E37">\Users\bob\Pictures\wild\metadata.xml</GlobalPath>  
       </Metadata>  
    </Blob>  
    <Blob Status="CompletedWithErrors">  
       <BlobPath>pictures/bob/animals/koala.jpg</BlobPath>  
       <FilePath>\Users\bob\Pictures\animals\koala.jpg</FilePath>  
       <Length>163840</Length>  
       <ImportDisposition Status="Overwritten">overwrite</ImportDisposition>  
       <PageRangeList>  
          <PageRange Offset="0" Length="65536" Hash="19701B8877418393CB3CB567F53EE225" Status="Completed"/>  
          <PageRange Offset="65536" Length="65536" Hash="AA2585F6F6FD01C4AD4256E018240CD4" Status="Corrupted"/>  
          <PageRange Offset="131072" Length="4096" Hash="9BA552E1C3EEAFFC91B42B979900A996" Status="Completed"/>  
       </PageRangeList>  
       <Properties Status="Completed">  
          <Path Hash="38D7AE80653F47F63C0222FEE90EC4E7">\Users\bob\Pictures\animals\koala.jpg.properties</Path>  
       </Properties>  
    </Blob>  
    <Status>CompletedWithErrors</Status>  
</DriveLog>

Di seguito è riportato il log degli errori corrispondente.

<?xml version="1.0" encoding="UTF-8"?>  
<DriveLog Version="2014-11-01">  
    <DriveId>WD-WMATV6965824</DriveId>  
    <Blob Status="CompletedWithErrors">  
       <BlobPath>pictures/bob/animals/koala.jpg</BlobPath>  
       <FilePath>\Users\bob\Pictures\animals\koala.jpg</FilePath>  
       <Length>163840</Length>  
       <ImportDisposition Status="Overwritten">overwrite</ImportDisposition>  
       <PageRangeList>  
          <PageRange Offset="65536" Length="65536" Hash="AA2585F6F6FD01C4AD4256E018240CD4" Status="Corrupted"/>  
       </PageRangeList>  
    </Blob>  
    <Status>CompletedWithErrors</Status>  
</DriveLog>

Il log degli errori seguente per un processo di importazione contiene un errore relativo a un file non trovato nell'unità di importazione. Si noti che lo stato dei componenti successivi è Cancelled.

<?xml version="1.0" encoding="utf-8"?>  
<DriveLog Version="2014-11-01">  
  <DriveId>9WM35C2V</DriveId>  
  <Blob Status="FileNotFound">  
    <BlobPath>pictures/animals/koala.jpg</BlobPath>  
    <FilePath>\animals\koala.jpg</FilePath>  
    <Length>30310</Length>  
    <ImportDisposition Status="Cancelled">rename</ImportDisposition>  
    <BlockList>  
      <Block Offset="0" Length="6062" Id="MD5/cAzn4h7VVSWXf696qp5Uaw==" Hash="700CE7E21ED55525977FAF7AAA9E546B" Status="Cancelled" />  
      <Block Offset="6062" Length="6062" Id="MD5/PEnGwYOI8LPLNYdfKr7kAg==" Hash="3C49C6C18388F0B3CB35875F2ABEE402" Status="Cancelled" />  
      <Block Offset="12124" Length="6062" Id="MD5/FG4WxqfZKuUWZ2nGTU2qVA==" Hash="146E16C6A7D92AE5166769C64D4DAA54" Status="Cancelled" />  
      <Block Offset="18186" Length="6062" Id="MD5/ZzibNDzr3IRBQENRyegeXQ==" Hash="67389B343CEBDC8441404351C9E81E5D" Status="Cancelled" />  
      <Block Offset="24248" Length="6062" Id="MD5/ZzibNDzr3IRBQENRyegeXQ==" Hash="67389B343CEBDC8441404351C9E81E5D" Status="Cancelled" />  
    </BlockList>  
  </Blob>  
  <Status>CompletedWithErrors</Status>  
</DriveLog>

Il log degli errori seguente per un processo di esportazione indica che il contenuto del BLOB è stato scritto correttamente nell'unità, ma si è verificato un errore durante l'esportazione le proprietà del BLOB.

<?xml version="1.0" encoding="utf-8"?>  
<DriveLog Version="2014-11-01">  
  <DriveId>9WM35C3U</DriveId>  
  <Blob Status="CompletedWithErrors">  
    <BlobPath>pictures/wild/canyon.jpg</BlobPath>  
    <FilePath>\pictures\wild\canyon.jpg</FilePath>  
    <LastModified>2012-09-18T23:47:08Z</LastModified>  
    <Length>163840</Length>  
    <BlockList />  
    <Properties Status="Failed" />  
  </Blob>  
  <Status>CompletedWithErrors</Status>  
</DriveLog>

Passaggi successivi

Storage Import/Export REST API (API REST di importazione/esportazione dell'archiviazione)