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ığı gösterilmektedir.

Uyarı

AzCopy'yi kullanmaya başlamanıza yardımcı olacak içerik için 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ükler hata durumunu (UPLOADFAILED, COPYFAILEDve DOWNLOADFAILED), tam yolu ve hatanın nedenini içerir.

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 sürüm, SAS'nin yanlışlıkla 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, 04dc9ca9-158f-7945-5933-564021086c79 günlüğünden UPLOADFAILED durumunda olan tüm hataları alır:

Select-String 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 veya iptal edilmiş bir işi sürdürmek için aşağıdaki komutu kullanın. Bu komut, güvenlik nedeniyle kalıcı olmadığından SAS belirteciyle birlikte iş tanımlayıcısını 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ı aktarmayı dener.

Plan dosyalarının konumunu değiştirme

Aşağıdaki komutu kullanın.

export AZCOPY_JOB_PLAN_LOCATION=<value>

Günlük dosyalarının konumunu değiştirme

Aşağıdaki komutu kullanın.

export AZCOPY_LOG_LOCATION=<value>

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

Varsayılan olarak, AzCopy günlük düzeyini INFO olarak ayarlar. Günlük ayrıntı düzeyini azaltmak ve disk alanından tasarruf etmek için bu ayarın --log-level üzerine yazma seçeneğini kullanın.

Kullanılabilir günlük düzeyleri şunlardır: DEBUG, INFO, WARNING, ERROR, ve NONE.

Plan ve günlük dosyalarını kaldırma

Tüm plan ve günlük dosyalarını yerel makinenizden kaldırmak ve disk alanından tasarruf etmek için komutunu kullanın azcopy jobs clean .

Yalnızca bir işin plan ve günlük dosyalarını kaldırmak için kullanın azcopy jobs rm <job-id>. Bu örnekteki <job-id> yer tutucusunu işin iş kimliğiyle değiştirin.

Ayrıca bkz.