Aracılığıyla paylaş


AzCopy'de günlük ve plan dosyalarını kullanarak hataları bulun ve işleri devam ettirin.

AzCopy, blobları veya dosyaları depolama hesabına veya depolama hesabından kopyalamak için kullanabileceğiniz 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 ayrıntı düzeyini ve depolandıkları varsayılan konumu değiştirerek günlük ve plan dosyalarının nasıl yapılandırıldığı da gösterilir.

Uyarı

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 hataları gibi hatalar için AzCopy en fazla 20 kez yeniden dener ve genellikle yeniden deneme işlemi 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 , UPLOADFAILEDveya COPYFAILEDyakınındaki DOWNLOADFAILEDhataları arayın.

Önemli

Microsoft Desteği'ne 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 hiç kimseyle paylaşılmamasını sağlar. Düzenlenmiş 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 UPLOADFAILED günlüğünden 04dc9ca9-158f-7945-5933-564021086c79 durumundaki tüm hataları alacaktı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 devam etme

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

Tavsiye

Bayrağı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>"

Tavsiye

Şu örnekte olduğu gibi, SAS belirteci gibi path argümanlarını tek tırnak ('') içine alın. Windows Komut Kabuğu (cmd.exe) dışında tüm komut kabuklarında tek tırnak işareti kullanın. Windows Komut Kabuğu (cmd.exe) kullanıyorsanız, yol isimlerini 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ış tüm dosyaları aktarmaya çalışır.

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 öğesini azcopy env kullanın. 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 öğesini azcopy env kullanın. Değer boşsa, günlükler varsayılan konuma yazılır.

Varsayılan günlük düzeyini değiştir

Varsayılan olarak, AzCopy günlük düzeyi INFO olarak ayarlanır. Disk alanından tasarruf etmek için logların ayrıntı düzeyini azaltmak istiyorsanız, --log-level seçeneğini kullanarak bu ayarı değiştirin.

Kullanılabilir günlük düzeyleri şunlardır: DEBUG, INFO, WARNING, ERROR, ve 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.

Ayrıca bkz.