ログを使用して Azure Data Box Disk のアップロードに関する問題のトラブルシューティングを行う

ディスクの各データ転送では、コピー ログが生成されます。 注文時に詳細ログを保存することを選択した場合は、同じフォルダーに詳細ログもあります。

詳細ログ

詳細ログは、注文時に有効にできるオプションのファイルです。 ドライブから正常にインポートされたすべてのファイルを簡単に一覧表示し、各ファイルに関する次の情報を示します。 詳細ログでは、概要情報は提供されません。

詳細ログのサンプル

次のサンプルの詳述ログは、ブロック BLOB、ページ BLOB、Azure File のインポートに関するサンプルファイルのエントリを含んでいます。

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

ログのコピー

コピー ログには、インポートに失敗した各ファイルのエラー エントリとエラーの詳細が含まれます。 コピー ログは、インポート中に発生した検証エラーとコピー エラーの概要で終わります。

各エラー エントリには、次の情報が含まれています。

ログの末尾にある概要 ( CopyLog Summaryを探す) には、次の情報が表示されます。

• ドライブ ログのバージョン (この場合は 2021-08-01)
• ドライブ ID
• データ コピーの状態
• エラー カテゴリ別の検証エラーの概要
• エラー カテゴリ別のコピー エラーの概要

コピー ログのサンプル

次の例は、Azure Files と Azure Blob Storage の両方にインポートするためのコピー ログです。

このコピーは失敗し、検証エラーはありませんが、3 つのコピー エラーが発生しました。 1 つのファイル共有の名前が変更され (ShareRenamed エラー)、2 つのコンテナーの名前が変更されました (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 では、データアップロードによってエラー ログと詳細ログが生成されます。 どちらのログも同じ形式であり、ディスクから Azure Storage アカウントにデータをコピーするときに発生したイベントの 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が含まれます。 この場合、8 つのファイルまたはフォルダーが Azure にアップロードされ、検証エラーはありませんでした。 データが Azure Storage アカウントにコピーされると、5 つのファイルまたはフォルダーが正常にアップロードされました。 残りの 3 つのファイルまたはフォルダーは、Azure コンテナーの名前付け規則に従って名前が変更され、Azure に正常にアップロードされました。

ファイル レベルの状態は BlobStatusであり、BLOB をアップロードするために実行されたアクションについて説明します。 この場合、データのコピー先フォルダーがコンテナーの Azure 名前付け規則に準拠していないため、3 つのコンテナーの名前が変更されます。 これらのコンテナーにアップロードされた 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>

この表では、2018-10-01 コピー ログで見つかったエラーについて説明します。

データを Azure にアップロードするときに生成されるエラーを次の表にまとめます。 このエラー セットは、2018-10-01 エラー ログにあります。