ログを使用して Azure Import/Export でインポートとエクスポートのトラブルシューティングを行う
Microsoft Azure Import/Export サービスによってインポート ジョブまたはエクスポート ジョブのドライブが処理されるとき、ユーザーが使用したストレージ アカウントに、コピー ログと詳細ログが書き込まれます。 ログは両方とも、それぞれのドライブに対して保存されます。
"コピー ログ" では、ディスクと Azure Storage アカウントの間で失敗したすべてのコピー操作のイベントが報告されます。 コピー ログの最後には、エラーの概要がエラー カテゴリ別に示されます。
"詳細ログ" には、すべての BLOB とファイル上で成功したコピー操作の一覧が示されます。
ログを見つける
Import/Export サービスを使用して Azure Data Box 内でインポートまたはエクスポート ジョブを作成すると、インポート/エクスポート ジョブが他の Data Box リソースと共に表示されます。
インポート/エクスポート ジョブのデータ コピーの状態を確認するには、次の手順に従います。
Azure portal にサインインします。
azure data box を検索します。
Azure Import/Export ジョブにフィルターを適用するには、検索ボックスに「Import/Export」と入力します。
インポート/エクスポート ジョブの一覧がページに表示されます。
ジョブ名を選択してジョブの詳細を表示します。
選択したジョブの [現在のご注文の状況] とデータ コピーの詳細がドライブごとに表示されます。
ストレージ アカウントにアクセスできる場合は、[ログ パスのコピー] または [詳細ログ パス] を選択してログを表示できます。
ドライブ ID を選択して、マニフェスト ファイルやハッシュなど、完全なコピー情報が含まれたパネルを開きます。
コピー ログは自動的に保存されます。 注文したときに詳細ログを保存することを選択した場合は、詳細ログへのパスも表示されます。
ログは、ストレージ アカウント内のコンテナー (BLOB のインポート/エクスポートの場合) または共有 (Azure Files へのインポートの場合) にアップロードされます。 コンテナーの名前は 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 |
エクスポート ジョブの場合は、マニフェスト ファイルもディスクに保存されます。
ディスクのデータ転送ごとにコピー ログが生成されます。 注文を作成したときに詳細ログを保存することを選択した場合は、詳細ログも同じフォルダーにあります。
Note
以前の注文については、詳細ログのほかにエラー ログ (_error.xml) が、ストレージ アカウントの waies コンテナーに表示される場合があります。 エラー ログ概要に表示される DriveLog Version は、2018-10-01 になります。 ログの形式は、この記事で説明したものとは異なります。
インポート ログを確認する
インポート中、Import/Export サービスによって、ディスクごとに詳細ログとコピー ログが生成されます。
詳細ログ
詳細ログは省略可能なファイルで、注文時に有効にできます。 これはドライブから正常にインポートされたすべてのファイルが一覧表示されたシンプルなリストです。 詳細ログには、次の情報がファイルごとに示されています。 詳細ログには概要情報は示されません。
| フィールド | 説明 |
|---|---|
| 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 | エラーの数値コード。 |
| エラーメッセージ | エラーについて説明します。 |
ログの最後にある概要 (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>
エクスポート ログを確認する
エクスポート中、Import/Export サービスによって、Azure Storage からディスクへのデータ転送ごとに詳細ログとコピー ログが生成されます。 マニフェスト ファイルもあり、これはディスクに保存されます。
詳細ログ
エクスポートの詳細ログは、Azure ストレージ アカウントからドライブに正常にエクスポートされたすべてのファイルが一覧表示されたシンプルなリストです。 詳細ログには、次の情報がファイルごとに示されています。 詳細ログには概要情報は示されません。
| フィールド | 説明 |
|---|---|
| CloudFormat | BlockBlob、PageBlob、AzureFile。 |
| Etag | リソースのエンティティ タグ (ETag)。データ転送中、コンカレンシー チェックに使用されます。 |
| パス | ストレージ アカウント内のファイルへのパス。 |
| [サイズ] | ファイルまたは BLOB のサイズ。 |
| crc64 | データをディスクにエクスポート中に計算された循環冗長検査 64 (CRC64) チェックサム。 |
詳細ログのサンプル: エクスポート
次の詳細ログのサンプルでは、エクスポート ジョブによって 3 つの BLOB が Azure Blob Storage から正常に転送されました。
<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 Storage からディスクに正常に転送できなかった各ファイルのエラー エントリが、エラーの詳細と共に含まれています。 コピー ログの最後には、データ転送中に発生した検証エラーとコピー エラーの概要が示されます。
エクスポートのコピー ログでは、ドライブ損傷によるデータ転送の失敗や、データ転送中に変更されたストレージ アカウント キーなどの問題が報告されます。 問題のリストについては、「データ転送エラー」を参照してください。
コピー ログのサンプル: エクスポート
次のサンプルは、3 つのファイル システム エラー (UploadErrorWin32 ) が発生したため、3 つのファイルのエクスポートが失敗したエクスポートのコピー ログです。 エラー 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>
データ転送エラー
インポート ジョブやエクスポート ジョブのコピー ログには、次のエラーが表示されます。
| エラーのカテゴリ | エラー メッセージ | インポートする | Exports |
|---|---|---|---|
UploadErrorWin32 |
ファイル システム エラー。 | はい | はい |
UploadErrorCloudHttp |
サポートされていない BLOB の種類。 このカテゴリのエラーの詳細については、「アップロード エラーの概要」を参照してください。 | はい | はい |
UploadErrorDataValidationError |
データ インジェスト中に計算された CRC が、アップロード中に計算された CRC と一致しません。 | はい | はい |
UploadErrorManagedConversionError |
インポート中の BLOB のサイズが無効です。 BLOB サイズは <blob-size> バイトです。 サポートされているサイズは、20,971,520 バイトから 8,192 GiB までです。 詳細については、「アップロード エラーの概要」を参照してください。 | はい | はい |
UploadErrorUnknownType |
不明なエラー。 | はい | はい |
ContainerRenamed |
元のコンテナー名が Azure の名前付け規則に従っていないため、コンテナーの名前が変更されました。 元のコンテナーの名前は、<original container name> から DataBox-<GUID> に変更されました。 | いいえ | はい |
ShareRenamed |
元の共有名が Azure の名前付け規則に従っていないため、共有の名前が変更されました。 元の共有の名前は、<original folder name> から DataBox-<GUID> に変更されました。 | いいえ | はい |
BlobRenamed |
元の BLOB 名が Azure の名前付け規則に従っていないため、BLOB の名前が変更されました。 元の BLOB の名前は、<original name> から BlockBlob/DataBox-<GUID> に変更されました。 | いいえ | はい |
FileRenamed |
元のファイル名が Azure の名前付け規則に従っていないため、ファイルの名前が変更されました。 元のファイルの名前は、<original name> から AzureFile/DataBox-<GUID> に変更されました。 | いいえ | はい |
DiskRenamed |
元のファイル名が マネージド ディスクの Azure の名前付け規則に従っていないため、マネージド ディスク ファイルの名前が変更されました。 元のマネージド ディスク ファイルの名前は、<original name> から ManagedDisk/DataBox-<GUID> に変更されました。 | いいえ | はい |
FileNameTrailsWithSlash |
BLOB 名またはファイル名の末尾にスラッシュが付いています。 名前の末尾に円記号またはスラッシュが付く BLOB またはファイルは、ディスクにエクスポートできません。 | いいえ | はい |
ExportCloudHttp |
サポートされていない BLOB の種類。 | いいえ | はい |