Freigeben über

Verwendung von Protokollen zur Fehlerbehebung bei Importen und Exporten über Azure Import/Export

  • Artikel

Wenn der Microsoft Azure Import/Export Dienst die Laufwerke für einen Import- oder Exportauftrag verarbeitet, schreibt der Dienst Kopierprotokolle und ausführliche Protokolle in das von Ihnen verwendete Speicherkonto. Beide Protokolle werden für jedes Laufwerk gespeichert.

  • 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

Wenn Sie den Import-/Exportdienst verwenden, um einen Import- oder Exportauftrag in Azure Data Box zu erstellen, sehen Sie den Importieren/Exportieren auftrag zusammen mit Ihren anderen Data Box Ressourcen.

Gehen Sie wie folgt vor, um den Status der Datenkopien für einen Importieren/Exportieren auftrag zu ermitteln:

  1. Melden Sie sich beim Azure-Portal an.

  2. Suchen Sie nach Azure Data Box.

    Screenshot, der zeigt, wie im Azure-Portal nach Data Box-Aufträgen gesucht wird. Das Suchfeld und der ausgewählte Azure Data Box-Dienst sind hervorgehoben.

  3. Um nach Azure Import-/Export-Aufträgen zu filtern, geben Sie „Import/Export“ in das Suchfeld ein.

    Screenshot, der zeigt, wie Data Box-Ressourcen im Azure-Portal gefiltert werden können, um Import-/Exportaufträge anzuzeigen. Das Suchfeld ist hervorgehoben.

    Eine Liste Ihrer Import-/Exportaufträge wird auf der Seite angezeigt.

    Screenshot der Data Box-Ressourcen im Azure-Portal, gefiltert nach Import-Export-Aufträgen. Der Auftragsname, der Übertragungstyp, der Status und das Modell sind hervorgehoben.

  4. Zeigen Sie Auftragsdetails an, indem Sie einen Auftragsnamen auswählen.

    Für jedes Laufwerk werden der aktuelle Auftragsstatus und die Datenkopiedetails des ausgewählten Auftrags angezeigt.

    • Wenn Sie Zugriff auf das Speicherkonto haben, können Sie einen Kopierprotokollpfad oder einen ausführlichen Protokollpfad auswählen, um das Protokoll anzuzeigen.

    • Wählen Sie eine Laufwerk-ID aus, um einen Bereich mit vollständigen Kopierinformationen zu öffnen, einschließlich der Manifestdatei und des Hashs.

    Screenshot der Übersicht für einen Import-Export-Auftrag im Azure-Portal. Der Auftragsstatus sowie der Datenkopierstatus und die Protokoll-URLs für ein Laufwerk sind hervorgehoben.

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 und -Exporte) 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

Bei Exportieren aufträgen wird auch eine Manifest datei auf der Festplatte gespeichert.

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.

Hinweis

Für Ihre früheren Aufträge finden Sie möglicherweise ein Fehlerprotokoll (_error.xml) zusammen mit dem ausführlichen Protokoll in einem waies-Container im Speicherkonto. Die DriveLog Version, die in der Zusammenfassung des Fehlerprotokolls angezeigt wird, wird zu 2018-10-01. Die Protokollformate unterscheiden sich von den in diesem Artikel beschriebenen.

Importieren log überprüfen

Während eines Imports erstellt der Importieren/Exportieren Dienst ein ausführliches log und ein Kopier log für jeden Datenträger.

Ausführliches Protokoll

Das ausführliche log ist eine optionale Datei, die Sie bei der Bestellung aktivieren können. Es handelt sich um eine einfache Auflistung aller Dateien, die erfolgreich von dem Laufwerk importiert wurden. Das ausführliche log enthält die 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 log: importieren

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 Kopier log enthält für jede Datei, die nicht importieren oder exportieren werden konnte, einen Fehlereintrag mit Fehlerdetails. Das Kopier log endet mit einer Zusammenfassung der Validierungs- und Kopierfehler, die während der Datenübertragung aufgetreten sind.

Jeder Fehlereintrag enthält die folgenden Informationen.

Feld Beschreibung
Pfad Die Zielfreigabe innerhalb des Containers oder der Dateifreigabe.
Kategorie Identifiziert die Fehlerkategorie. Für weitere Informationen siehe Datenübertragungsfehler.
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:

  • Log buch version (in diesem Fall 2021-08-01)
  • Laufwerk-ID
  • Status der Datenkopie
  • Zusammenfassung der Validierungsfehler nach Fehlerkategorie
  • Zusammenfassung der Kopierfehler nach Fehlerkategorie

Beispiel für ein Kopier log: Importieren

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>

Exportieren log überprüfen

Während eines Exportieren erzeugt der Importieren/Exportieren Dienst ein ausführliches log und ein Kopier log für jede Datenübertragung von Azure Storage auf einen Datenträger. Außerdem gibt es eine Manifestdatei, die auf der Festplatte gespeichert wird.

Ausführliches Protokoll

Das ausführliche log für einen Exportieren ist eine einfache Auflistung aller Dateien, die erfolgreich aus dem Azure-Speicherkonto auf das Laufwerk exportieren wurden. Das ausführliche log enthält die folgenden Informationen für jede Datei. Das ausführliche Protokoll liefert keine zusammenfassenden Informationen.

Feld Beschreibung
CloudFormat BlockBlob, PageBlob oder AzureFile.
ETag Das Entity-Tag (ETag) für die Ressource, das für die Gleichzeitigkeitsprüfung während der Datenübertragung verwendet wird.
Pfad Pfad zur Datei innerhalb des Speicherkontos.
Size Datei- oder Blobgröße.
crc64 Die CRC64-Prüfsumme (Cyclic Redundancy Check 64), die beim Exportieren von Daten auf die Festplatte berechnet wurde.

Beispiel eines ausführlichen log: exportieren

Im folgenden ausführlichen Beispiel log überträgt der Exportieren auftrag erfolgreich drei Blobs aus 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>

Kopierprotokoll

Das Kopier log für einen Exportieren enthält einen Fehlereintrag für jede Datei, die nicht erfolgreich von Azure Storage auf den Datenträger übertragen werden konnte, mit Fehlerdetails. Das Kopier log endet mit einer Zusammenfassung der Validierungs- und Kopierfehler, die während der Datenübertragung aufgetreten sind.

Das Kopier log für einen Exportieren meldet Probleme wie eine Datenübertragung, die aufgrund eines beschädigten Laufwerks fehlgeschlagen ist, oder einen während der Datenübertragung geänderten Speicherkontoschlüssel. Eine Liste der Probleme finden Sie unter Datenübertragungsfehler.

Beispiel für ein Kopier log: Exportieren

Das folgende Beispiel ist ein Kopier log für einen Exportieren, bei dem drei Dateisystemfehler ( UploadErrorWin32) auftraten, die den Exportieren von drei Dateien zum Scheitern brachten. Der Fehler 267 zeigt an, dass der Verzeichnisname ungültig ist. Der Fehler 123 weist auf eine falsche Syntax des Dateinamens, des Verzeichnisnamens oder der Datenträgerbezeichnung hin.

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

Fehler bei der Datenübertragung

In den Kopierprotokollen von Import- und/oder Exportaufträgen finden Sie die folgenden Fehler.

Fehlerkategorie Fehlermeldung Importe Exporte
UploadErrorWin32 Dateisystem Fehler. Ja Ja
UploadErrorCloudHttp Nicht unterstützter Blob-Typ. Weitere Informationen zu Fehlern dieser Kategorie finden Sie unter Zusammenfassung von Uploadfehlern. Ja Ja
UploadErrorDataValidationError Der während der Datenerfassung berechnete CRC-Wert stimmt nicht mit dem während des Uploads berechneten CRC-Wert überein. Ja Ja
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. Ja Ja
UploadErrorUnknownType Unbekannter Fehler. Ja Ja
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>. No Ja
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>. No Ja
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>. No Ja
FileRenamed Umbenennung der Datei, da der ursprüngliche Dateiname nicht den Azure-Namenskonventionen entspricht. Die ursprüngliche Datei wurde umbenannt in AzureFile/DataBox-<GUID> von <ursprünglicher Name>. No Ja
DiskRenamed Die verwaltete Datenträgerdatei wurde umbenannt, da der ursprüngliche Dateiname nicht den Azure-Namenskonventionen für verwaltete Datenträger entspricht. Die ursprüngliche verwaltete Datenträgerdatei wurde von <ursprünglichem Namen> in ManagedDisk/DataBox-<GUID> umbenannt. No Ja
FileNameTrailsWithSlash Blob- oder Dateiname endet mit einem Schrägstrich am Ende. Ein Blob- oder Dateiname, der mit einem nachgestellten Backslash oder Schrägstrich endet, kann nicht auf die Festplatte exportiert werden. No Ja
ExportCloudHttp Nicht unterstützter Blob-Typ. No Ja

Nächste Schritte