Använda loggar för att felsöka importer och exporter via Azure Import/Export

  • Artikel

När Microsoft Azure Import/Export-tjänsten bearbetar enheterna för ett import- eller exportjobb skriver tjänsten kopieringsloggar och utförliga loggar till det lagringskonto som du använde. Båda loggarna sparas för varje enhet.

  • Kopieringsloggen rapporterar händelser för alla misslyckade kopieringsåtgärder mellan disken och Azure Storage-kontot. Kopieringsloggen slutar med en sammanfattning av fel efter felkategori.

  • Den utförliga loggen innehåller en lista över alla kopieringsåtgärder som lyckades på varje blob och fil.

Leta upp loggarna

När du använder import-/exporttjänsten för att skapa ett import- eller exportjobb i Azure Data Box visas import-/exportjobbet tillsammans med dina andra Data Box-resurser .

Använd följande steg för att ta reda på status för datakopior för ett import-/exportjobb:

  1. Logga in på Azure-portalen.

  2. Sök efter azure data box.

    Skärmbild som visar hur du söker efter Data Box-jobb i Azure-portalen. Sökrutan och den valda Azure Data Box-tjänsten är markerade.

  3. Om du vill filtrera till Azure Import/Export-jobb anger du "Import/Export" i sökrutan.

    Skärmbild som visar hur du filtrerar Data Box-resurser i Azure-portalen för att visa import-/exportjobb. Sökrutan är markerad.

    En lista över import-/exportjobb visas på sidan.

    Skärmbild av Data Box-resurser i Azure-portalen som filtrerats till importexportjobb. Jobbnamnet, överföringstypen, statusen och modellen är markerade.

  4. Visa jobbinformation genom att välja ett jobbnamn.

    Det valda jobbets aktuella orderstatus och datakopieringsinformation visas för varje enhet.

    • Om du har åtkomst till lagringskontot kan du välja en sökväg för kopieringsloggen eller Utförlig loggsökväg för att visa loggen.

    • Välj ett enhets-ID för att öppna en panel med fullständig kopieringsinformation, inklusive manifestfilen och hashen.

    Skärmbild av översikten för ett importexportjobb i Azure-portalen. Orderstatus, datakopieringsstatus och logg-URL:er för en enhet är markerade.

En kopieringslogg sparas automatiskt. Om du väljer att spara utförliga loggar när du har gjort din beställning visas även sökvägen till den utförliga loggen.

Loggarna laddas upp till en container (för blobimport och export) eller resurs (för import till Azure Files) i lagringskontot. Containern heter databoxcopylog. URL:erna har följande format:

Loggtyp URL-format
kopiera logg <storage-account-name/databoxcopylog/<order-name>_<device-serial-number>_CopyLog_<job-ID>.xml>
utförlig logg <storage-account-name/databoxcopylog/<order-name>_<device-serial-number>_VerboseLog_<job-ID>.xml>

För exportjobb sparas även en manifestfil på disken.

Varje dataöverföring för en disk genererar en kopieringslogg. Om du väljer att spara en utförlig logg när du skapade ordern finns det också en utförlig logg i samma mapp.

Kommentar

För dina tidigare beställningar kan du hitta en fellogg (_error.xml) tillsammans med den utförliga loggen i en waies container i lagringskontot. Den DriveLog Version, som visas i felloggsammanfattningen, blir 2018-10-01. Loggformaten skiljer sig från de som beskrivs i den här artikeln.

Granska importloggar

Under en import genererar tjänsten Import/Export en utförlig logg och en kopieringslogg för varje disk.

Utförlig logg

Den utförliga loggen är en valfri fil som du kan aktivera under beställningen. Det är en enkel lista över alla filer som har importerats från enheten. Den utförliga loggen ger följande information för varje fil. Den utförliga loggen innehåller inte sammanfattningsinformation.

Fält beskrivning
CloudFormat BlockBlob, PageBlob eller AzureFile.
Sökväg Sökväg till filen i lagringskontot.
Storlek Fil- eller blobstorlek.
crc64 Kontrollsumman för cyklisk redundanskontroll 64 (CRC64) som användes för att verifiera dataintegriteten under dataöverföringen.

Exempel på utförlig logg: import

Följande utförliga exempellogg innehåller exempelfilposter för blockblob, sidblob och Azure File-importer.

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

Kopiera logg

Kopieringsloggen innehåller en felpost för varje fil som inte kunde importeras eller exporteras, med felinformation. Kopieringsloggen avslutas med en sammanfattning av validerings- och kopieringsfel som inträffade under dataöverföringen.

Varje felpost innehåller följande information.

Fält beskrivning
Sökväg Målresursen i containern eller filresursen.
Kategori Identifierar felkategorin. Mer information finns i Dataöverföringsfel.
Felkod Den numeriska koden för felet.
ErrorMessage Beskriver felet.

Sammanfattningen i slutet av loggen (leta CopyLog Summaryefter ) ger följande information:

  • Enhetsloggversion (i det här fallet 2021-08-01)
  • Enhets-ID
  • Status för datakopiering
  • Sammanfattning av valideringsfel efter felkategori
  • Sammanfattning av kopieringsfel efter felkategori

Exempel på kopieringslogg: importera

Följande exempel är en kopieringslogg för en import till både Azure Files och Azure Blob Storage.

Den här kopian misslyckades utan valideringsfel men med tre kopieringsfel. En filresurs har bytt namn (ShareRenamed fel) och två containrar har bytt namn (ContainerRenamed fel). Felposten ger de ursprungliga och nya filnamnen.

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

Granska exportloggar

Under en export genererar import-/exporttjänsten en utförlig logg och en kopieringslogg för varje dataöverföring från Azure Storage till en disk. Det finns också en manifestfil som sparas på disken.

Utförlig logg

Den utförliga loggen för en export är en enkel lista över alla filer som har exporterats från Azure Storage-kontot till enheten. Den utförliga loggen ger följande information för varje fil. Den utförliga loggen innehåller inte sammanfattningsinformation.

Fält beskrivning
CloudFormat BlockBlob, PageBlob eller AzureFile.
Etag Entitetstaggen (ETag) för resursen, som används för samtidighetskontroll under dataöverföringen.
Sökväg Sökväg till filen i lagringskontot.
Storlek Fil- eller blobstorlek.
crc64 Kontrollsumman för cyklisk redundanskontroll 64 (CRC64) som beräknades vid export av data till disk.

Utförlig exempellogg: exportera

I följande utförliga exempellogg överförde exportjobbet tre blobar från Azure Blob Storage.

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

Kopiera logg

Kopieringsloggen för en export innehåller en felpost för varje fil som inte kunde överföras från Azure Storage till disken med felinformation. Kopieringsloggen avslutas med en sammanfattning av validerings- och kopieringsfel som inträffade under dataöverföringen.

Kopieringsloggen för en export rapporterar problem, till exempel en dataöverföring som misslyckas på grund av en skadad enhet eller en lagringskontonyckel som ändrades under dataöverföringen. En lista över problem finns i Dataöverföringsfel.

Exempel på kopieringslogg: exportera

Följande exempel är en kopieringslogg för en export som stötte på tre filsystemfel ( UploadErrorWin32) som gjorde att exporten av tre filer misslyckades. Fel 267 anger att katalognamnet är ogiltigt. Fel 123 anger ett felaktigt filnamn, katalognamn eller volymetikettsyntax.

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

Dataöverföringsfel

Du hittar följande fel i kopieringsloggarna för importjobb och/eller exportjobb.

Felkategori Felmeddelande Importer Exporter
UploadErrorWin32 Filsystemfel. Ja Ja
UploadErrorCloudHttp Blobtyp som inte stöds. Mer information om fel i den här kategorin finns i Sammanfattning av uppladdningsfel. Ja Ja
UploadErrorDataValidationError CRC som beräknas under datainmatningen matchar inte den CRC som beräknas under uppladdningen. Ja Ja
UploadErrorManagedConversionError Storleken på den blob som importeras är ogiltig. Blobstorleken är <byte i blobstorlek>. Storlekar som stöds är mellan 20971520 byte och 8192 GiB. Mer information finns i Sammanfattning av uppladdningsfel. Ja Ja
UploadErrorUnknownType Ett okänt fel. Ja Ja
ContainerRenamed Namn på containern eftersom det ursprungliga containernamnet inte följer Azures namngivningskonventioner. Den ursprungliga containern har bytt namn till DataBox-GUID<> från <det ursprungliga containernamnet.> Nej Ja
ShareRenamed Resursen har bytt namn eftersom det ursprungliga resursnamnet inte följer Azures namngivningskonventioner. Den ursprungliga resursen har bytt namn till DataBox-GUID<> från <det ursprungliga mappnamnet.> Nej Ja
BlobRenamed Namn på bloben eftersom det ursprungliga blobnamnet inte följer Azures namngivningskonventioner. Den ursprungliga bloben har bytt namn till BlockBlob/DataBox-GUID<> från <det ursprungliga namnet.> Nej Ja
FileRenamed Filen har bytt namn eftersom det ursprungliga filnamnet inte följer Azures namngivningskonventioner. Den ursprungliga filen har bytt namn till AzureFile/DataBox-GUID<> från< det ursprungliga namnet.> Nej Ja
DiskRenamed Namn på den hanterade diskfilen eftersom det ursprungliga filnamnet inte följer Azures namngivningskonventioner för hanterade diskar. Den ursprungliga hanterade diskfilen bytte namn till ManagedDisk/DataBox-GUID<> från< det ursprungliga namnet.> Nej Ja
FileNameTrailsWithSlash Blobnamn eller filnamn slutar med ett avslutande snedstreck. Det går inte att exportera ett blobnamn eller filnamn som slutar med ett avslutande snedstreck eller snedstreck. Nej Ja
ExportCloudHttp Blobtyp som inte stöds. Nej Ja

Nästa steg