使用記錄檔來針對透過「Azure 匯入/匯出」執行的匯入和匯出進行疑難排解
當 Microsoft Azure 匯入/匯出服務處理匯入或匯出作業的磁碟時,該服務會將複製記錄檔和詳細資訊記錄檔寫入您所使用的儲存體帳戶。 這兩個記錄都會針對每一個磁碟來加以儲存。
複製記錄檔主要記載磁碟和 Azure 儲存體帳戶之間所有複製失敗作業的事件。 複製記錄檔的結尾會附上依錯誤類別整理而成的錯誤摘要。
詳細資訊記錄檔會列出每個 Blob 和檔案上執行成功的所有複製作業。
尋找記錄檔
當您使用匯入/匯出服務在 Azure 資料箱中建立匯入或匯出作業時,您將檢視匯入/匯出作業以及其他資料箱資源。
使用下列步驟來找出匯入/匯出作業的資料複製狀態:
登入 Azure 入口網站。
搜尋 Azure 資料箱。
若要篩選出 Azure 匯入/匯出作業,請在搜尋方塊中輸入 "Import/Export"。
匯入/匯出作業清單會出現在頁面上。
選取作業名稱以檢視作業詳細數據。
選取的作業目前 訂單狀態 和 數據複製詳細 數據會顯示每個磁碟驅動器。
如果您有儲存體帳戶的存取權,您可以選取 [複製記錄檔路徑] 或 [詳細資訊記錄檔路徑] 來檢視記錄檔。
選取 [磁機 ID] 以開啟具有完整複製資訊的面板,包括資訊清單檔和雜湊。
複製記錄檔會自動儲存。 如果您在訂購時選擇儲存詳細資訊記錄檔,也會看到詳細資訊記錄檔的路徑。
記錄檔會上傳至容器 (針對 Blob 匯入和匯出作業),或在儲存體帳戶中共用 (針對匯入至 Azure 檔案儲存體的作業)。 容器名為 databoxcopylog
。 URL 具備以下格式:
記錄類型 | URL 格式 |
---|---|
複製記錄檔 | <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_CopyLog_<job-ID>.xml |
詳細資訊記錄檔 | <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_VerboseLog_<job-ID>.xml |
對於匯出作業,資訊清單檔案也會儲存至磁碟。
每次傳輸磁碟資料都會產生複製記錄檔。 如果您在建立訂單時選擇儲存詳細資訊記錄檔,相同資料夾中也會有詳細資訊記錄檔。
注意
對於先前的訂單,您可能會在儲存體帳戶的 waies
容器中找到錯誤記錄檔 (_error.xml) 以及詳細資訊記錄檔。 DriveLog Version
(顯示在錯誤記錄檔摘要中) 會是 2018-10-01
。 記錄檔的格式與本文中所述的格式不同。
檢閱匯入記錄檔
在匯入期間,匯入/匯出服務會針對每一個磁碟產生詳細資訊記錄檔和複製記錄檔。
詳細資訊記錄
詳細資訊記錄檔是您可以在訂購期間啟用的選用檔案。 這是一個從磁碟中順利匯入的所有檔案的簡單列表。 詳細資訊記錄檔會為每一個檔案提供下列資訊。 詳細資訊記錄檔不會提供摘要資訊。
欄位 | 描述 |
---|---|
CloudFormat | BlockBlob、PageBlob 或 AzureFile。 |
路徑 | 儲存體帳戶內檔案的路徑。 |
大小 | 檔案或 Blob 大小。 |
crc64 | 在資料傳輸期間驗證資料完整性所使用的循環備援檢查 64 (CRC64) 總和檢查碼。 |
詳細資訊記錄檔範例:匯入
以下詳細資訊記錄檔範例具有區塊 Blob、分頁 Blob 和 Azure 檔案匯入的檔案項目範本。
<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>
複製記錄檔
複製記錄檔包含無法匯入或匯出的每一個檔案的錯誤項目,以及錯誤詳細資料。 複製記錄檔的結尾會是資料傳輸期間發生驗證和複製錯誤的摘要。
每個錯誤項目都包含以下資訊。
欄位 | 描述 |
---|---|
路徑 | 容器或檔案共用的目的地共用設定。 |
類別 | 錯誤類別。 如需詳細資訊,請參閱資料傳輸錯誤。 |
ErrorCode | 錯誤的數字碼。 |
ErrorMessage | 說明發生的錯誤。 |
記錄檔結尾的摘要 (請尋找 CopyLog Summary
) 會提供以下資訊:
- 磁碟記錄檔版本 (這個案例中是
2021-08-01
) - 磁碟機識別碼
- 資料複製狀態
- 依錯誤類別呈現的驗證錯誤摘要
- 依錯誤類別呈現的複製錯誤摘要
複製記錄檔範例:匯入
以下範例是將資料匯入至 Azure 檔案儲存體和 Azure Blob 儲存體的複製記錄檔。
複製失敗,雖然沒有驗證錯誤,但發生三項複製錯誤。 有一個檔案共用重新命名 (ShareRenamed
錯誤),以及兩個容器重新命名 (ContainerRenamed
錯誤)。 錯誤項目會提供原始和新的檔案名稱。
<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>
檢閱匯出記錄檔
在匯出期間,匯入/匯出服務會針對每一個從 Azure 儲存體到磁碟的資料傳輸作業,產生詳細資訊記錄檔和複製記錄檔。 另外還有一個資訊清單檔,其會儲存至磁碟中。
詳細資訊記錄
匯出的詳細資訊記錄檔是一個順利從 Azure 儲存體帳戶匯出到磁碟的所有檔案的簡單列表。 詳細資訊記錄檔會為每一個檔案提供下列資訊。 詳細資訊記錄檔不會提供摘要資訊。
欄位 | 描述 |
---|---|
CloudFormat | BlockBlob、PageBlob 或 AzureFile。 |
Etag | 資源的實體標記 (ETag) ,用於在資料傳輸期間的並行檢查。 |
路徑 | 儲存體帳戶內檔案的路徑。 |
大小 | 檔案或 Blob 大小。 |
crc64 | 在將資料匯出到磁碟時所計算的循環冗餘檢查 64 (CRC64) 總和檢查碼。 |
詳細資訊記錄檔範例:匯入
在下列的詳細資訊記錄檔範例中,匯出作業已順利從 Azure Blob 儲存體中傳輸三個 Blob。
<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>
複製記錄檔
匯出的複製記錄檔包含無法順利從 Azure 儲存體傳輸到磁碟的每一個檔案的錯誤項目,以及錯誤詳細資料。 複製記錄檔的結尾會是資料傳輸期間發生驗證和複製錯誤的摘要。
匯出的複製記錄檔會報告像是因為磁碟損毀或資料傳輸期間變更的儲存體帳戶金鑰而失敗之類的問題。 如需問題清單,請參閱資料傳輸錯誤。
複製記錄檔範例:匯出
下列範例是匯出的複製記錄檔,該匯出遇到三個檔案系統錯誤 ( UploadErrorWin32
),它導致了三個檔案的匯出失敗。 錯誤 267 表示目錄名稱無效。 錯誤 123 表示不正確的檔案名、目錄名稱或磁區標籤語法。
<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>
資料傳輸錯誤
您可以在匯入作業和/或匯出作業的複製記錄檔中找到下列錯誤。
錯誤類別 | 錯誤訊息 | 匯入 | 匯出 |
---|---|---|---|
UploadErrorWin32 |
檔案系統錯誤。 | Yes | Yes |
UploadErrorCloudHttp |
不支援的 Blob 類型。 如需此類別中錯誤的詳細資訊,請參閱上傳錯誤摘要。 | Yes | Yes |
UploadErrorDataValidationError |
資料擷取期間計算的 CRC 與上傳期間計算的 CRC 不符。 | Yes | Yes |
UploadErrorManagedConversionError |
正在匯入的 Blob 大小無效。 Blob 大小為 <blob-size> 個位元組。 支援的大小介於 20971520 個位元組到 8192 GiB 之間。 如需詳細資訊,請參閱上傳錯誤摘要。 | Yes | Yes |
UploadErrorUnknownType |
未知的誤差。 | Yes | Yes |
ContainerRenamed |
容器已重新命名,因為原本的容器名稱未遵循 Azure 命名慣例。 原始容器已從 <原始容器名稱> 重新命名為 DataBox-<GUID>。 | No | Yes |
ShareRenamed |
共用已重新命名,因為原本的共用名稱未遵循 Azure 命名慣例。 原始共用已從 <原始資料夾名稱> 重新命名為 DataBox-<GUID>。 | No | Yes |
BlobRenamed |
Blob 已重新命名,因為原本的 Blob 名稱未遵循 Azure 命名慣例。 原始 Blob 已從 <原始名稱> 重新命名為 BlockBlob/DataBox-<GUID>。 | No | Yes |
FileRenamed |
檔案已重新命名,因為原本的檔案名稱未遵循 Azure 命名慣例。 原始檔案已從 <原始名稱> 重新命名為 AzureFile/DataBox-<GUID>。 | No | Yes |
DiskRenamed |
受控的磁碟檔案已重新命名,因為原始的檔案名稱未遵循受控磁碟的 Azure 命名慣例。 原始受控磁碟檔案已從 <原始名稱> 重新命名為 ManagedDisk/DataBox-<GUID>。 | No | Yes |
FileNameTrailsWithSlash |
Blob 名稱或檔名以結尾斜線做結尾。 結尾為結尾反斜線或正斜線的 Blob 名稱或檔名,無法匯出至磁碟中。 | No | Yes |
ExportCloudHttp |
不支援的 Blob 類型。 | No | Yes |