Använda loggar för att felsöka uppladdningsproblem i Azure Data Box Disk

Den här artikeln beskriver de problem du ser när du laddar upp data i Azure-datacentret med hjälp av Azure Data Box Disk.

Om uppladdningsloggar

När data från en Data Box Disk laddas upp i Azure-datacentret genereras en kopierings-/fellogg och en utförlig logg för varje lagringskonto. Dessa loggar laddas upp till samma lagringskonto som användes för att ladda upp data.

  • 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

Gör följande för att hitta loggarna från en datauppladdning.

  1. Öppna din beställning i Azure-portalen.

  2. När datauppladdningen slutförs för varje disk visar fönstret Översikt diskstatus och sökvägarna till diagnostikloggar för disken.

    • För nya beställningar ser diskinformationen ut som på följande skärm. 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.

      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.

      Loggarna laddas upp till en container (för blobimporter) 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 dina tidigare beställningar kan visningen se ut som på följande skärm.

      Om det uppstår fel vid uppladdning av data till Azure visar Kopieringsloggar en sökväg till mappen där diagnostikloggarna finns.

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

      Loggarna laddas upp till en waies container i lagringskontot. URL:erna har följande format:

      Loggtyp URL-format
      fellogg <storage-account-name>/databoxlogs-order-name<>/waies/ri-order-name-guid_<<>drive-ID>_<timestamp>_error.xml
      utförlig logg <storage-account-name>/databoxlogs-order-name<>/waies/ri-order-name-guid_<<>drive-ID>_<timestamp>_verbose.xml

    Kommentar

    Loggar i containern databoxcopylog har ett annat format än loggarna i containern waies . Om du vill ha hjälp med att tolka loggarna använder du anvisningarna för den associerade enhetsloggversionen. Mer information finns i Identifiera loggversion .

  3. Om du vill visa loggarna öppnar du containern som lagrar loggarna i ditt lagringskonto. Följande bild visar loggarna i en waies container.

    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. Välj varje logg och ladda ned en lokal kopia.

Identifiera loggversion

Det finns två versioner av kopierings-/felloggen och utförlig logg med olika format. Loggversionerna beskrivs separat i de avsnitt som följer.

Tillsammans med den utförliga loggen visas antingen en kopieringslogg (_copy.xml) eller en fellogg (_error.xml), beroende på enhetsversionen.

Om du vill ta reda på loggversionen för både kopierings-/felloggen och den medföljande utförliga loggen kontrollerar du enhetsloggversionen i kopierings-/felloggen.

Namn på loggfil Fält Enhetsloggversion
_copy.xml DriveLogVersion 2021-08-01
_error.xml DriveLog-version 2018-10-01

Följande bild visar DriveLogVersion i sammanfattningsavsnittet i en kopieringslogg.

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

Exempel på uppladdningsloggar

Loggformaten för kopierings-/felloggen och utförlig logg skiljer sig åt för de två loggversionerna. Om du inte är säker på vilken version av loggarna du har läser du Identifiera loggversion.

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

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, med följande information för varje fil. Den utförliga loggen innehåller inte sammanfattningsinformation.

Fält Description
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

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, med felinformation. Kopieringsloggen avslutas med en sammanfattning av validerings- och kopieringsfel som inträffade under importen.

Varje felpost innehåller följande information.

Fält Description
Sökväg Målresursen i containern eller filresursen.
Kategori En av 15 felkategorier. Mer information finns i Dataöverföringsfel för Loggversion 2021-08-01.
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

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>

Dataöverföringsfel

De fel som rapporteras i loggarna varierar något i de två loggversionerna. Om du inte är säker på vilken version av loggarna du har läser du Identifiera loggversion.

De fel som hittades i kopieringsloggen 2018-10-01 beskrivs nedan.

Felkategori Description
UploadErrorWin32 Filsystemfel.
UploadErrorCloudHttp Blobtyp som inte stöds. Mer information om fel i den här kategorin finns i Sammanfattning av uppladdningsfel.
UploadErrorDataValidationError CRC som beräknas under datainmatningen matchar inte den CRC som beräknas under uppladdningen.
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.
UploadErrorUnknownType Ett okänt fel.
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.>
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.>
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.>
FileRenamed Filen har bytt namn eftersom det ursprungliga filnamnet inte följer Azures namngivningskonventioner. Den ursprungliga bloben har bytt namn till AzureFile/DataBox-GUID<> från <det ursprungliga namnet.>
DiskRenamed Namn på den hanterade diskfilen eftersom det ursprungliga filnamnet inte följer Azures namngivningskonventioner. Den ursprungliga hanterade diskfilen bytte namn till ManagedDisk/DataBox-GUID<> från< det ursprungliga namnet.>
ExportCloudHttp Blobtyp som inte stöds.

Nästa steg

Kontakta Microsoft Support.