استخدام السجلات لاستكشاف مشكلات التحميل وإصلاحها في Azure Data Box Disk

ينشئ كل نقل بيانات للقرص سجل نسخ. إذا اخترت حفظ سجل مطول عند تقديم طلبك، فهناك أيضا سجل مطول في المجلد نفسه.

سجل مطول

السجل المطول هو ملف اختياري يمكنك تمكينه أثناء الطلب. إنها قائمة بسيطة بجميع الملفات التي تم استيرادها بنجاح من محرك الأقراص، مع المعلومات التالية لكل ملف. لا يوفر السجل المطول معلومات ملخصة.

نموذج سجل مطول

يحتوي نموذج السجل المطول التالي على إدخالات ملف نموذجية للكتلة الثنائية كبيرة الحجم، ونقطة الصفحة، واستيراد ملف Azure.

<File CloudFormat="BlockBlob" Path="$root\file26fd6b4bd-25f7-4019-8d0d-baa7355745df.vhd" Size="1024" crc64="14179624636173788226">
</File><File CloudFormat="BlockBlob" Path="$root\file49d220295-9cfd-469e-b69e-5c7c885133df.vhd" Size="1024" crc64="14179624636173788226">
</File>
----------CUT--------------------
<File CloudFormat="AzureFile" Path="e579954d-1f94-40cf-955f-afd39e9ca217\file1876f73ad-6213-43bc-9467-67fe0c794e99.block" Size="1024" crc64="1410470866535975213">
</File><File CloudFormat="AzureFile" Path="05407abe-81c8-4b44-b846-3a2c8c198316\file28d7868be-e6a7-4441-8d09-2b127f7d049e.vhd" Size="1024" crc64="1410470866535975213">
</File><File CloudFormat="AzureFile" Path="eb7666a7-c026-4375-9c08-3dea37a57713\file4448aeaf5-53dc-4bff-b798-4776e367ab5e.vhd" Size="1024" crc64="1410470866535975213">
</File>
----------CUT--------------------
<File CloudFormat="PageBlob" Path="tesdir8b1d0acd-2d37-46dd-96cf-edeb0f772e6b\file1.txt" Size="83886080" crc64="1680234237456714851">
</File><File CloudFormat="PageBlob" Path="tesdirf631630d-8098-4c84-be7b-40f6bbdb73fb\file_size0.txt" Size="0" crc64="0">
</File><File CloudFormat="PageBlob" Path="tesdirf631630d-8098-4c84-be7b-40f6bbdb73fb\Dir1/file_size0.txt" Size="0" crc64="0">
</File>

سجل النسخ

يحتوي سجل النسخ على إدخال خطأ لكل ملف فشل استيراده، مع تفاصيل الخطأ. ينتهي سجل النسخ بملخص للتحقق من الصحة وأخطاء النسخ التي حدثت أثناء الاستيراد.

يحتوي كل إدخال خطأ على المعلومات التالية.

يعطي الملخص في نهاية السجل (ابحث عن CopyLog Summary) المعلومات التالية:

• إصدار سجل محرك الأقراص (في هذه الحالة، 2021-08-01)
• معرّف محرك الأقراص
• حالة نسخ البيانات
• ملخص أخطاء التحقق حسب فئة الخطأ
• ملخص أخطاء النسخ حسب فئة الخطأ

نموذج سجل النسخ

النموذج التالي هو سجل نسخ لاستيراد إلى كل من Azure Files وتخزين Azure Blob.

فشلت هذه النسخة، مع عدم وجود أخطاء في التحقق من الصحة ولكن مع ثلاثة أخطاء في النسخ. تمت إعادة تسمية مشاركة ملف واحد (ShareRenamed خطأ)، وتمت إعادة تسمية حاويتين (ContainerRenamed خطأ). يعطي إدخال الخطأ أسماء الملفات الأصلية والجديدة.

<ErroredEntity Path="New Folder">
  <Category>ShareRenamed</Category>
  <ErrorCode>1</ErrorCode>
  <ErrorMessage>The original container/share/Blob has been renamed to: DataBox-f55763d4-8ef7-458f-b029-f36b51ada34f :from: New Folder :because either name has invalid character(s) or length is not supported</ErrorMessage>
  <Type>Container</Type>
</ErroredEntity>
<ErroredEntity Path="CV">
  <Category>ContainerRenamed</Category>
  <ErrorCode>1</ErrorCode>
  <ErrorMessage>The original container/share/Blob has been renamed to: DataBox-6bcae46f-04c8-4385-8442-3a28b962c930 :from: CV :because either name has invalid character(s) or length is not supported</ErrorMessage>
  <Type>Container</Type>
</ErroredEntity><ErroredEntity Path="New_ShareFolder">
  <Category>ContainerRenamed</Category>
  <ErrorCode>1</ErrorCode>
  <ErrorMessage>The original container/share/Blob has been renamed to: DataBox-96d8e2ee-ffd4-4529-9ec0-f666674b70d9 :from: New_ShareFolder :because either name has invalid character(s) or length is not supported</ErrorMessage>
  <Type>Container</Type>
</ErroredEntity>
<CopyLog Summary="Summary">
  <DriveLogVersion>2021-08-01</DriveLogVersion>
  <DriveId>72a1914a-7fb2-4e34-a135-5c7176c3ee41</DriveId>
  <Status>Failed</Status>
  <TotalFiles_Blobs>60</TotalFiles_Blobs>
  <FilesErrored>0</FilesErrored>
  <Summary>
    <ValidationErrors>
      <None Count="3" />
    </ValidationErrors>
    <CopyErrors>
      <ShareRenamed Count="1" Description="Renamed the share as the original share name does not follow Azure conventions." />
      <ContainerRenamed Count="2" Description="Renamed the container as the original container name does not follow Azure conventions." />
    </CopyErrors>
  </Summary>
</CopyLog>

في إصدار سجل محرك الأقراص 2018-10-01، ينتج عن تحميل البيانات سجل خطأ وسجل مطول. كلا السجلين بالتنسيق نفسه ويحتويان على أوصاف XML للأحداث التي حدثت أثناء نسخ البيانات من القرص إلى حساب Azure Storage.

يحتوي السجل المطول على كامل حول حالة عملية النسخ لكل كائن ثنائي كبير الحجم أو ملف، بينما يحتوي سجل الأخطاء فقط على معلومات الكائنات الثنائية كبيرة الحجم أو الملفات التي واجهت أخطاء أثناء التحميل.

سجل الأخطاء له بنية السجل المطول نفسها، ولكنه يقوم بتصفية العمليات الناجحة.

نموذج سجل مطول

تُعرض عينة من _verbose.xml أدناه. في هذه الحالة، يكون الطلب قد اكتمل بنجاح وبغير أخطاء.

<?xml version="1.0" encoding="utf-8"?>
<DriveLog Version="2018-10-01">
  <DriveId>184020D95632</DriveId>
  <Blob Status="Completed">
    <BlobPath>$root/botetapageblob.vhd</BlobPath>
    <FilePath>\PageBlob\botetapageblob.vhd</FilePath>
    <Length>1073742336</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <PageRangeList>
      <PageRange Offset="0" Length="4194304" Status="Completed" />
      <PageRange Offset="4194304" Length="4194304" Status="Completed" />
      <PageRange Offset="8388608" Length="4194304" Status="Completed" />
      --------CUT-------------------------------------------------------
      <PageRange Offset="1061158912" Length="4194304" Status="Completed" />
      <PageRange Offset="1065353216" Length="4194304" Status="Completed" />
      <PageRange Offset="1069547520" Length="4194304" Status="Completed" />
      <PageRange Offset="1073741824" Length="512" Status="Completed" />
    </PageRangeList>
  </Blob>
  <Blob Status="Completed">
    <BlobPath>$root/botetablockblob.txt</BlobPath>
    <FilePath>\BlockBlob\botetablockblob.txt</FilePath>
    <Length>19</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <BlockList>
      <Block Offset="0" Length="19" Status="Completed" />
    </BlockList>
  </Blob>
  <File Status="Completed">
    <FileStoragePath>botetaazurefilesfolder/botetaazurefiles.txt</FileStoragePath>
    <FilePath>\AzureFile\botetaazurefilesfolder\botetaazurefiles.txt</FilePath>
    <Length>20</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <FileRangeList>
      <FileRange Offset="0" Length="20" Status="Completed" />
    </FileRangeList>
  </File>
  <Status>Completed</Status>
</DriveLog>

نموذج سجلات الأخطاء

للترتيب نفسه، تُعرض عينة من _error.xml أدناه.

<?xml version="1.0" encoding="utf-8"?>
<DriveLog Version="2018-10-01">
  <DriveId>184020D95632</DriveId>
  <Summary>
    <ValidationErrors>
      <None Count="3" />
    </ValidationErrors>
    <CopyErrors>
      <None Count="3" Description="No errors encountered" />
    </CopyErrors>
  </Summary>
  <Status>Completed</Status>
</DriveLog>

تُعرض عينة من _error.xml أدناه حيث تم إكمال الطلب مع وجود أخطاء.

يحتوي ملف الخطأ في هذه الحالة على قسم Summary وقسم آخر يحتوي على جميع أخطاء مستوى الملف.

يحتوي Summary على ValidationErrors وCopyErrors. في هذه الحالة، انتهى تحميل ثمانية ملفات أو مجلدات إلى Azure ولم تكن هناك أخطاء في التحقق من الصحة. عند نسخ البيانات إلى حساب Azure Storage، تم تحميل خمسة ملفات أو مجلدات بنجاح. أعيدت تسمية الملفات أو المجلدات الثلاثة المتبقية وفقاً لاتفاقيات تسمية حاوية Azure، ثم حُمِّلت بنجاح إلى Azure.

تكون حالات مستوى الملف في BlobStatus، والتي تصف أي إجراءات تم اتخاذها لتحميل الكائنات الثنائية كبيرة الحجم. في هذه الحالة، تعاد تسمية ثلاث حاويات لأن المجلدات المنسوخ إليها البيانات لا تتوافق مع اصطلاحات تسمية Azure للحاويات. بالنسبة إلى blobs المُحمَّلة في تلك الحاويات، فيُضمن فيها اسم الحاوية الجديدة، ومسار blob في Azure، ومسار الملف الأصلي غير الصالح، وحجم blob.

 <?xml version="1.0" encoding="utf-8"?>
  <DriveLog Version="2018-10-01">
    <DriveId>18041C582D7E</DriveId>
    <Summary>
      <ValidationErrors>
        <None Count="8" />
      </ValidationErrors>
      <CopyErrors>
        <Completed Count="5" Description="No errors encountered" />
        <ContainerRenamed Count="3" Description="Renamed the container as the original container name does not follow Azure conventions." />
      </CopyErrors>
    </Summary>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/private.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\private.vhd</OriginalFilePath>
      <SizeInBytes>10490880</SizeInBytes>
    </Blob>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/resource.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\resource.vhd</OriginalFilePath>
      <SizeInBytes>71528448</SizeInBytes>
    </Blob>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/role.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\role.vhd</OriginalFilePath>
      <SizeInBytes>10490880</SizeInBytes>
    </Blob>
    <Status>CompletedWithErrors</Status>
  </DriveLog>

يتم وصف الأخطاء الموجودة في سجل النسخ 2018-10-01 أدناه.

لُخصت الأخطاء المنشأة عند تحميل البيانات إلى Azure في الجدول التالي. تم العثور على مجموعة الأخطاء هذه في سجل الخطأ 2018-10-01.