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.

      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.

      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.

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

      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.

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

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

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.

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>

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.

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.

Nächste Schritte

Wenden Sie sich an den Microsoft-Support.