Menemukan kesalahan dan melanjutkan pekerjaan menggunakan file log dan paket di AzCopy
AzCopy adalah utilitas baris perintah yang dapat Anda gunakan untuk menyalin gumpalan atau file ke atau dari akun penyimpanan. Artikel ini membantu Anda menggunakan log untuk mendiagnosis kesalahan, lalu menggunakan file paket untuk melanjutkan pekerjaan. Artikel ini juga menunjukkan cara mengonfigurasikan file log dan paket dengan mengubah tingkat verbositasnya, dan lokasi default tempat file disimpan.
Catatan
Jika Anda mencari konten untuk membantu Anda mulai menggunakan AzCopy, lihat Mulai menggunakan AzCopy. Artikel ini berlaku untuk AzCopy V10 karena merupakan versi AzCopy terbaru yang didukung. Jika Anda perlu menggunakan AzCopy versi sebelumnya, lihat Gunakan versi AzCopy sebelumnya.
File log dan paket
AzCopy membuat file log dan paket untuk setiap pekerjaan. Anda dapat menggunakan log ini untuk menyelidiki dan memecahkan masalah yang mungkin terjadi.
Log akan berisi status kegagalan (UPLOADFAILED, COPYFAILED, dan DOWNLOADFAILED), jalur lengkap, serta alasan kegagalan.
Secara default, file log dan paket terletak di direktori %USERPROFILE%\.azcopydi Windows atau direktori $HOME$\.azcopy di Mac dan Linux, tetapi Anda dapat mengubah lokasi tersebut.
Kesalahan relevan belum tentu merupakan kesalahan pertama yang muncul dalam file. Untuk kesalahan seperti kesalahan jaringan, waktu habis dan kesalahan Server Sibuk, AzCopy akan mencoba ulang hingga 20 kali dan biasanya proses percobaan ulang berhasil. Kesalahan pertama yang Anda lihat mungkin sesuatu yang tidak berbahaya, yang berhasil dicoba ulang. Jadi alih-alih melihat kesalahan pertama dalam file, carilah kesalahan yang dekat UPLOADFAILED, COPYFAILED, atau DOWNLOADFAILED.
Penting
Saat mengirimkan permintaan ke Dukungan Microsoft (atau pemecahan masalah yang melibatkan pihak ketiga mana pun), bagikan versi redaksional perintah yang ingin Anda jalankan. Ini untuk memastikan SAS tidak tanpa sengaja dibagikan dengan siapa pun. Anda dapat menemukan versi redaksional di awal file log.
Meninjau kesalahan dalam log
Perintah berikut ini akan menampilkan semua kesalahan dengan status UPLOADFAILED dari log 04dc9ca9-158f-7945-5933-564021086c79:
Windows (PowerShell)
Select-String UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
Linux
grep UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
Melihat dan melanjutkan pekerjaan
Setiap operasi transfer akan menghasilkan pekerjaan AzCopy. Gunakan perintah berikut untuk melihat riwayat pekerjaan:
azcopy jobs list
Untuk menampilkan statistik pekerjaan, gunakan perintah berikut:
azcopy jobs show <job-id>
Untuk memfilter transfer menurut status, gunakan perintah berikut:
azcopy jobs show <job-id> --with-status=Failed
Tip
Nilai bendera --with-status peka huruf besar/kecil.
Gunakan perintah berikut untuk melanjutkan pekerjaan yang gagal/dibatalkan. Demi alasan keamanan, perintah ini menggunakan pengidentifikasinya beserta token SAS karena tidak bersifat permanen:
azcopy jobs resume <job-id> --source-sas="<sas-token>" --destination-sas="<sas-token>"
Tip
Sertakan argumen jalur seperti token SAS dengan tanda kutip tunggal (''). Gunakan tanda kutip tunggal di semua shell perintah kecuali untuk Windows Command Shell (cmd.exe). Jika Anda menggunakan Windows Command Shell (cmd.exe), sertakan argumen jalur dengan tanda kutip ganda ("") dan bukan tanda kutip tunggal ('').
Ketika Anda melanjutkan pekerjaan, AzCopy melihat file paket pekerjaan. File paket tersebut mencantumkan semua file yang diidentifikasi untuk diproses saat pekerjaan pertama kali dibuat. Ketika Anda meneruskan pekerjaan, AzCopy akan mencoba mentransfer semua file yang tercantum dalam file paket yang belum ditransfer.
Mengubah lokasi file paket
Gunakan salah satu perintah ini.
| Sistem operasi | Perintah |
|---|---|
| Windows | PowerShell:$env:AZCOPY_JOB_PLAN_LOCATION="<value>" Di perintah gunakan: set AZCOPY_JOB_PLAN_LOCATION=<value> |
| Linux | export AZCOPY_JOB_PLAN_LOCATION=<value> |
| macOS | export AZCOPY_JOB_PLAN_LOCATION=<value> |
Gunakan azcopy env untuk memeriksa nilai saat ini dari variabel ini. Jika nilai kosong, maka file paket ditulis ke lokasi default.
Mengubah lokasi file log
Gunakan salah satu perintah ini.
| Sistem operasi | Perintah |
|---|---|
| Windows | PowerShell:$env:AZCOPY_LOG_LOCATION="<value>" Di perintah gunakan: set AZCOPY_LOG_LOCATION=<value> |
| Linux | export AZCOPY_LOG_LOCATION=<value> |
| macOS | export AZCOPY_LOG_LOCATION=<value> |
Gunakan azcopy env untuk memeriksa nilai saat ini dari variabel ini. Jika nilai kosong, maka file log ditulis ke lokasi default.
Mengubah tingkat log default
Secara default, tingkat log AzCopy diatur ke INFO. Jika Anda ingin mengurangi verbositas log untuk menghemat ruang disk, timpa pengaturan ini menggunakan opsi --log-level.
Tingkat log yang tersedia adalah: DEBUG, INFO, WARNING, ERROR, dan NONE.
Menghapus file log dan paket
Jika Anda ingin menghapus semua file log dan paket dari komputer lokal untuk menghemat ruang disk, gunakan perintah azcopy jobs clean.
Untuk menghapus file log dan paket yang terkait dengan satu pekerjaan saja, gunakan azcopy jobs rm <job-id>. Ganti tempat penampung <job-id> dalam contoh ini dengan ID pekerjaan yang diinginkan.