共用方式為

使用記錄檔疑難排解 Azure 資料箱磁碟的上傳問題

  • 發行項

本文說明您使用 Azure 資料箱磁碟在 Azure 資料中心上傳資料時所遇到的問題。

關於上傳記錄檔

在 Azure 資料中心上傳資料箱磁碟的資料時，系統會為每個儲存體帳戶產生複製/錯誤記錄檔和詳細資訊記錄檔。 這些記錄檔會上傳至您上傳資料所用的同一個儲存體帳戶。

  • 複製記錄檔主要記載磁碟和 Azure 儲存體帳戶之間所有複製失敗作業的事件。 複製記錄檔的結尾會附上依錯誤類別整理而成的錯誤摘要。

  • 詳細資訊記錄檔會列出每個 Blob 和檔案上執行成功的所有複製作業。

尋找記錄檔

若要尋找資料上傳記錄，請執行以下步驟。

  1. 在 Azure 入口網站開啟您的訂單。

  2. 各磁碟的資料上傳完成時，[概觀] 窗格會顯示磁碟的狀態和磁碟診斷記錄檔的路徑。

    • 如果是新訂單，磁碟的詳細資訊會如以下畫面所示。 複製記錄檔會自動儲存。 如果您在訂購時選擇儲存詳細資訊記錄檔，也會看到詳細資訊記錄檔的路徑。

      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.

      記錄檔會上傳至容器 (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

    • 先前訂單的顯示畫面如下所示。

      如果資料上傳至 Azure 時發生任何錯誤，複製記錄檔會顯示診斷記錄檔所在資料夾的路徑。

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

      記錄檔會上傳至儲存體帳戶中的 waies 容器。 URL 具備以下格式：

      記錄類型 URL 格式
      錯誤記錄檔 (error log) <storage-account-name>/databoxlogs-<order-name>/waies/ri-<order-name>-guid_<drive-ID>_<timestamp>_error.xml
      詳細資訊記錄檔 <storage-account-name>/databoxlogs-<order-name>/waies/ri-<order-name>-guid_<drive-ID>_<timestamp>_verbose.xml

    注意

    databoxcopylog 容器中的記錄檔與 waies 容器中的記錄檔使用不同格式。 如需解譯記錄檔的相關說明，請使用相關聯磁碟機記錄檔版本的相關指示。 如需詳細資訊，請參閱識別記錄檔版本。

  3. 若要檢視記錄檔，請開啟將記錄檔儲存於儲存體帳戶中的容器。 下圖顯示容器中的 waies 記錄檔。

    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. 選取各個記錄檔，並下載本機複本。

識別記錄檔版本

複製/錯誤記錄檔和詳細資訊記錄檔有兩個版本，格式不同。 以下各節會個別討論記錄檔版本。

除了詳細資訊記錄檔之外，您也會看到複製記錄檔 (_copy.xml) 或錯誤記錄檔 (_error.xml)，視磁碟機版本而定。

若要瞭解複製/錯誤記錄檔和隨附詳細資訊記錄檔的記錄檔版本，請查看複製/錯誤記錄檔中的磁碟機記錄檔版本。

記錄檔名稱 欄位 磁碟機記錄檔版本
_copy.xml DriveLogVersion 2021-08-01
_error.xml DriveLog Version 2018-10-01

下圖顯示複製記錄檔摘要區段中的 DriveLogVersion。

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

上傳記錄檔範例

兩個記錄檔版本的複製/錯誤記錄檔和詳細資訊記錄檔使用不同格式。 如果您不確定您的記錄檔是什麼版本，請參閱識別記錄檔版本。

每次傳輸磁碟資料都會產生複製記錄檔。 如果您在訂購時選擇儲存詳細資訊記錄檔，相同資料夾中也會有詳細資訊記錄檔。

詳細資訊記錄

詳細資訊記錄檔並非強制產生的檔案，您可以在訂購時自行啟用。 這個記錄檔是一份簡單的清單，記載從磁碟機成功匯入的所有檔案，其中包含每個檔案的以下資訊。 詳細資訊記錄檔不會提供摘要資訊。

欄位 描述
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>

複製記錄檔

複製記錄檔針對每個匯入失敗的檔案記載錯誤項目，並附有錯誤詳細資訊。 複製記錄檔的結尾會是匯入期間執行驗證作業和發生複製錯誤的摘要。

每個錯誤項目都包含以下資訊。

欄位 描述
路徑 容器或檔案共用的目的地共用設定。
類別 15 種錯誤類別的其中一個。 如需詳細資訊，請參閱記錄檔 2021-08-01 版的資料上傳錯誤。
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>

檔案上傳錯誤

在兩個記錄檔版本中，記錄檔所記載的錯誤會稍微不同。 如果您不確定您的記錄檔是什麼版本，請參閱識別記錄檔版本。

2018-10-01 版複製記錄檔中的錯誤如下所述。

錯誤類別 描述
UploadErrorWin32 檔案系統錯誤。
UploadErrorCloudHttp 不支援的 Blob 類型。 如需此類別中錯誤的詳細資訊，請參閱上傳錯誤摘要。
UploadErrorDataValidationError 資料擷取期間計算的 CRC 與上傳期間計算的 CRC 不符。
UploadErrorManagedConversionError 正在匯入的 Blob 大小無效。 Blob 大小為 <blob-size> 個位元組。 支援的大小介於 20971520 個位元組到 8192 GiB 之間。 如需詳細資訊，請參閱上傳錯誤摘要。
UploadErrorUnknownType 未知的誤差。
ContainerRenamed 容器已重新命名，因為原本的容器名稱未遵循 Azure 命名慣例。 原始容器已從 <原始容器名稱> 重新命名為 DataBox-<GUID>。
ShareRenamed 共用已重新命名，因為原本的共用名稱未遵循 Azure 命名慣例。 原始共用已從 <原始資料夾名稱> 重新命名為 DataBox-<GUID>。
BlobRenamed Blob 已重新命名，因為原本的 Blob 名稱未遵循 Azure 命名慣例。 原始 Blob 已從 <原始名稱> 重新命名為 BlockBlob/DataBox-<GUID>。
FileRenamed 檔案已重新命名，因為原本的檔案名稱未遵循 Azure 命名慣例。 原始 Blob 已從 <原始名稱> 重新命名為 AzureFile/DataBox-<GUID>。
DiskRenamed 受控的磁碟檔案已重新命名，因為原本的檔案名稱未遵循 Azure 命名慣例。 原始受控磁碟檔案已從 <原始名稱> 重新命名為 ManagedDisk/DataBox-<GUID>。
ExportCloudHttp 不支援此 Blob 類型。

下一步

連絡 Microsoft 支援服務。