Bagikan melalui


Temukan kesalahan dan lanjutkan pekerjaan dengan menggunakan file log dan rencana 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 rencana untuk melanjutkan pekerjaan. Artikel ini juga menunjukkan cara mengonfigurasi file log dan file rencana dengan mengubah tingkat detailnya, dan lokasi default tempat file disimpan.

Nota

Untuk konten yang membantu Anda mulai menggunakan AzCopy, lihat Mulai menggunakan AzCopy. Artikel ini berlaku untuk AzCopy V10 karena ini adalah versi AzCopy yang saat ini didukung. Jika Anda perlu menggunakan AzCopy versi sebelumnya, lihat Menggunakan versi AzCopy sebelumnya.

File log dan paket

AzCopy membuat file log dan rencana untuk setiap pekerjaan. Anda dapat menggunakan log ini untuk menyelidiki dan memecahkan masalah yang mungkin terjadi.

Log berisi status kegagalan (UPLOADFAILED, , COPYFAILEDdan DOWNLOADFAILED), jalur lengkap, dan alasan kegagalan.

Secara default, file log dan paket terletak di direktori %USERPROFILE%\.azcopy di Windows atau direktori $HOME$\.azcopy di Mac dan Linux, tetapi Anda dapat mengubah lokasi tersebut.

Kesalahan yang relevan belum tentu merupakan kesalahan pertama yang muncul dalam file. Untuk kesalahan seperti kesalahan jaringan, waktu habis, dan kesalahan sibuk server, AzCopy mencoba kembali hingga 20 kali dan biasanya proses coba lagi berhasil. Kesalahan pertama yang Anda lihat mungkin adalah sesuatu yang tidak berbahaya yang berhasil dicoba kembali. Jadi, alih-alih melihat kesalahan pertama dalam file, cari kesalahan yang berada di dekat UPLOADFAILED, COPYFAILED, atau DOWNLOADFAILED.

Penting

Saat mengirimkan permintaan ke Dukungan Microsoft (atau memecahkan masalah yang melibatkan pihak ketiga mana pun), bagikan versi perintah yang ingin Anda jalankan yang disunting. Versi ini memastikan SAS tidak secara tidak sengaja dibagikan dengan siapa pun. Anda dapat menemukan versi redaksional di awal file log.

Meninjau kesalahan dalam log

Perintah berikut mengambil semua kesalahan berstatus UPLOADFAILED dari 04dc9ca9-158f-7945-5933-564021086c79 log.

Select-String UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log

Melihat dan melanjutkan pekerjaan

Setiap operasi transfer membuat pekerjaan AzCopy. Gunakan perintah berikut untuk melihat riwayat pekerjaan:

azcopy jobs list

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

Petunjuk / Saran

Nilai --with-status bendera peka huruf besar/kecil.

Gunakan perintah berikut untuk melanjutkan pekerjaan yang gagal atau dibatalkan. Perintah ini menggunakan pengidentifikasi pekerjaan bersama dengan token SAS karena tidak persisten karena alasan keamanan:

azcopy jobs resume <job-id> --source-sas="<sas-token>" --destination-sas="<sas-token>"

Petunjuk / Saran

Lampirkan argumen jalur seperti token SAS dengan tanda kutip tunggal (''). Gunakan tanda kutip tunggal di semua shell perintah kecuali 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 ('').

Saat Anda melanjutkan pekerjaan, AzCopy melihat file rencana pekerjaan. File rencana mencantumkan semua file yang diidentifikasi untuk diproses saat pekerjaan pertama kali dibuat. Saat Anda melanjutkan pekerjaan, AzCopy akan berusaha untuk mentransfer semua file yang tercantum dalam file rencana dan belum ditransfer.

Mengubah lokasi file paket

Gunakan perintah berikut.

export AZCOPY_JOB_PLAN_LOCATION=<value>

Mengubah lokasi file log

Gunakan perintah berikut.

export AZCOPY_LOG_LOCATION=<value>

Mengubah tingkat log default

Secara default, AzCopy mengatur tingkat log ke INFO. Untuk mengurangi verbositas log dan menghemat ruang disk, gunakan opsi --log-level untuk menimpa pengaturan ini.

Level log yang tersedia adalah: DEBUG, INFO, WARNING, ERROR, dan NONE.

Menghapus file log dan paket

Untuk menghapus semua file rencana dan log dari komputer lokal Anda dan menghemat ruang disk, gunakan perintah azcopy jobs clean.

Untuk menghapus file rencana dan log hanya untuk satu pekerjaan, gunakan azcopy jobs rm <job-id>. Ganti tempat penampung <job-id> dalam contoh ini dengan ID pekerjaan yang diinginkan.

Lihat juga