AzCopy'de günlük ve plan dosyalarını kullanarak hataları bulma ve işleri sürdürme
AzCopy, bir depolama hesabına iki yönlü blob veya dosya kopyalama işlemi gerçekleştirmenizi sağlayan bir komut satırı yardımcı programıdır. Bu makale hataları tanılamak için günlükleri kullanmanıza ve ardından işleri sürdürmek için plan dosyalarını kullanmanıza yardımcı olur. Bu makalede ayrıca günlük ve plan dosyalarının ayrıntı düzeyini ve depolandıkları varsayılan konumu değiştirerek nasıl yapılandırıldığı da gösterilir.
Not
AzCopy'yi kullanmaya başlamanıza yardımcı olacak içerik arıyorsanız bkz. AzCopy'yi kullanmaya başlama. Bu makale AzCopy V10 için geçerlidir ve azCopy'nin şu anda desteklenen sürümüdür. AzCopy'nin önceki bir sürümünü kullanmanız gerekiyorsa bkz. AzCopy'nin önceki sürümünü kullanma.
Günlük ve plan dosyaları
AzCopy her iş için günlük ve plan dosyaları oluşturur. Bu günlükleri kullanarak olası sorunları araştırabilir ve giderebilirsiniz.
Günlüklerde hatanın durumu (UPLOADFAILED, COPYFAILED veDOWNLOADFAILED), tam yol bilgisi ve hatanın nedeni yer alır.
Günlük ve plan dosyaları varsayılan olarak Windows'da %USERPROFILE%\.azcopy dizininde, Mac ve Linux'ta ise $HOME$\.azcopy dizininde bulunur ama bu konumu değiştirebilirsiniz.
İlgili hata, dosyada görünen ilk hata olmayabilir. Ağ hataları, zaman aşımları ve Sunucu Meşgul gibi hatalarda AzCopy en fazla 20 kez yeniden dener ve yeniden deneme işlemi çoğunlukla başarılı olur. Gördüğünüz ilk hata, başarıyla yeniden denenen zararsız bir hata olabilir. Bu nedenle, dosyadaki ilk hataya bakmak yerine , COPYFAILEDveya DOWNLOADFAILEDyakınındaki UPLOADFAILEDhataları arayın.
Önemli
Microsoft Desteği bir istek gönderirken (veya herhangi bir üçüncü tarafla ilgili sorunu giderirken), yürütmek istediğiniz komutun yeniden düzenlenmiş sürümünü paylaşın. Bu, SAS'nin yanlışlıkla kimseyle paylaşılmamasını sağlar. Azaltılmış sürümü günlük dosyasının başında bulabilirsiniz.
Hatalar için günlükleri gözden geçirme
Aşağıdaki komut 04dc9ca9-158f-7945-5933-564021086c79 günlüğünden durumu UPLOADFAILED olan tüm hataları alır:
Windows (PowerShell)
Select-String UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
Linux
grep UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
İşleri görüntüleme ve sürdürme
Her aktarım işlemi bir AzCopy işi oluşturur. İşlerin geçmişini görüntülemek için aşağıdaki komutu kullanın:
azcopy jobs list
İş istatistiklerini görüntülemek için aşağıdaki komutu kullanın:
azcopy jobs show <job-id>
Aktarımları duruma göre filtrelemek için aşağıdaki komutu kullanın:
azcopy jobs show <job-id> --with-status=Failed
İpucu
bayrağının --with-status değeri büyük/küçük harfe duyarlıdır.
Başarısız/İptal edilmiş bir işi sürdürmek için aşağıdaki komutu kullanın. Bu komut, güvenlik nedenleriyle kalıcı olmadığından SAS belirtecinin yanı sıra tanımlayıcısını da kullanır:
azcopy jobs resume <job-id> --source-sas="<sas-token>" --destination-sas="<sas-token>"
İpucu
SAS belirteci gibi yol bağımsız değişkenlerini tek tırnak ('') içine alın. Windows Komut Kabuğu (cmd.exe) dışında tüm komut kabuklarında tek tırnak kullanın. Windows Komut Kabuğu (cmd.exe) kullanıyorsanız, yol bağımsız değişkenlerini tek tırnak ('') yerine çift tırnak ("") içine alın.
Bir işi sürdürürken AzCopy iş planı dosyasına bakar. Plan dosyası, iş ilk oluşturulduğunda işlenmek üzere tanımlanan tüm dosyaları listeler. Bir işi sürdürdüğünüzde AzCopy, plan dosyasında listelenen ve henüz aktarılmamış olan tüm dosyaları aktarmayı dener.
Plan dosyalarının konumunu değiştirme
Bu komutlardan herhangi birini kullanın.
| İşletim sistemi | Komut |
|---|---|
| Windows | Powershell:$env:AZCOPY_JOB_PLAN_LOCATION="<value>" Komut isteminde şunu kullanın: set AZCOPY_JOB_PLAN_LOCATION=<value> |
| Linux | export AZCOPY_JOB_PLAN_LOCATION=<value> |
| macOS | export AZCOPY_JOB_PLAN_LOCATION=<value> |
Bu değişkenin geçerli değerini denetlemek için kullanın azcopy env . Değer boşsa plan dosyaları varsayılan konuma yazılır.
Günlük dosyalarının konumunu değiştirme
Bu komutlardan herhangi birini kullanın.
| İşletim sistemi | Komut |
|---|---|
| Windows | Powershell:$env:AZCOPY_LOG_LOCATION="<value>" Komut isteminde şunu kullanın: set AZCOPY_LOG_LOCATION=<value> |
| Linux | export AZCOPY_LOG_LOCATION=<value> |
| macOS | export AZCOPY_LOG_LOCATION=<value> |
Bu değişkenin geçerli değerini denetlemek için kullanın azcopy env . Değer boşsa günlükler varsayılan konuma yazılır.
Varsayılan günlük düzeyini değiştirme
Varsayılan olarak, AzCopy günlük düzeyi olarak INFOayarlanır. Disk alanından tasarruf etmek için günlük ayrıntı düzeyini azaltmak istiyorsanız, seçeneğini kullanarak bu ayarın --log-level üzerine yazın.
Kullanılabilir günlük düzeyleri şunlardır: DEBUG, INFO, WARNING, ERRORve NONE.
Plan ve günlük dosyalarını kaldırma
Disk alanından tasarruf etmek için yerel makinenizden tüm plan ve günlük dosyalarını kaldırmak istiyorsanız azcopy jobs clean komutunu kullanın.
Tek bir işle ilişkilendirilmiş plan ve günlük dosyalarını kaldırmak için azcopy jobs rm <job-id> kullanın. Bu örnekteki <job-id> yer tutucusunu işin iş kimliğiyle değiştirin.