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.

     

     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.

     

     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.

   

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.

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

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>

Loggversion: 2018-10-01

I enhetsloggversion 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 nedan. I det här fallet har ordern slutförts 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å _error.xml nedan.

<?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 nedan där ordern slutfördes med fel.

Felfilen i det här fallet har ett avsnitt och ett Summary annat avsnitt som innehåller alla fel på filnivå.

Innehåller SummaryValidationErrors och CopyErrors. I det här fallet laddades 8 filer eller mappar upp till Azure och det fanns inga verifieringsfel. När data kopierades till Azure Storage-kontot laddades 5 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

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.

Loggversion: 2018-10-01

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	Description
Renamed	Bloben har bytt namn.
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	Uppladdade filer som inte ingick i någon mapp till en standardresurs. Resursnamnet 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 är suffix med SHA1-hashen för det ursprungliga namnet
ShareRenamed	Resursen för dessa filer överensstämde inte med Namngivningskonventionerna för Azure och har bytt namn. Det nya namnet börjar med databox- och är suffixet med SHA1-hashen för det ursprungliga namnet.
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.