Logboeken gebruiken om problemen met import en exports via Azure Import/Export op te lossen

  • Artikel

Wanneer de Microsoft Azure Import/Export-service de stations voor een import- of exporttaak verwerkt, schrijft de service logboeken en uitgebreide logboeken naar het opslagaccount dat u hebt gebruikt. Beide logboeken worden opgeslagen voor elk station.

  • Het kopieerlogboek rapporteert gebeurtenissen voor alle mislukte kopieerbewerkingen tussen de schijf en het Azure Storage-account. Het kopieerlogboek eindigt met een samenvatting van fouten per foutcategorie.

  • Het uitgebreide logboek bevat een lijst met alle kopieerbewerkingen die zijn geslaagd voor elke blob en elk bestand.

De logboeken zoeken

Wanneer u de Import/Export-service gebruikt om een import- of exporttaak te maken in Azure Data Box, bekijkt u de import-/exporttaak samen met uw andere Data Box-resources .

Gebruik de volgende stappen om de status van de gegevenskopieën voor een import-/exporttaak te achterhalen:

  1. Meld u aan bij het Azure-portaal.

  2. Zoek naar Azure Data Box.

    Schermopname van het zoeken naar Data Box-taken in Azure Portal. Het zoekvak en de geselecteerde Azure Data Box-service zijn gemarkeerd.

  3. Als u wilt filteren op Azure Import/Export-taken, voert u 'Import/Export' in het zoekvak in.

    Schermopname van het filteren van Data Box-resources in Azure Portal om import-/exporttaken weer te geven. Het zoekvak is gemarkeerd.

    Er wordt een lijst met import-/exporttaken weergegeven op de pagina.

    Schermopname van Data Box-resources in Azure Portal gefilterd op Import Export-taken. De taaknaam, het overdrachtstype, de status en het model zijn gemarkeerd.

  4. Bekijk taakdetails door een taaknaam te selecteren.

    De huidige orderstatus van de geselecteerde taak en de gegevenskopieergegevens worden weergegeven voor elk station.

    • Als u toegang hebt tot het opslagaccount, kunt u een pad naar het logboek kopiëren of uitgebreid logboekpad selecteren om het logboek weer te geven.

    • Selecteer een stations-id om een deelvenster met volledige kopieergegevens te openen, inclusief het manifestbestand en de hash.

    Schermopname van het overzicht voor een importexporttaak in Azure Portal. De orderstatus en de gegevenskopieerstatus en logboek-URL's voor een station zijn gemarkeerd.

Er wordt automatisch een kopielogboek opgeslagen. Als u ervoor kiest om uitgebreide logboeken op te slaan wanneer u uw bestelling hebt geplaatst, ziet u ook het pad naar het uitgebreide logboek.

De logboeken worden geüpload naar een container (voor blobimport en export) of share (voor import naar Azure Files) in het opslagaccount. De container krijgt de naam databoxcopylog. De URL's hebben de volgende indelingen:

Logboektype URL-indeling
logboek kopiëren <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_CopyLog_<job-ID>.xml
uitgebreid logboek <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_VerboseLog_<job-ID>.xml

Voor exporttaken wordt ook een manifestbestand opgeslagen op de schijf.

Elke gegevensoverdracht voor een schijf genereert een kopielogboek. Als u ervoor kiest om een uitgebreid logboek op te slaan bij het maken van de bestelling, is er ook een uitgebreid logboek in dezelfde map.

Notitie

Voor uw eerdere orders vindt u mogelijk een foutenlogboek (_error.xml) samen met het uitgebreide logboek in een waies container in het opslagaccount. De DriveLog Version, die wordt weergegeven in de samenvatting van het foutenlogboek, wordt weergegeven 2018-10-01. De logboekindelingen verschillen van de indelingen die in dit artikel worden beschreven.

Importlogboeken controleren

Tijdens een import genereert de import-/exportservice een uitgebreid logboek en een kopieerlogboek voor elke schijf.

Uitgebreid logboek

Het uitgebreide logboek is een optioneel bestand dat u tijdens het bestellen kunt inschakelen. Het is een eenvoudige lijst van alle bestanden die zijn geïmporteerd vanaf het station. Het uitgebreide logboek bevat de volgende informatie voor elk bestand. Het uitgebreide logboek biedt geen samenvattingsgegevens.

Veld Beschrijving
CloudOpmaak BlockBlob, PageBlob of AzureFile.
Pad Pad naar het bestand in het opslagaccount.
Tekengrootte Grootte van bestand of blob.
crc64 De cyclische redundantiecontrole 64 (CRC64) controlesom die is gebruikt om de gegevensintegriteit tijdens de gegevensoverdracht te verifiëren.

Uitgebreid voorbeeldlogboek: importeren

Het volgende uitgebreide voorbeeldlogboek bevat voorbeeldbestandvermeldingen voor blok-blob-, pagina-blob- en Azure File-importbewerkingen.

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

Logboek kopiëren

Het kopieerlogboek bevat een foutvermelding voor elk bestand dat niet kan worden geïmporteerd of geëxporteerd, met foutdetails. Het kopieerlogboek eindigt met een samenvatting van validatie- en kopieerfouten die zijn opgetreden tijdens de gegevensoverdracht.

Elke foutvermelding bevat de volgende informatie.

Veld Beschrijving
Pad De doelshare in de container of bestandsshare.
Categorie Identificeert de foutcategorie. Zie Fouten bij gegevensoverdracht voor meer informatie.
ErrorCode De numerieke code voor de fout.
ErrorMessage Beschrijft de fout.

De samenvatting aan het einde van het logboek (zoek naar CopyLog Summary) geeft de volgende informatie:

  • Stationslogboekversie (in dit geval 2021-08-01)
  • Stations-ID
  • Status van gegevenskopieer
  • Samenvatting van validatiefouten per foutcategorie
  • Samenvatting van kopieerfouten per foutcategorie

Voorbeeld van kopieerlogboek: importeren

Het volgende voorbeeld is een kopieerlogboek voor een import naar Zowel Azure Files als Azure Blob Storage.

Deze kopie is mislukt, zonder validatiefouten, maar met drie kopieerfouten. De naam van één bestandsshare is gewijzigd (ShareRenamed fout) en er zijn twee containers hernoemd (ContainerRenamed fout). De foutvermelding geeft de oorspronkelijke en nieuwe bestandsnamen.

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

Exportlogboeken controleren

Tijdens een export genereert de import-/exportservice een uitgebreid logboek en een kopieerlogboek voor elke gegevensoverdracht van Azure Storage naar een schijf. Er is ook een manifestbestand dat op de schijf wordt opgeslagen.

Uitgebreid logboek

Het uitgebreide logboek voor een export is een eenvoudige lijst van alle bestanden die zijn geëxporteerd van het Azure-opslagaccount naar het station. Het uitgebreide logboek bevat de volgende informatie voor elk bestand. Het uitgebreide logboek biedt geen samenvattingsgegevens.

Veld Beschrijving
CloudOpmaak BlockBlob, PageBlob of AzureFile.
Etag De entiteitstag (ETag) voor de resource, die wordt gebruikt voor gelijktijdigheidscontrole tijdens de gegevensoverdracht.
Pad Pad naar het bestand in het opslagaccount.
Tekengrootte Grootte van bestand of blob.
crc64 De cyclische redundantiecontrole 64 (CRC64) controlesom die is berekend tijdens het exporteren van gegevens naar schijf.

Uitgebreid voorbeeldlogboek: exporteren

In het volgende uitgebreide voorbeeldlogboek heeft de exporttaak drie blobs overgebracht uit 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>

Logboek kopiëren

Het kopieerlogboek voor een export bevat een foutvermelding voor elk bestand dat niet kan worden overgedragen van Azure Storage naar de schijf, met foutdetails. Het kopieerlogboek eindigt met een samenvatting van validatie- en kopieerfouten die zijn opgetreden tijdens de gegevensoverdracht.

In het kopieerlogboek voor een export worden problemen gerapporteerd, zoals een gegevensoverdracht die mislukt vanwege een beschadigd station of een opslagaccountsleutel die is gewijzigd tijdens de gegevensoverdracht. Zie Fouten bij gegevensoverdracht voor een lijst met problemen.

Voorbeeld van kopieerlogboek: exporteren

Het volgende voorbeeld is een kopieerlogboek voor een export die is opgetreden bij drie bestandssysteemfouten ( UploadErrorWin32) waardoor de export van drie bestanden is mislukt. Fout 267 geeft aan dat de mapnaam ongeldig is. Fout 123 geeft een onjuiste bestandsnaam, mapnaam of volumelabelsyntaxis aan.

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

Fouten bij gegevensoverdracht

U vindt de volgende fouten in de kopieerlogboeken voor importtaken en/of exporttaken.

Foutcategorie Foutmelding Imports Exports
UploadErrorWin32 Bestandssysteemfout. Ja Ja
UploadErrorCloudHttp Niet-ondersteund blobtype. Zie Samenvatting van uploadfouten voor meer informatie over fouten in deze categorie. Ja Ja
UploadErrorDataValidationError CRC berekend tijdens gegevensopname komt niet overeen met de CRC die tijdens het uploaden is berekend. Ja Ja
UploadErrorManagedConversionError De grootte van de blob die wordt geïmporteerd, is ongeldig. De blobgrootte is <bytes van blobgrootte>. Ondersteunde grootten liggen tussen 20971520 bytes en 8192 GiB. Zie Samenvatting van uploadfouten voor meer informatie. Ja Ja
UploadErrorUnknownType Onbekende fout. Ja Ja
ContainerRenamed De naam van de container is gewijzigd omdat de oorspronkelijke containernaam niet aan de naamconventies van Azure volgt. De naam van de oorspronkelijke container is gewijzigd in DataBox-GUID<> van< de oorspronkelijke containernaam.> Nr. Ja
ShareRenamed De naam van de share is gewijzigd omdat de naam van de oorspronkelijke share niet volgt op de naamconventies van Azure. De oorspronkelijke share is gewijzigd in DataBox-GUID<> van< de oorspronkelijke mapnaam.> Nr. Ja
BlobRenamed De naam van de blob is gewijzigd omdat de oorspronkelijke blobnaam niet aan de naamconventies van Azure volgt. De naam van de oorspronkelijke blob is gewijzigd in BlockBlob/DataBox-GUID<> van< de oorspronkelijke naam.> Nr. Ja
FileRenamed De naam van het bestand is gewijzigd omdat de oorspronkelijke bestandsnaam niet aan de naamconventies van Azure volgt. De naam van het oorspronkelijke bestand is gewijzigd in AzureFile/DataBox-GUID<> van< de oorspronkelijke naam.> Nr. Ja
DiskRenamed De naam van het beheerde schijfbestand is gewijzigd omdat de oorspronkelijke bestandsnaam niet aan de naamconventies van Azure voor beheerde schijven volgt. De naam van het oorspronkelijke beheerde schijfbestand is gewijzigd in ManagedDisk/DataBox-GUID<> van< de oorspronkelijke naam.> Nr. Ja
FileNameTrailsWithSlash De blobnaam of bestandsnaam eindigt met een afsluitende slash. Een blobnaam of bestandsnaam die eindigt op een afsluitende backslash of slash, kan niet worden geëxporteerd naar schijf. Nr. Ja
ExportCloudHttp Niet-ondersteund blobtype. Nr. Ja

Volgende stappen