Menggunakan log untuk memecahkan masalah pengunggahan di Azure Data Box Disk

Artikel ini menjelaskan masalah yang Anda lihat saat mengunggah data di pusat data Azure menggunakan Azure Data Box Disk.

Tentang log pengunggahan

Saat data dari Data Box Disk diunggah di pusat data Azure, log salin/kesalahan dan log verbose dibuat untuk setiap akun penyimpanan. Log ini diunggah ke akun penyimpanan yang sama yang digunakan untuk mengunggah data.

• 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

Untuk menemukan log dari unggahan data, lakukan langkah-langkah berikut.

1. Buka pesanan Anda di portal Azure.

2. Saat unggahan data selesai untuk setiap disk, panel Gambaran Umum menampilkan status disk dan jalur ke log diagnostik untuk disk.

   • Untuk pesanan baru, detail disk terlihat seperti yang ada di layar berikut. 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 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 pesanan Anda sebelumnya, tampilan mungkin terlihat seperti layar berikut.

     Jika ada kesalahan saat mengunggah data ke Azure, log Salin menampilkan jalur ke folder tempat log diagnostik berada.

     

     Log diunggah ke waies kontainer di akun penyimpanan. URL memiliki format ini:

     Jenis log	Format URL
     log kesalahan	<storage-account-name>/databoxlogs-order-name<>/waies/ri-order-name-guid_><<drive-ID>_<timestamp>_error.xml
     log verbose	<storage-account-name>/databoxlogs-order-name<>/waies/ri-order-name-guid_><<drive-ID>_<timestamp>_verbose.xml

   Catatan

   Log dalam kontainer databoxcopylog memiliki format yang berbeda dari log dalam waies kontainer. Untuk bantuan menginterpretasikan log, gunakan instruksi untuk versi log drive terkait. Lihat Mengidentifikasi versi log untuk informasi selengkapnya.

3. Untuk melihat log, buka kontainer yang menyimpan log di akun penyimpanan Anda. Ilustrasi berikut menunjukkan log dalam waies kontainer.

   

4. Pilih tiap-tiap log dan unduh salinan lokal.

Mengidentifikasi versi log

Ada dua versi log salin/kesalahan dan log verbose, dengan format yang berbeda. Versi log dibahas secara terpisah di bagian berikut.

Bersama dengan log verbose, Anda akan melihat log salinan (_copy.xml) atau log kesalahan (_error.xml), tergantung pada rilis drive.

Untuk mengetahui rilis log untuk log salin/kesalahan dan log verbose yang menyertainya, periksa versi log drive di log salin/kesalahan.

Nama file log	Bidang	Versi log drive
_copy.xml	DriveLogVersion	2021-08-01
_error.xml	Versi DriveLog	2018-10-01

Ilustrasi berikut ini memperlihatkan DriveLogVersion di bagian ringkasan log salinan.

Sampel log pengunggahan

Format log log salin/kesalahan dan log verbose berbeda untuk dua versi log. Jika Anda tidak yakin versi log mana yang Anda miliki, lihat Mengidentifikasi versi log.

Versi log: 2021-08-01

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

Log verbose

Log verbose adalah file opsional yang dapat Anda aktifkan selama pemesanan. Ini adalah daftar sederhana semua file yang berhasil diimpor dari drive, dengan 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

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 salin berisi entri kesalahan untuk setiap file yang gagal diimpor, dengan detail kesalahan. Log salin berakhir dengan ringkasan kesalahan validasi dan penyalinan yang terjadi selama impor.

Setiap entri kesalahan berisi informasi berikut.

Bidang	Deskripsi
Jalur	Berbagi tujuan dalam kontainer atau berbagi file.
Kategori	Salah satu dari 15 kategori kesalahan. Untuk informasi selengkapnya, lihat Kesalahan unggahan data untuk Log versi 2021-08-01.
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

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>

Versi log: 2018-10-01

Di drive log versi 2018-10-01, unggahan data menghasilkan log kesalahan dan log verbose. Kedua log berada dalam format yang sama dan berisi deskripsi XML tentang kejadian yang terjadi saat menyalin data dari disk ke akun Azure Storage.

Log verbose berisi lengkap tentang status operasi salin untuk setiap blob atau file, sedangkan log kesalahan hanya berisi informasi untuk blob atau file yang mengalami kesalahan selama pengunggahan.

Log galat memiliki struktur yang sama dengan log verbose, tetapi memfilter operasi yang berhasil.

Contoh log verbose

Sampel _verbose.xml ditunjukkan di bawah ini. Dalam hal ini, pesanan berhasil diselesaikan tanpa kesalahan.

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

Contoh log kesalahan

Untuk pesanan yang sama, sampel _error.xml ditampilkan di bawah ini.

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

Sampel _error.xml ditampilkan di bawah ini di mana pesanan selesai dengan kesalahan.

File kesalahan dalam kasus ini memiliki bagian Summary dan bagian lain yang berisi semua kesalahan tingkat file.

Summary berisi ValidationErrors dan CopyErrors. Dalam hal ini, 8 file atau folder diunggah ke Azure dan tidak ada kesalahan validasi. Ketika data disalin ke akun Azure Storage, 5 file atau folder berhasil diunggah. 3 file atau folder yang tersisa diganti namanya sesuai konvensi penamaan kontainer Azure lalu diunggah dengan sukses ke Azure.

Status tingkat file ada di BlobStatus, yang menjelaskan tindakan apa pun yang diambil untuk mengunggah blob. Dalam hal ini, tiga kontainer diganti namanya karena folder tempat data disalin tidak sesuai dengan konvensi penamaan Azure untuk kontainer. Untuk blob yang diunggah dalam kontainer tersebut, nama kontainer baru, jalur blob di Azure, jalur file asli yang tidak valid, dan ukuran blob disertakan.

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

Kesalahan pengunggahan data

Kesalahan yang dilaporkan dalam log sedikit bervariasi dalam dua versi log. Jika Anda tidak yakin versi log mana yang Anda miliki, lihat Mengidentifikasi versi log.

Versi log: 2021-08-01

Kesalahan yang ditemukan dalam log salinan 2018-10-01 dijelaskan di bawah ini.

Kategori kesalahan	Deskripsi
UploadErrorWin32	Kesalahan sistem file.
UploadErrorCloudHttp	Jenis blob yang tidak didukung. Untuk informasi selengkapnya tentang kesalahan dalam kategori ini, lihat Ringkasan kesalahan pengunggahan.
UploadErrorDataValidationError	CRC yang dikomputasi selama penyerapan data tidak cocok dengan CRC yang dikomputasi saat pengunggahan.
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.
UploadErrorUnknownType	Kesalahan tidak diketahui.
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.
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.
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.
FileRenamed	Mengganti nama file karena nama file asli tidak mengikuti konvensi penamaan Azure. Blob asli telah diganti namanya menjadi AzureFile/DataBox-GUID<> dari< nama> asli.
DiskRenamed	Mengganti nama file disk terkelola karena nama file asli tidak mengikuti konvensi penamaan Azure. File disk terkelola asli diganti namanya menjadi ManagedDisk/DataBox-GUID<> dari< nama> asli.
ExportCloudHttp	Jenis blob yang tidak didukung.

Versi log: 2018-10-01

Kesalahan yang terjadi saat mengunggah data ke Azure diringkas dalam tabel berikut. Set kesalahan ini ditemukan di log kesalahan 2018-10-01.

Kode kesalahan	Deskripsi
Renamed	Berhasil mengganti nama blob.
CompletedWithErrors	Pengunggahan selesai dengan kesalahan. Rincian file dengan kesalahan disertakan dalam file log.
Corrupted	CRC yang dikomputasi selama penyerapan data tidak cocok dengan CRC yang dikomputasi saat pengunggahan.
StorageRequestFailed	Permintaan penyimpanan Azure gagal.
LeasePresent	Item ini disewakan dan sedang digunakan oleh pengguna lain.
StorageRequestForbidden	Tidak bisa mengunggah karena masalah autentikasi.
ManagedDiskCreationTerminalFailure	Tidak bisa mengunggah sebagai disk terkelola. File tersedia di akun penyimpanan penahapan sebagai blob halaman. Anda dapat mengonversi blob halaman secara manual ke disk terkelola.
DiskConversionNotStartedTierInfoMissing	Karena file VHD disalin di luar folder tingkat yang dibuat sebelumnya, disk terkelola tidak dibuat. File diunggah sebagai blob halaman ke akun penyimpanan penahapan seperti yang ditetapkan saat pembuatan pesanan. Anda dapat mengonversinya secara manual ke disk terkelola.
InvalidWorkitem	Tidak dapat mengunggah data karena tidak sesuai dengan konvensi penamaan dan batas Azure.
InvalidPageBlobUploadAsBlockBlob	Diunggah sebagai blob blok dalam kontainer dengan awalan databoxdisk-invalid-pb-.
InvalidAzureFileUploadAsBlockBlob	Diunggah sebagai blob blok dalam kontainer dengan awalan databoxdisk-invalid-af-.
InvalidManagedDiskUploadAsBlockBlob	Diunggah sebagai blob blok dalam kontainer dengan awalan databoxdisk-invalid-md-.
InvalidManagedDiskUploadAsPageBlob	Diunggah sebagai blob halaman dalam kontainer dengan awalan databoxdisk-invalid-md-.
MovedToOverflowShare	Mengunggah file ke berbagi baru karena ukuran berbagi asli melebihi batas ukuran maksimum Azure. Nama berbagi file baru memiliki nama asli yang diakhiri dengan -2.
MovedToDefaultAzureShare	Mengunggah file yang bukan bagian dari folder apa pun ke berbagi default. Nama berbagi dimulai dengan databox-.
ContainerRenamed	Kontainer untuk file-file ini tidak sesuai dengan konvensi penamaan Azure dan diganti namanya. Nama baru dimulai dengan databox- dan diakhiri dengan hash SHA1 dari nama asli
ShareRenamed	Berbagi untuk file-file ini tidak sesuai dengan konvensi penamaan Azure dan diganti namanya. Nama baru dimulai dengan databox- dan diakhiri dengan hash SHA1 dari nama asli.
BlobRenamed	File-file ini tidak sesuai dengan konvensi penamaan Azure dan diganti namanya. Periksa bidang BlobPath untuk nama baru.
FileRenamed	File-file ini tidak sesuai dengan konvensi penamaan Azure dan diganti namanya. Periksa bidang FileStoragePath untuk nama baru.
DiskRenamed	File-file ini tidak sesuai dengan konvensi penamaan Azure dan diganti namanya. Periksa bidang BlobPath untuk nama baru.

Langkah berikutnya

Hubungi Dukungan Microsoft.