Verwenden von Protokollen zur Behandlung von Problemen beim Hochladen in Azure Data Box Disk

In diesem Artikel werden die Probleme beschrieben, die beim Hochladen von Daten im Azure-Rechenzentrum mithilfe von Azure Data Box Disk auftreten.

Informationen zu Uploadprotokollen

Wenn die Daten aus einer Data Box Disk in das Azure-Rechenzentrum hochgeladen werden, werden für jedes Speicherkonto ein Kopier-/Fehlerprotokoll und ein ausführliches Protokoll generiert. Diese Protokolle werden in dasselbe Speicherkonto hochgeladen, das auch zum Hochladen der Daten verwendet wurde.

• Das Kopieprotokoll meldet Ereignisse für alle fehlgeschlagenen Kopiervorgänge zwischen dem Datenträger und dem Azure Storage-Konto. Das Kopierprotokoll endet mit einer Zusammenfassung der Fehler nach Fehlerkategorien.

• Das ausführliche Protokoll enthält eine Auflistung aller Kopiervorgänge, die für jeden Blob und jede Datei erfolgreich waren.

Suchen Sie die Protokolle

Gehen Sie folgendermaßen vor, um die Protokolle aus einem Datenupload zu finden.

1. Öffnen Sie Ihres Auftrags im Azure-Portal

2. Wenn der Datenupload für jeden Datenträger abgeschlossen ist, werden im Bereich Übersicht der Datenträgerstatus und die Pfade zu Diagnoseprotokollen für den Datenträger angezeigt.

   • Bei neuen Bestellungen sehen die Datenträgerdetails wie im folgenden Bildschirm aus. Es wird automatisch ein Kopierprotokoll gespeichert. Wenn Sie sich bei der Bestellung für die Speicherung von ausführlichen Protokollen entschieden haben, wird auch der Pfad zum ausführlichen Protokoll angezeigt.

     

     Die Protokolle werden in einen Container (für Blob-Importe) oder eine Freigabe (für Importe in Azure Files) im Speicherkonto hochgeladen. Der Container heißt databoxcopylog. Die URLs haben diese Formate:

     Protokolltyp	URL-Format
     Kopierprotokoll	<storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_CopyLog_<job-ID>.xml
     ausführliches Protokoll	<storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_VerboseLog_<job-ID>.xml

   • Für Ihre früheren Aufträge könnte die Anzeige wie auf dem folgenden Bildschirm aussehen.

     Wenn beim Hochladen der Daten in Azure Fehler auftreten, zeigt Kopierprotokolle einen Pfad zu dem Ordner an, in dem sich die Diagnoseprotokolle befinden.

     

     Die Protokolle werden in einen waies-Container im Speicherkonto hochgeladen. Die URLs haben diese Formate:

     Protokolltyp	URL-Format
     Fehlerprotokoll	<storage-account-name>/databoxlogs-<order-name>/waies/ri-<order-name>-guid_<drive-ID>_<timestamp>_error.xml
     ausführliches Protokoll	<storage-account-name>/databoxlogs-<order-name>/waies/ri-<order-name>-guid_<drive-ID>_<timestamp>_verbose.xml

   Hinweis

   Protokolle im Container databoxcopylog weisen ein anderes Format auf als Protokolle im waies-Container. Verwenden Sie die Anweisungen für die zugeordnete Laufwerksprotokollversion, um Hilfe beim Interpretieren der Protokolle zu erhalten. Weitere Informationen finden Sie unter Identifizieren der Protokollversion.

3. Öffnen Sie zum Anzeigen der Protokolle den Container, in dem die Protokolle in Ihrem Speicherkonto gespeichert werden. Die folgende Abbildung veranschaulicht die Protokolle in einem waies-Container.

   

4. Wählen Sie die einzelnen Protokolle aus, und laden Sie eine lokale Kopie herunter.

Identifizieren der Protokollversion

Es gibt zwei Versionen des Kopier-/Fehlerprotokolls und des ausführlichen Protokolls mit unterschiedlichen Formaten. Die Protokollversionen werden in den folgenden Abschnitten separat erläutert.

Zusammen mit dem ausführlichen Protokoll wird je nach Laufwerksfreigabe entweder ein Kopierprotokoll (_copy.xml) oder ein Fehlerprotokoll (_error.xml) angezeigt.

Um die Protokollfreigabe sowohl für das Kopier-/Fehlerprotokoll als auch für das zugehörige ausführliche Protokoll zu ermitteln, überprüfen Sie die Version des Laufwerksprotokolls im Kopier-/Fehlerprotokoll.

Protokolldateiname	Feld	Laufwerksprotokollversion
_copy.xml	DriveLogVersion	2021-08-01
_error.xml	DriveLog-Version	2018-10-01

Die folgende Abbildung zeigt DriveLogVersion die im Zusammenfassungsabschnitt eines Kopierprotokolls.

Beispiel für Uploadprotokolle

Die Protokollformate des Kopier-/Fehlerprotokolls und des ausführlichen Protokolls unterscheiden sich für die beiden Protokollversionen. Wenn Sie nicht sicher sind, über welche Version der Protokolle Sie verfügen, finden Sie weitere Informationen unter Identifizieren der Protokollversion.

Protokollversion: 01.08.2021

Jede Datenübertragung für eine Festplatte erzeugt ein Kopier log. Wenn Sie bei der Erstellung des Auftrags ein ausführliches Protokoll gespeichert haben, befindet sich im selben Ordner auch ein ausführliches Protokoll.

Ausführliches Protokoll

Das ausführliche log ist eine optionale Datei, die Sie bei der Bestellung aktivieren können. Es ist eine einfache Auflistung aller Dateien, die erfolgreich aus dem Laufwerk importiert wurden, mit den folgenden Informationen für jede Datei. Das ausführliche Protokoll liefert keine zusammenfassenden Informationen.

Feld	Beschreibung
CloudFormat	BlockBlob, PageBlob oder AzureFile.
Pfad	Pfad zur Datei innerhalb des Speicherkontos.
Size	Datei- oder Blobgröße.
crc64	Die CRC64-Prüfsumme (Cyclic Redundancy Check 64), die zur Überprüfung der Datenintegrität während der Datenübertragung verwendet wurde.

Beispiel eines ausführlichen Protokolls

Das folgende Beispiel für ein ausführliches log enthält Beispiel datei einträge für Blockblob-, Seitenblob- und Azure-Datei importieren.

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

Kopierprotokoll

Das Kopierprotokoll enthält für jede Datei, die nicht importiert werden konnte, einen Fehlereintrag mit Fehlerdetails. Das Kopierpotokoll endet mit einer Zusammenfassung der Validierungs- und Kopierfehler, die während des Imports aufgetreten sind.

Jeder Fehlereintrag enthält die folgenden Informationen.

Feld	Beschreibung
`Path`	Die Zielfreigabe innerhalb des Containers oder der Dateifreigabe.
Kategorie	Eine von 15 Fehlerkategorien. Für weitere Informationen siehe Datenübertragungsfehler für Protokollversion 01.08.2021.
ErrorCode	Der numerische Code für den Fehler.
ErrorMessage	Beschreibt den Fehler.

Die Zusammenfassung am Ende des Protokolls (suchen Sie nach CopyLog Summary) enthält die folgenden Informationen:

• Laufwerksprotokollversion (in diesem Fall 01.08.2021)
• Laufwerk-ID
• Status der Datenkopie
• Zusammenfassung der Validierungsfehler nach Fehlerkategorie
• Zusammenfassung der Kopierfehler nach Fehlerkategorie

Beispielkopierprotokoll

Das folgende Beispiel ist ein Kopier log für einen Importieren sowohl in Azure Files als auch in Azure Blob Storage.

Diese Kopie schlug fehl, zwar ohne Validierungsfehler, aber mit drei Kopierfehlern. Eine Dateifreigabe wurde umbenannt (ShareRenamed Fehler), und zwei Container wurden umbenannt (ContainerRenamed Fehler). Der Fehlereintrag enthält den ursprünglichen und den neuen Dateinamen.

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

Protokollversion: 01.10.2021

In der Laufwerksprotokollversion 01.08.2021 erzeugt der Datenupload ein Fehlerprotokoll und ein ausführliches Protokoll. Beide Protokolle weisen dasselbe Format auf und enthalten XML-Beschreibungen der Ereignisse, die aufgetreten sind, während die Daten vom Datenträger in das Azure Storage-Konto kopiert wurden.

Das ausführliche Protokoll enthält vollständige Informationen zum Status des Kopiervorgangs für jedes Blob oder jede Datei. Das Fehlerprotokoll enthält dagegen nur die Informationen zu Blobs oder Dateien, bei denen während des Hochladens Fehler aufgetreten sind.

Das Fehlerprotokoll hat die gleiche Struktur wie das ausführliche Protokoll; allerdings werden erfolgreiche Vorgänge herausgefiltert.

Beispiel eines ausführlichen Protokolls

Ein Beispiel für die Datei _verbose.xml wird nachfolgend gezeigt. In diesem Fall wurde der Auftrag ohne Fehler erfolgreich abgeschlossen.

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

Beispielfehlerprotokoll

Bei demselben Auftrag wird nachstehend ein Beispiel für die Datei _error.xml gezeigt.

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

Ein Beispiel für die Datei _error.xml wird nachstehend gezeigt, in dem der Auftrag mit Fehlern abgeschlossen wurde.

In diesem Fall enthält die Fehlerdatei einen Abschnitt Summary und einen weiteren Abschnitt mit allen Fehlern auf Dateiebene.

Der Abschnitt Summary enthält die ValidationErrors und die CopyErrors. In diesem Fall wurden 8 Dateien oder Ordner auf Azure hochgeladen, und es gab keine Validierungsfehler. Beim Kopieren der Daten in das Azure Storage-Konto wurden 5 Dateien oder Ordner erfolgreich hochgeladen. Die übrigen 3 Dateien oder Ordner wurden entsprechend den Benennungskonventionen für Azure-Container umbenannt und dann erfolgreich auf Azure hochgeladen.

Die Status der Dateiebenen sind in BlobStatus enthalten, in dem alle Aktionen beschrieben werden, die zum Hochladen der Blobs ausgeführt wurden. In diesem Fall werden drei Container umbenannt, weil die Ordner, in die die Daten kopiert wurden, den Azure-Benennungskonventionen für Container nicht entsprochen haben. Für die in diesen Containern hochgeladenen Blobs werden der neue Containername, der Pfad des Blobs in Azure, der ursprüngliche ungültige Dateipfad und die Blobgröße einbezogen.

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

Fehler beim Hochladen von Daten

Die in den Protokollen gemeldeten Fehler variieren in den beiden Protokollversionen geringfügig. Wenn Sie nicht sicher sind, über welche Version der Protokolle Sie verfügen, finden Sie weitere Informationen unter Identifizieren der Protokollversion.

Protokollversion: 01.08.2021

Die im Kopierprotokoll 01.10.2018 gefundenen Fehler werden unten beschrieben.

Fehlerkategorie	Beschreibung
UploadErrorWin32	Dateisystem Fehler.
UploadErrorCloudHttp	Nicht unterstützter Blob-Typ. Weitere Informationen zu Fehlern dieser Kategorie finden Sie unter Zusammenfassung von Uploadfehlern.
UploadErrorDataValidationError	Der während der Datenerfassung berechnete CRC-Wert stimmt nicht mit dem während des Uploads berechneten CRC-Wert überein.
UploadErrorManagedConversionError	Die Größe des zu importierenden Blobs ist ungültig. Die Blobgröße beträgt <blob-size> Bytes. Unterstützte Größen liegen zwischen 20971520 Bytes und 8192 GiB. Weitere Informationen finden Sie unter Zusammenfassung von Uploadfehlern.
UploadErrorUnknownType	Unbekannter Fehler.
ContainerRenamed	Der Container wurde umbenannt, da der ursprüngliche Containername nicht den Azure-Namenskonventionen entspricht. Der ursprüngliche Container wurde umbenannt in DataBox-<GUID> von <ursprünglicher Containername>.
ShareRenamed	Die Freigabe wurde umbenannt, weil der ursprüngliche Freigabename nicht den Azure-Namenskonventionen entspricht. Die ursprüngliche Freigabe wurde umbenannt in DataBox-<GUID> von <ursprünglicher Ordnername>.
BlobRenamed	Der Blob wurde umbenannt, da der ursprüngliche Blobname nicht den Azure-Namenskonventionen entspricht. Der ursprüngliche Blob wurde umbenannt in BlockBlob/DataBox-<GUID> von <ursprünglicher Name>.
FileRenamed	Umbenennung der Datei, da der ursprüngliche Dateiname nicht den Azure-Namenskonventionen entspricht. Der ursprüngliche Blob wurde umbenannt in AzureFile/DataBox-<GUID> von <ursprünglicher Name>.
DiskRenamed	Die verwaltete Datenträgerdatei wurde umbenannt, da der ursprüngliche Dateiname nicht den Azure-Namenskonventionen entspricht. Die ursprüngliche verwaltete Datenträgerdatei wurde von <ursprünglichem Namen> in ManagedDisk/DataBox-<GUID> umbenannt.
ExportCloudHttp	Nicht unterstützter Blob-Typ.

Protokollversion: 01.10.2021

Die Fehler, die beim Hochladen von Daten in Azure generiert werden, sind in der folgenden Tabelle zusammengefasst. Dieser Fehlersatz befindet sich im Fehlerprotokoll 01.10.2018.

Fehlercode	Beschreibung
Renamed	Das Blob wurde erfolgreich umbenannt.
CompletedWithErrors	Der Upload wurde mit Fehlern abgeschlossen. Die Details der fehlerhaften Dateien sind in der Protokolldatei enthalten.
Corrupted	Der während der Datenerfassung berechnete CRC-Wert stimmt nicht mit dem während des Uploads berechneten CRC-Wert überein.
StorageRequestFailed	Fehler bei der Azure-Speicheranforderung.
LeasePresent	Dieses Element ist geleast und wird von einem anderen Benutzer verwendet.
StorageRequestForbidden	Konnten aufgrund von Authentifizierungsproblemen nicht hochgeladen werden.
ManagedDiskCreationTerminalFailure	Konnten nicht als verwaltete Datenträger hochgeladen werden. Die Dateien sind im Stagingspeicherkonto als Seitenblobs verfügbar. Sie können Seitenblobs manuell in verwaltete Datenträger konvertieren.
DiskConversionNotStartedTierInfoMissing	Da die VHD-Datei außerhalb der vorab erstellten Ebenenordner kopiert wurde, wurde kein verwalteter Datenträger erstellt. Die Datei wird als Seitenblob in das Stagingspeicherkonto hochgeladen, wie es bei der Auftragserstellung angegeben wurde. Sie kann manuell in einen verwalteten Datenträger konvertiert werden.
InvalidWorkitem	Die Daten konnten nicht hochgeladen werden, da sie nicht den Azure-Konventionen für Benennung und Grenzwerte entsprechen.
InvalidPageBlobUploadAsBlockBlob	Als Blockblobs in einen Container mit dem Präfix databoxdisk-invalid-pb- hochgeladen.
InvalidAzureFileUploadAsBlockBlob	Als Blockblobs in einen Container mit dem Präfix databoxdisk-invalid-af- hochgeladen.
InvalidManagedDiskUploadAsBlockBlob	Als Blockblobs in einen Container mit dem Präfix databoxdisk-invalid-md- hochgeladen.
InvalidManagedDiskUploadAsPageBlob	Als Seitenblobs in einen Container mit dem Präfix databoxdisk-invalid-md- hochgeladen.
MovedToOverflowShare	Die Dateien wurden in eine neue Freigabe hochgeladen, da die Größe der ursprünglichen Freigabe die maximale Azure-Größenbegenzung übersteigt. Der Name der neuen Dateifreigabe entspricht dem ursprünglichen Namen mit dem Suffix -2.
MovedToDefaultAzureShare	Es wurden Dateien hochgeladen, die nicht Teil eines Ordners für eine Standardfreigabe waren. Der Freigabename beginnt mit databox-.
ContainerRenamed	Der Container für diese Dateien hat den Azure-Benennungskonventionen nicht entsprochen und wird umbenannt. Der neue Name beginnt mit databox- und hat den SHA1-Hash des ursprünglichen Namens als Suffix.
ShareRenamed	Die Freigabe für diese Dateien hat den Azure-Benennungskonventionen nicht entsprochen und wird umbenannt. Der neue Name beginnt mit databox- und hat den SHA1-Hash des ursprünglichen Namens als Suffix.
BlobRenamed	Diese Dateien haben den Azure-Benennungskonventionen nicht entsprochen und wurden umbenannt. Den neuen Namen finden Sie im Feld BlobPath.
FileRenamed	Diese Dateien haben den Azure-Benennungskonventionen nicht entsprochen und wurden umbenannt. Den neuen Namen finden Sie im Feld FileStoragePath.
DiskRenamed	Diese Dateien haben den Azure-Benennungskonventionen nicht entsprochen und wurden umbenannt. Den neuen Namen finden Sie im Feld BlobPath.

Nächste Schritte

Wenden Sie sich an den Microsoft-Support.