Menggunakan log untuk memecahkan masalah impor dan ekspor melalui Azure Import/Export

Saat layanan Microsoft Azure Import/Export memproses drive untuk pekerjaan impor atau ekspor, layanan menulis log salinan dan log verbose ke akun penyimpanan yang Anda gunakan. Kedua log disimpan untuk setiap drive.

  • Log salin melaporkan peristiwa untuk semua operasi penyalinan yang gagal antara disk dan akun Azure Storage. Log penyalinan berakhir dengan ringkasan kesalahan menurut kategori kesalahan.

  • Log verbose memiliki daftar semua operasi salin yang berhasil pada setiap blob dan file.

Menemukan log

Saat Anda menggunakan layanan Impor/Ekspor untuk membuat pekerjaan impor atau ekspor di Azure Data Box, Anda akan melihat pekerjaan Impor/Ekspor bersama dengan sumber daya Data Box Lainnya.

Gunakan langkah-langkah berikut untuk mengetahui status salinan data untuk pekerjaan Impor/Ekspor:

  1. Masuk ke portal Azure.

  2. Cari azure data box.

    Cuplikan layar memperlihatkan cara mencari pekerjaan Data Box di portal Azure. Kotak Pencarian dan layanan Azure Data Box yang dipilih disorot.

  3. Untuk memfilter ke pekerjaan Impor/Ekspor Azure, masukkan "Impor/Ekspor" di kotak pencarian.

    Cuplikan layar memperlihatkan cara memfilter sumber daya Data Box di portal Azure untuk memperlihatkan pekerjaan Impor/Ekspor. Kotak Pencarian disorot.

    Daftar pekerjaan Impor/Ekspor muncul di halaman.

    Cuplikan layar sumber daya Data Box di portal Azure difilter untuk Mengimpor pekerjaan Ekspor. Nama pekerjaan, jenis transfer, status, dan model disorot.

  4. Lihat detail pekerjaan dengan memilih nama pekerjaan.

    Status pesanan saat ini dan detail Salinan data pekerjaan yang dipilih ditampilkan untuk setiap drive.

    • Jika Anda memiliki akses ke akun penyimpanan, Anda dapat memilih jalur log Salin atau jalur log Verbose untuk melihat log.

    • Pilih ID Drive untuk membuka panel dengan informasi salinan lengkap, termasuk file manifes dan hash.

    Cuplikan layar Gambaran Umum untuk pekerjaan Ekspor Impor di portal Azure. Status Pesanan, dan Status Penyalinan Data dan URL Log untuk drive, disorot.

Log salinan disimpan secara otomatis. Jika Anda memilih untuk menyimpan log verbose saat melakukan pemesanan, Anda juga akan melihat jalur ke log verbose.

Log diunggah ke kontainer (untuk impor dan ekspor blob) atau berbagi (untuk impor ke Azure Files) di akun penyimpanan. Kontainer diberi nama databoxcopylog. URL memiliki format ini:

Jenis log Format URL
salin log <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_CopyLog_<job-ID>.xml
log verbose <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_VerboseLog_<job-ID>.xml

Untuk pekerjaan ekspor, file manifes juga disimpan ke disk.

Setiap transfer data untuk disk menghasilkan log salinan. Jika Anda memilih untuk menyimpan log verbose saat membuat pesanan, ada juga log verbose di folder yang sama.

Catatan

Untuk pesanan Anda sebelumnya, Anda mungkin menemukan log kesalahan (_error.xml) bersama dengan log verbose dalam waies kontainer di akun penyimpanan. DriveLog Version, yang ditunjukkan dalam ringkasan log kesalahan, akan menjadi 2018-10-01. Format log berbeda dari yang dijelaskan dalam artikel ini.

Meninjau log impor

Selama impor, layanan Impor/Ekspor menghasilkan log verbose dan log salinan untuk setiap disk.

Log verbose

Log verbose adalah file opsional yang dapat Anda aktifkan selama pemesanan. Ini adalah daftar sederhana dari semua file yang berhasil diimpor dari drive. Log verbose memberikan informasi berikut untuk setiap file. Log verbose tidak memberikan informasi ringkasan.

Bidang Deskripsi
CloudFormat BlockBlob, PageBlob, atau AzureFile.
Jalur Jalur ke file dalam akun penyimpanan.
Ukuran Ukuran file atau blob.
crc64 Checksum pemeriksaan redundansi siklik 64 (CRC64) yang digunakan untuk memverifikasi integritas data selama transfer data.

Contoh log verbose: impor

Contoh log verbose berikut memiliki contoh entri file untuk blob blok, blob halaman, dan impor File 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>

Menyalin log

Log salinan berisi entri kesalahan untuk setiap file yang gagal diimpor atau diekspor, dengan detail kesalahan. Log salin berakhir dengan ringkasan kesalahan validasi dan penyalinan yang terjadi selama transfer data.

Setiap entri kesalahan berisi informasi berikut.

Bidang Deskripsi
Jalur Berbagi tujuan dalam kontainer atau berbagi file.
Kategori Mengidentifikasi kategori kesalahan. Untuk informasi selengkapnya, lihat Kesalahan transfer data.
ErrorCode Kode numerik untuk kesalahan.
ErrorMessage Menjelaskan kesalahan.

Ringkasan di akhir log (cari CopyLog Summary) memberikan informasi berikut:

  • Versi log drive (dalam hal ini, 2021-08-01)
  • ID Drive
  • Status penyalinan data
  • Ringkasan kesalahan validasi menurut kategori kesalahan
  • Ringkasan kesalahan penyalinan menurut kategori kesalahan

Contoh log salinan: impor

Sampel berikut adalah log salinan untuk impor ke Penyimpanan Azure Files dan Azure Blob.

Salinan ini gagal, tanpa kesalahan validasi tetapi dengan tiga kesalahan penyalinan. Satu berbagi file diganti namanya (ShareRenamed kesalahan), dan dua kontainer diganti namanya (ContainerRenamed kesalahan). Entri kesalahan memberikan nama file asli dan baru.

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

Meninjau log ekspor

Selama ekspor, layanan Impor/Ekspor menghasilkan log verbose dan log salinan untuk setiap transfer data dari Azure Storage ke disk. Ada juga file manifes, yang disimpan ke disk.

Log verbose

Log verbose untuk ekspor adalah daftar sederhana semua file yang berhasil diekspor dari akun penyimpanan Azure ke drive. Log verbose memberikan informasi berikut untuk setiap file. Log verbose tidak memberikan informasi ringkasan.

Bidang Deskripsi
CloudFormat BlockBlob, PageBlob, atau AzureFile.
Etag Tag entitas (ETag) untuk sumber daya, yang digunakan untuk pemeriksaan konkurensi selama transfer data.
Jalur Jalur ke file dalam akun penyimpanan.
Ukuran Ukuran file atau blob.
crc64 Pemeriksaan redundansi siklik 64 (CRC64) checksum yang dihitung saat mengekspor data ke disk.

Sampel log verbose: ekspor

Dalam contoh log verbose berikut, pekerjaan ekspor berhasil mentransfer tiga blob dari penyimpanan Azure 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>

Menyalin log

Log salinan untuk ekspor berisi entri kesalahan untuk setiap file yang gagal ditransfer dengan sukses dari Azure Storage ke disk, dengan detail kesalahan. Log salin berakhir dengan ringkasan kesalahan validasi dan penyalinan yang terjadi selama transfer data.

Log salin untuk ekspor melaporkan masalah seperti transfer data yang gagal karena drive yang rusak atau kunci akun penyimpanan yang berubah selama transfer data. Untuk daftar masalah, lihat Kesalahan transfer data.

Contoh log salinan: ekspor

Sampel berikut adalah log salinan untuk ekspor yang menemukan tiga kesalahan sistem file ( UploadErrorWin32) yang menyebabkan ekspor tiga file gagal. Kesalahan 267 menunjukkan nama direktori tidak valid. Kesalahan 123 menunjukkan nama file, nama direktori, atau sintaks label volume yang salah.

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

Kesalahan transfer data

Anda akan menemukan kesalahan berikut dalam log salin untuk pekerjaan impor dan/atau pekerjaan ekspor.

Kategori kesalahan Pesan kesalahan Impor Ekspor
UploadErrorWin32 Kesalahan sistem file. Ya Ya
UploadErrorCloudHttp Jenis blob yang tidak didukung. Untuk informasi selengkapnya tentang kesalahan dalam kategori ini, lihat Ringkasan kesalahan pengunggahan. Ya Ya
UploadErrorDataValidationError CRC yang dikomputasi selama penyerapan data tidak cocok dengan CRC yang dikomputasi saat pengunggahan. Ya Ya
UploadErrorManagedConversionError Ukuran blob yang diimpor tidak valid. Ukuran blob adalah <byte ukuran> blob. Ukuran yang didukung adalah antara 20971520 Byte dan 8192 GiB. Untuk informasi selengkapnya, lihat Ringkasan kesalahan pengunggahan. Ya Ya
UploadErrorUnknownType Kesalahan tidak diketahui. Ya Ya
ContainerRenamed Mengganti nama kontainer karena nama kontainer asli tidak mengikuti konvensi penamaan Azure. Kontainer asli telah diganti namanya menjadi DataBox-GUID<> dari< nama> kontainer asli. Tidak Ya
ShareRenamed Mengganti nama berbagi karena nama berbagi asli tidak mengikuti konvensi penamaan Azure. Berbagi asli telah diganti namanya menjadi DataBox-GUID<> dari< nama> folder asli. Tidak Ya
BlobRenamed Mengganti nama blob karena nama blob asli tidak mengikuti konvensi penamaan Azure. Blob asli telah diganti namanya menjadi BlockBlob/DataBox-GUID<> dari< nama> asli. Tidak Ya
FileRenamed Mengganti nama file karena nama file asli tidak mengikuti konvensi penamaan Azure. File asli telah diganti namanya menjadi AzureFile/DataBox-GUID<> dari< nama> asli. Tidak Ya
DiskRenamed Mengganti nama file disk terkelola karena nama file asli tidak mengikuti konvensi penamaan Azure untuk disk terkelola. File disk terkelola asli diganti namanya menjadi ManagedDisk/DataBox-GUID<> dari< nama> asli. Tidak Ya
FileNameTrailsWithSlash Nama blob atau nama file diakhir dengan garis miring berikutnya. Nama blob atau nama file yang diakhir dengan garis miring terbalik berikutnya atau garis miring tidak dapat diekspor ke disk. Tidak Ya
ExportCloudHttp Jenis blob yang tidak didukung. Tidak Ya

Langkah berikutnya