使用記錄來針對 Azure Data Box Disk 中的上傳問題進行疑難排解

本文說明您在使用 Azure Data Box Disk 在 Azure 資料中心上傳資料時看到的問題。

關於上傳記錄

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

• 複製記錄會報告磁碟與 Azure 儲存體帳戶之間所有失敗複製作業的事件。 複製記錄檔會以依錯誤類別的錯誤摘要結尾。

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

找出日誌

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

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

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

   • 對於新訂單，磁碟詳細資料如下所示。 副本日誌會自動保存。 如果您在下訂單時選擇儲存詳細記錄檔，您也能看到詳細記錄檔的路徑。

     具有 [複製完成但警告] 狀態的 [Data Box 磁碟訂單] 的 [總覽] 窗格螢幕擷取畫面。複製日誌路徑和詳細日誌路徑被突出顯示。

     記錄檔會上傳至容器 (Blob 匯入)，或在儲存體帳戶中共用 (匯入至 Azure 檔案儲存體)。 容器名為 databoxcopylog。 URL 具有下列格式：

     日誌類型	網址格式
     複製日誌	< 儲存體帳戶名稱>/databoxcopylog/<order-name>_<device-serial-number>_CopyLog_<job-ID>.xml
     詳細資訊記錄檔	< 儲存體帳戶名稱>/databoxcopylog/<order-name>_<device-serial-number>_VerboseLog_<job-ID>.xml

   • 對於您之前的訂單，螢幕顯示可能會是以下圖示。

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

     

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

     日誌類型	網址格式
     錯誤記錄檔	< 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 記錄。

   

4. 選取每個記錄檔，然後下載本機副本。

識別記錄檔版本

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

除了詳細日誌之外，您還會看到複製日誌（_copy.xml）或錯誤日誌（_error.xml），具體取決於磁碟機釋出版本。

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

記錄檔名稱	領域	驅動器日誌版本
_copy.xml	DriveLog-版本	2021-08-01
_error.xml	DriveLog 版本	2018-10-01

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

範例上傳記錄

複製日誌/錯誤日誌和詳細日誌的格式在兩個版本的日誌中有所不同。 如果您不確定您擁有的記錄版本，請參閱 識別記錄版本。

日誌版本：2021-08-01

磁碟的每次資料傳輸都會產生複製記錄。 如果您在下訂單時選擇儲存詳細記錄，則同一資料夾中也會有一個詳細記錄。

詳細資訊記錄檔

詳細資訊記錄檔是您可以在訂購期間啟用的選用檔案。 這是從磁碟機成功匯入的所有檔案的簡單清單，每個檔案都有下列資訊。 詳細記錄不提供摘要資訊。

領域	Description
雲端格式	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>

複製日誌

複製日誌包含每一個匯入失敗的檔案的錯誤項目，以及錯誤詳細資料。 複製記錄會以匯入期間發生的驗證和複製錯誤摘要結束。

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

領域	Description
路徑	容器或檔案共用的目的地共用設定。
類別	15 個錯誤類別之一。 如需詳細資訊，請參閱日誌版本 2021-08-01 的資料上傳錯誤。
ErrorCode	錯誤的數字碼。
錯誤訊息	描述錯誤。

記錄檔結尾的摘要 (請尋找 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

磁碟機記錄檔 2018-10-01 版中，資料上傳產生一個錯誤記錄檔和一個詳細資訊記錄檔。 這兩個記錄的格式相同，並包含將資料從磁碟複製到 Azure 儲存體帳戶時所發生事件的 XML 描述。

詳細資訊記錄檔包含每個 Blob 或檔案的複製作業狀態完整資訊，錯誤記錄檔則只包含上傳期間發生錯誤的 Blob 或檔案的資訊。

錯誤記錄的結構與詳細記錄相同，但會篩選出成功的作業。

詳細資訊記錄檔範例

此處顯示了一個 _verbose.xml 的範例。 在此情況下，訂單已順利完成，沒有錯誤。

<?xml version="1.0" encoding="utf-8"?>
<DriveLog Version="2018-10-01">
  <DriveId>184020D95632</DriveId>
  <Blob Status="Completed">
    <BlobPath>$root/botetapageblob.vhd</BlobPath>
    <FilePath>\PageBlob\botetapageblob.vhd</FilePath>
    <Length>1073742336</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <PageRangeList>
      <PageRange Offset="0" Length="4194304" Status="Completed" />
      <PageRange Offset="4194304" Length="4194304" Status="Completed" />
      <PageRange Offset="8388608" Length="4194304" Status="Completed" />
      --------CUT-------------------------------------------------------
      <PageRange Offset="1061158912" Length="4194304" Status="Completed" />
      <PageRange Offset="1065353216" Length="4194304" Status="Completed" />
      <PageRange Offset="1069547520" Length="4194304" Status="Completed" />
      <PageRange Offset="1073741824" Length="512" Status="Completed" />
    </PageRangeList>
  </Blob>
  <Blob Status="Completed">
    <BlobPath>$root/botetablockblob.txt</BlobPath>
    <FilePath>\BlockBlob\botetablockblob.txt</FilePath>
    <Length>19</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <BlockList>
      <Block Offset="0" Length="19" Status="Completed" />
    </BlockList>
  </Blob>
  <File Status="Completed">
    <FileStoragePath>botetaazurefilesfolder/botetaazurefiles.txt</FileStoragePath>
    <FilePath>\AzureFile\botetaazurefilesfolder\botetaazurefiles.txt</FilePath>
    <Length>20</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <FileRangeList>
      <FileRange Offset="0" Length="20" Status="Completed" />
    </FileRangeList>
  </File>
  <Status>Completed</Status>
</DriveLog>

範例錯誤記錄

相同訂單的 _error.xml 範例顯示在這裡。

<?xml version="1.0" encoding="utf-8"?>
<DriveLog Version="2018-10-01">
  <DriveId>184020D95632</DriveId>
  <Summary>
    <ValidationErrors>
      <None Count="3" />
    </ValidationErrors>
    <CopyErrors>
      <None Count="3" Description="No errors encountered" />
    </CopyErrors>
  </Summary>
  <Status>Completed</Status>
</DriveLog>

_error.xml 的範例顯示在這裡，顯示訂單已在發生錯誤的情況下完成。

在此情況下，錯誤檔案有一個 Summary 區段，以及另一個包含所有檔案層級錯誤的區段。

Summary 包含 ValidationErrors 和 CopyErrors。 在此情況下，已將八個檔案或資料夾上傳至 Azure，而且沒有驗證錯誤。 將資料複製到 Azure 儲存體帳戶時，已成功上傳五個檔案或資料夾。 其餘三個檔案或資料夾已根據 Azure 容器命名慣例重新命名，然後成功上傳至 Azure。

檔案層級狀態位於 BlobStatus中，說明上傳 Blob 所採取的任何動作。 在此情況下，會重新命名三個容器，因為資料複製到的資料夾不符合容器的 Azure 命名慣例。 對於這些容器中上傳的 Blob，會包含新的容器名稱、Azure 中 Blob 的路徑、原始無效的檔案路徑，以及 Blob 大小。

 <?xml version="1.0" encoding="utf-8"?>
  <DriveLog Version="2018-10-01">
    <DriveId>18041C582D7E</DriveId>
    <Summary>
      <ValidationErrors>
        <None Count="8" />
      </ValidationErrors>
      <CopyErrors>
        <Completed Count="5" Description="No errors encountered" />
        <ContainerRenamed Count="3" Description="Renamed the container as the original container name does not follow Azure conventions." />
      </CopyErrors>
    </Summary>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/private.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\private.vhd</OriginalFilePath>
      <SizeInBytes>10490880</SizeInBytes>
    </Blob>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/resource.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\resource.vhd</OriginalFilePath>
      <SizeInBytes>71528448</SizeInBytes>
    </Blob>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/role.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\role.vhd</OriginalFilePath>
      <SizeInBytes>10490880</SizeInBytes>
    </Blob>
    <Status>CompletedWithErrors</Status>
  </DriveLog>

資料上傳錯誤

記錄中報告的錯誤在兩個記錄版本中略有不同。 如果您不確定您擁有的記錄版本，請參閱 識別記錄版本。

日誌版本：2021-08-01

此表格說明在 2018-10-01 複製記錄中發現的錯誤。

錯誤類別	Description
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 命名慣例。 原始受控磁碟檔案已從<原始名稱>重新命名為<。
ExportCloudHttp	不支援的 Blob 類型。

記錄版本：2018-10-01

下表摘要說明將資料上傳至 Azure 時產生的錯誤。 此錯誤集可在 2018-10-01 錯誤記錄檔中找到。

錯誤碼	Description
Renamed	Blob 已重新命名成功。
CompletedWithErrors	上傳完成，但有錯誤。 錯誤檔案的詳細資料會包含在記錄檔中。
Corrupted	資料擷取期間計算的 CRC 與上傳期間計算的 CRC 不符。
StorageRequestFailed	Azure 儲存體要求失敗。
LeasePresent	此項目已租賃，並由其他使用者使用。
StorageRequestForbidden	由於身份驗證問題，無法上傳。
ManagedDiskCreationTerminalFailure	無法上傳為受控磁碟。 這些檔案以頁面 Blob 格式存在於暫存儲存帳戶中。 您可以手動將分頁 Blob 轉換成受控磁碟。
DiskConversionNotStartedTierInfoMissing	由於 VHD 檔案是在預先建立的層資料夾外部複製，因此不會建立受控磁碟。 檔案會以頁面 Blob 的形式上傳至訂單建立期間指定的預備儲存體帳戶。 您可以手動將它轉換為受控磁碟。
InvalidWorkitem	無法上傳資料，因為它不符合 Azure 命名和限制慣例。
InvalidPageBlobUploadAsBlockBlob	在容器中以區塊 Blob 的形式上傳，並加上前置詞 databoxdisk-invalid-pb-。
InvalidAzureFileUploadAsBlockBlob	在容器中以區塊 Blob 的形式上傳，並加上前置詞 databoxdisk-invalid-af-。
InvalidManagedDiskUploadAsBlockBlob	在容器中以區塊 Blob 的形式上傳，並加上前置詞 databoxdisk-invalid-md-。
InvalidManagedDiskUploadAsPageBlob	在容器中以分頁 Blob 的形式上傳，並加上前置詞 databoxdisk-invalid-md-。
MovedToOverflowShare	將檔案上傳至新共用，因為原始共用大小超過了 Azure 大小限制上限。 新的檔案共用名稱是以-2為後綴附加於原始名稱之後。
MovedToDefaultAzureShare	將不屬於任何資料夾的檔案上傳至預設共用。 共用名稱以databox-開頭。
ContainerRenamed	這些檔案的容器不符合 Azure 命名慣例，並已重新命名。 新名稱以 databox- 開頭，並以原始名稱的 SHA1 雜湊值為後綴。
ShareRenamed	這些檔案的共用不符合 Azure 命名慣例，並已重新命名。 新名稱以 databox- 開頭，並以原始名稱的 SHA1 雜湊值作為後綴。
BlobRenamed	這些檔案不符合 Azure 命名慣例，並已重新命名。 若要知道新名稱，請查看 BlobPath 欄位。
FileRenamed	這些檔案不符合 Azure 命名慣例，並已重新命名。 若要知道新名稱，請查看 FileStoragePath 欄位。
DiskRenamed	這些檔案不符合 Azure 命名慣例，並已重新命名。 若要知道新名稱，請查看 BlobPath 欄位。

後續步驟

連絡 Microsoft 支援服務。