البحث عن الأخطاء واستئناف المهام باستخدام السجل وملفات الخطة في AzCopy
AzCopy هو أداة سطر الأوامر التي يمكنك استخدامها لنسخ كائنات ثنائية كبيرة الحجم أو ملفات إلى أو من حساب تخزين. تساعدك هذه المقالة على استخدام السجلات لتشخيص الأخطاء، ثم استخدام ملفات الخطة لاستئناف المهام. توضح هذه المقالة أيضًا كيفية تكوين ملفات السجل والتخطيط عن طريق تغيير مستوى الإسهاب الخاص بها، والموقع الافتراضي حيث يتم تخزينها.
ملاحظة
إذا كنت تبحث عن محتوى لمساعدتك في بدء استخدام AzCopy، فراجع بدء استخدام AzCopy. تنطبق هذه المقالة على AzCopy V10 كما هو الحال في هذا الإصدار المدعوم حاليًا من AzCopy. إن كنت بحاجة إلى استخدام إصدار سابق من AzCopy، فراجع استخدام الإصدار السابق من AzCopy.
السجل وملفات الخطة
يقوم AzCopy بإنشاء السجلوملفاتالخطة لكل مهمة. يمكنك استخدام هذه السجلات للتحقيق في أي مشاكل محتملة واستكشاف الأخطاء وإصلاحها.
ستحتوي السجلات على حالة الفشل (UPLOADFAILED
وCOPYFAILED
وDOWNLOADFAILED
)، والمسار الكامل، وسبب الفشل.
بشكل افتراضي، يوجد السجل ملفات الخطة في الدليل %USERPROFILE%\.azcopy
على Windows أو الدليل $HOME$\.azcopy
على Mac وLinux، ولكن يمكنك تغيير هذا الموقع.
الخطأ ذو الصلة ليس بالضرورة الخطأ الأول الذي يظهر في الملف. بالنسبة إلى الأخطاء مثل أخطاء الشبكة والمهلات وأخطاء انشغال الخادم، سيقوم AzCopy بإعادة المحاولة حتى 20 مرة وعادة ما تنجح عملية إعادة المحاولة. قد يكون الخطأ الأول الذي تراه شيئًا غير ضار تمت إعادة معالجته بنجاح. لذلك بدلاً من النظر إلى الخطأ الأول في الملف، ابحث عن الأخطاء القريبة UPLOADFAILED
أو COPYFAILED
أو DOWNLOADFAILED
.
هام
عند إرسال طلب إلى دعم Microsoft (أو استكشاف الأخطاء وإصلاحها في المشكلة المتعلقة بأي جهة أخري)، شارك الإصدار المنقح من الأمر الذي تريد تنفيذه. وهذا يضمن عدم مشاركة SAS عن طريق الخطأ مع أي شخص. يمكنك العثور على النسخة المنقحة في بداية ملف السجل.
مراجعة السجلات بحثًا عن الأخطاء
سيحصل الأمر التالي على جميع الأخطاء المتعلقة بالحالة UPLOADFAILED
من السجل 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
عرض المهام واستئنافها
ستقوم كل عملية نقل بإنشاء مهمة AzCopy. استخدم الأمر التالي لعرض محفوظات المهام:
azcopy jobs list
استخدم الأمر التالي لعرض إحصائيات المهمة:
azcopy jobs show <job-id>
استخدم الأمر التالي لتصفية عمليات النقل حسب الحالة:
azcopy jobs show <job-id> --with-status=Failed
تلميح
قيمة العلم --with-status
حساسة لحالة الأحرف.
استخدم الأمر التالي لاستئناف مهمة فاشلة/ملغاة. يستخدم هذا الأمر معرفه مع رمز SAS المميز لأنه غير مستمر لأسباب أمنية:
azcopy jobs resume <job-id> --source-sas="<sas-token>" --destination-sas="<sas-token>"
تلميح
أرفق وسيطات المسار مثل الرمز المميز SAS بعلامات اقتباس مفردة («»). استخدم علامات اقتباس مفردة في كافة أغلفة الأوامر باستثناء Windows Command Shell (cmd.exe). إذا كنت تستخدم Windows Command Shell (cmd.exe)، فقم بتضمين وسيطات المسار بعلامات اقتباس مزدوجة («») بدلاً من علامات اقتباس مفردة («»).
عند استئناف مهمة، يبحث AzCopy في ملف خطة المهمة. يسرد ملف الخطة كافة الملفات التي تم تحديدها للمعالجة عند إنشاء المهمة لأول مرة. عند استئناف مهمة، سيحاول AzCopy نقل كافة الملفات المسردة في ملف الخطة التي لم يتم نقلها بالفعل.
تغيير موقع ملفات الخطة
استخدم أيًا من هذه الأوامر.
نظام التشغيل | الأمر |
---|---|
Windows | PowerShell:$env:AZCOPY_JOB_PLAN_LOCATION="<value>" في موجه الأوامر استخدم: set AZCOPY_JOB_PLAN_LOCATION=<value> |
Linux | export AZCOPY_JOB_PLAN_LOCATION=<value> |
macOS | export AZCOPY_JOB_PLAN_LOCATION=<value> |
استخدم azcopy env
للتحقق من القيمة الحالية لهذا المتغير. إذا كانت القيمة فارغة، إذًا فملفات الخطة مكتوبة إلى الموقع الافتراضي.
تغيير موقع ملفات السجل
استخدم أيًا من هذه الأوامر.
نظام التشغيل | الأمر |
---|---|
Windows | PowerShell:$env:AZCOPY_LOG_LOCATION="<value>" في موجه الأوامر استخدم: set AZCOPY_LOG_LOCATION=<value> |
Linux | export AZCOPY_LOG_LOCATION=<value> |
macOS | export AZCOPY_LOG_LOCATION=<value> |
استخدم azcopy env
للتحقق من القيمة الحالية لهذا المتغير. إذا كانت القيمة فارغة، إذًا فالسجلات مكتوبة إلى الموقع الافتراضي.
تغيير مستوى السجل الافتراضي
بشكل افتراضي، يتم تعيين مستوى سجل AzCopy إلى INFO
. إذا كنت ترغب في تقليل الإسهاب في السجل لتوفير مساحة على القرص، فقم بالكتابة فوق هذا الإعداد باستخدام الخيار --log-level
.
مستويات السجل المتاحة هي: DEBUG
وINFO
وWARNING
وERROR
وNONE
.
إزالة ملفات الخطة والسجل
إذا كنت ترغب في إزالة كافة ملفات الخطة والسجل من جهازك المحلي لتوفير مساحة على القرص، فاستخدم الأمر azcopy jobs clean
.
لإزالة ملفات الخطة والسجل المقترنة بمهمة واحدة فقط، استخدم azcopy jobs rm <job-id>
. استبدل العنصر النائب <job-id>
في هذا المثال بمعرف الوظيفة الخاص بالوظيفة.