البحث عن الأخطاء واستئناف المهام باستخدام السجل وملفات الخطة في 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>⁩ في هذا المثال بمعرف الوظيفة الخاص بالوظيفة.

راجع أيضًا