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

2025-04-04

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å alla blobbar och filer.

Hitta loggarna

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

Öppna din beställning i Azure-portalen.

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 gjorde din beställning visas även sökvägen till den utförliga loggen.

Skärmdump av översiktsfönstret för en Data Box Disk-beställning med statusen Kopiering slutförd med varningar. En kopieringsloggsökväg och en utförlig loggsökväg är markerade.

Loggarna laddas upp till en container (för blobimporter) eller dela (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.

Skärmbild av fönstret Översikt för en tidigare Data Box Disk-beställning med slutförda kopior. Sökvägarna för kopieringsloggen är markerade.

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

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

Anmärkning

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 .

Om du vill visa loggarna öppnar du containern som lagrar loggarna i ditt lagringskonto. Följande bild visar loggarna i en waies container.
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å enhetsutgåvan.

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	Körloggversion
_copy.xml	DriveLogVersion	2021-08-01
_error.xml	DriveLog-version	2018-10-01

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

Bild av avsnittet Sammanfattning i en kopieringslogg för en Data Box Disk-beställning. Enhetsloggversionen är markerad.

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.

Loggversion: 2021-08-01
Loggversion: 2018-10-01

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	Beskrivning
CloudFormat	BlockBlob, PageBlob eller AzureFile.
Vä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	Beskrivning
Väg	Deldestinationen inom behållaren eller fildelningen.
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.
Felmeddelande	Beskriver felet.

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

Körjournalversion (i det här fallet 2021-08-01)
Drive-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>

I körloggversion 2018-10-01 genererar datauppladdningen en fellogg och en utförlig logg. Båda loggarna har samma format och innehåller XML-beskrivningar av de händelser som inträffade när data kopierades från disken till Azure Storage-kontot.

Den utförliga loggen innehåller fullständig information om status för kopieringsåtgärden för varje blob eller fil, medan felloggen endast innehåller information om blobar eller filer som påträffade fel under uppladdningen.

Felloggen har samma struktur som den utförliga loggen, men filtrerar bort lyckade åtgärder.

Exempel på utförlig logg

Ett exempel på _verbose.xml visas här. I det här fallet slutfördes ordern utan fel.


<?xml version="1.0" encoding="utf-8"?>
<DriveLog Version="2018-10-01">
  <DriveId>184020D95632</DriveId>
  <Blob Status="Completed">
    <BlobPath>$root/botetapageblob.vhd</BlobPath>
    <FilePath>\PageBlob\botetapageblob.vhd</FilePath>
    <Length>1073742336</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <PageRangeList>
      <PageRange Offset="0" Length="4194304" Status="Completed" />
      <PageRange Offset="4194304" Length="4194304" Status="Completed" />
      <PageRange Offset="8388608" Length="4194304" Status="Completed" />
      --------CUT-------------------------------------------------------
      <PageRange Offset="1061158912" Length="4194304" Status="Completed" />
      <PageRange Offset="1065353216" Length="4194304" Status="Completed" />
      <PageRange Offset="1069547520" Length="4194304" Status="Completed" />
      <PageRange Offset="1073741824" Length="512" Status="Completed" />
    </PageRangeList>
  </Blob>
  <Blob Status="Completed">
    <BlobPath>$root/botetablockblob.txt</BlobPath>
    <FilePath>\BlockBlob\botetablockblob.txt</FilePath>
    <Length>19</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <BlockList>
      <Block Offset="0" Length="19" Status="Completed" />
    </BlockList>
  </Blob>
  <File Status="Completed">
    <FileStoragePath>botetaazurefilesfolder/botetaazurefiles.txt</FileStoragePath>
    <FilePath>\AzureFile\botetaazurefilesfolder\botetaazurefiles.txt</FilePath>
    <Length>20</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <FileRangeList>
      <FileRange Offset="0" Length="20" Status="Completed" />
    </FileRangeList>
  </File>
  <Status>Completed</Status>
</DriveLog>

Exempel på felloggar

För samma ordning visas ett exempel på det _error.xml här.


<?xml version="1.0" encoding="utf-8"?>
<DriveLog Version="2018-10-01">
  <DriveId>184020D95632</DriveId>
  <Summary>
    <ValidationErrors>
      <None Count="3" />
    </ValidationErrors>
    <CopyErrors>
      <None Count="3" Description="No errors encountered" />
    </CopyErrors>
  </Summary>
  <Status>Completed</Status>
</DriveLog>

Ett exempel på _error.xml visas här där ordern slutfördes med fel.

Felfilen i det här fallet har en Summary-sektion och en annan sektion som innehåller alla fel på filnivå.

Den Summary innehåller ValidationErrors och CopyErrors. I det här fallet laddades åtta filer eller mappar upp till Azure och det fanns inga verifieringsfel. När data kopierades till Azure Storage-kontot laddades fem filer eller mappar upp. De återstående tre filerna eller mapparna bytte namn enligt namngivningskonventionerna för Azure-containrar och laddades sedan upp till Azure.

Statusar på filnivå finns i BlobStatus, som beskriver alla åtgärder som vidtas för att ladda upp blobarna. I det här fallet byts tre containrar namn eftersom mapparna som data kopierades till inte överensstämde med Azures namngivningskonventioner för containrar. För de blobar som laddats upp i dessa containrar ingår det nya containernamnet, blobens sökväg i Azure, den ursprungliga ogiltiga filsökvägen och blobstorleken.

 <?xml version="1.0" encoding="utf-8"?>
  <DriveLog Version="2018-10-01">
    <DriveId>18041C582D7E</DriveId>
    <Summary>
      <ValidationErrors>
        <None Count="8" />
      </ValidationErrors>
      <CopyErrors>
        <Completed Count="5" Description="No errors encountered" />
        <ContainerRenamed Count="3" Description="Renamed the container as the original container name does not follow Azure conventions." />
      </CopyErrors>
    </Summary>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/private.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\private.vhd</OriginalFilePath>
      <SizeInBytes>10490880</SizeInBytes>
    </Blob>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/resource.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\resource.vhd</OriginalFilePath>
      <SizeInBytes>71528448</SizeInBytes>
    </Blob>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/role.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\role.vhd</OriginalFilePath>
      <SizeInBytes>10490880</SizeInBytes>
    </Blob>
    <Status>CompletedWithErrors</Status>
  </DriveLog>

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.

Loggversion: 2021-08-01
Loggversion: 2018-10-01

De fel som hittades i kopieringsloggen 2018-10-01 beskrivs i den här tabellen.

Felkategori	Beskrivning
`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`	Döp om containern eftersom det ursprungliga containernamnet inte följer Azures namngivningskonventioner. Den ursprungliga containern har bytt namn till <> 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 <> från <det ursprungliga mappnamnet>.
`BlobRenamed`	Bytt namn på bloben eftersom det ursprungliga blobnamnet inte följer Azures namngivningskonventioner. Den ursprungliga bloben har bytt namn till BlockBlob/<> 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/<> från <det ursprungliga namnet>.
`DiskRenamed`	Bytte namn på den hanterade diskfilen eftersom det ursprungliga filnamnet inte följer Azures namngivningskonventioner. Den ursprungliga hanterade diskfilen bytte namn till ManagedDisk/<> från <det ursprungliga namnet>.
`ExportCloudHttp`	Blobtyp som inte stöds.

De fel som genereras vid uppladdning av data till Azure sammanfattas i följande tabell. Den här feluppsättningen finns i felloggen 2018-10-01.

Felkod	Beskrivning
`Renamed`	Bloben har bytt namn framgångsrikt.
`CompletedWithErrors`	Uppladdningen slutfördes med fel. Information om felfilerna ingår i loggfilen.
`Corrupted`	CRC som beräknas under datainmatningen matchar inte den CRC som beräknas under uppladdningen.
`StorageRequestFailed`	Azure Storage-begäran misslyckades.
`LeasePresent`	Det här objektet hyrs och används av en annan användare.
`StorageRequestForbidden`	Det gick inte att ladda upp på grund av autentiseringsproblem.
`ManagedDiskCreationTerminalFailure`	Det gick inte att ladda upp som hanterade diskar. Filerna är tillgängliga i mellanlagringskontot som sidblobar. Du kan konvertera sidblobar manuellt till hanterade diskar.
`DiskConversionNotStartedTierInfoMissing`	Eftersom VHD-filen kopierades utanför de förskapade nivåmapparna skapades ingen hanterad disk. Filen laddas upp som sidblob till mellanlagringskontot enligt beskrivningen när ordern skapas. Du kan konvertera den manuellt till en hanterad disk.
`InvalidWorkitem`	Det gick inte att ladda upp data eftersom de inte överensstämmer med Azures namngivnings- och begränsningskonventioner.
`InvalidPageBlobUploadAsBlockBlob`	Laddas upp som blockblobar i en container med prefixet `databoxdisk-invalid-pb-`.
`InvalidAzureFileUploadAsBlockBlob`	Laddas upp som blockblobar i en container med prefixet `databoxdisk-invalid-af`-.
`InvalidManagedDiskUploadAsBlockBlob`	Laddas upp som blockblobar i en container med prefixet `databoxdisk-invalid-md`-.
`InvalidManagedDiskUploadAsPageBlob`	Laddas upp som sidblobar i en container med prefixet `databoxdisk-invalid-md-`.
`MovedToOverflowShare`	Uppladdade filer till en ny resurs eftersom den ursprungliga resursstorleken överskred den maximala azure-storleksgränsen. Det nya filresursnamnet har det ursprungliga namnet suffixet med `-2`.
`MovedToDefaultAzureShare`	Filer som inte ingick i någon mapp laddades upp till en standarddelning. Andelsnamnet börjar med `databox-`.
`ContainerRenamed`	Containern för dessa filer överensstämde inte med Namngivningskonventionerna för Azure och har bytt namn. Det nya namnet börjar med `databox-` och följs av SHA1-hashen för det ursprungliga namnet.
`ShareRenamed`	Dela för dessa filer överensstämde inte med namngivningskonventionerna för Azure och har bytts om. Det nya namnet börjar med `databox-` och har SHA1-hashen av det ursprungliga namnet som ett suffix.
`BlobRenamed`	De här filerna överensstämde inte med Namngivningskonventionerna för Azure och har bytt namn. Kontrollera fältet `BlobPath` för det nya namnet.
`FileRenamed`	De här filerna överensstämde inte med Namngivningskonventionerna för Azure och har bytt namn. Kontrollera fältet `FileStoragePath` för det nya namnet.
`DiskRenamed`	De här filerna överensstämde inte med Namngivningskonventionerna för Azure och har bytt namn. Kontrollera fältet `BlobPath` för det nya namnet.

Nästa steg

Kontakta Microsoft Support.

Feedback

Var den här sidan till hjälp?

Dela via

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

Om uppladdningsloggar

Hitta loggarna

Identifiera loggversion

Exempel på uppladdningsloggar

Utförlig logg

Exempel på utförlig logg

Kopiera logg

Exempel på kopieringslogg

Dataöverföringsfel

Nästa steg

Feedback

Ytterligare resurser