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.
Öffnen Sie Ihres Auftrags im Azure-Portal
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.Ö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.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.
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. |