로그를 사용하여 Azure Data Box Disk의 업로드 문제 해결

  • 아티클

이 문서에서는 Azure Data Box Disk를 사용하여 Azure 데이터 센터에 데이터를 업로드할 때 발생하는 문제에 대해 설명합니다.

로그 업로드 정보

Data Box Disk의 데이터가 Azure 데이터 센터에 업로드되면 각 스토리지 계정에 대해 복사/오류 로그 및 상세 로그가 생성됩니다. 이러한 로그는 데이터를 업로드하는 데 사용된 동일한 스토리지 계정에 업로드됩니다.

  • 복사 로그는 디스크와 Azure Storage 계정 간의 모든 실패한 복사 작업에 대한 이벤트를 보고합니다. 복사 로그는 오류 범주별 오류 요약으로 끝납니다.

  • 자세한 로그에는 모든 blob 및 파일에서 성공한 모든 복사 작업 목록이 있습니다.

로그 찾기

데이터 업로드에서 로그를 찾으려면 다음 단계를 수행합니다.

  1. Azure Portal에서 주문을 엽니다.

  2. 각 디스크에 대한 데이터 업로드가 완료되면 개요 창에 디스크 상태와 디스크의 진단 로그 경로가 표시됩니다.

    • 새 주문의 경우 디스크 세부 정보는 다음 화면과 같습니다. 복사 로그가 자동으로 저장됩니다. 주문을 할 때 자세한 로그를 저장하도록 선택한 경우 자세한 로그의 경로도 표시됩니다.

      Screenshot of the Overview pane for a Data Box Disk order with Copy Completed With Warnings status. A Copy Log Path and Verbose Log Path are highlighted.

      로그는 스토리지 계정의 컨테이너(BLOB 가져오기용) 또는 공유(Azure Files로 가져오기용)에 업로드됩니다. 컨테이너 이름은 databoxcopylog로 지정됩니다. URL의 형식은 다음과 같습니다.

      로그 형식 URL 형식
      복사 로그 <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_CopyLog_<job-ID>.xml
      자세한 정보 로그 <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_VerboseLog_<job-ID>.xml

    • 이전 주문의 경우 다음 화면과 같이 표시될 수 있습니다.

      데이터를 Azure에 업로드할 때 발생하는 오류가 있으면 로그 복사에 진단 로그가 있는 폴더의 경로가 표시됩니다.

      Screenshot of the Overview pane for an earlier Data Box Disk order with completed copies. The Copy Log Paths are highlighted.

      로그는 스토리지 계정의 waies 컨테이너에 업로드됩니다. URL의 형식은 다음과 같습니다.

      로그 형식 URL 형식
      오류 로그(error log) <storage-account-name>/databoxlogs-<order-name>/waies/ri-<order-name>-guid_<drive-ID>_<timestamp>_error.xml
      자세한 정보 로그 <storage-account-name>/databoxlogs-<order-name>/waies/ri-<order-name>-guid_<drive-ID>_<timestamp>_verbose.xml

    참고 항목

    databoxcopylog 컨테이너의 로그는 waies 컨테이너의 로그와 형식이 다릅니다. 로그를 해석하는 데 도움이 필요하면 연결된 드라이브 로그 버전에 대한 지침을 사용합니다. 자세한 내용은 로그 버전 식별을 참조하세요.

  3. 로그를 보려면 스토리지 계정에 로그를 저장하는 컨테이너를 엽니다. 다음 그림은 waies 컨테이너의 로그를 보여 줍니다.

    Screenshot of error logs and verbose logs in a storage account for an Azure Data Box Disk order. The logs in the W-A-I-E-S containers are highlighted.

  4. 각 로그 선택 및 로컬 복사본 다운로드.

로그 버전 식별

형식이 다른 두 가지 버전의 복사/오류 로그와 상세 로그가 있습니다. 로그 버전은 다음 섹션에서 별도로 설명합니다.

상세 로그와 함께 드라이브 릴리스에 따라 복사 로그(_copy.xml) 또는 오류 로그(_error.xml)가 표시됩니다.

복사/오류 로그와 함께 제공되는 자세한 로그의 로그 릴리스를 찾으려면 복사/오류 로그에서 드라이브 로그 버전을 확인합니다.

로그 파일 이름 필드 드라이브 로그 버전
_copy.xml DriveLogVersion 2021-08-01
_error.xml DriveLog 버전 2018-10-01

다음 그림은 복사 로그의 요약 섹션에 있는 DriveLogVersion을 보여 줍니다.

Illustration of the Summary section of a copy log for a Data Box Disk order. The Drive Log Version is highlighted.

샘플 업로드 로그

복사/오류 로그와 상세 로그의 로그 형식은 두 로그 버전에서 다릅니다. 보유하고 있는 로그 버전이 확실하지 않은 경우 로그 버전 식별을 참조하세요.

디스크에 대한 각 데이터 전송은 복사 로그를 생성합니다. 주문할 때 상세 로그를 저장하도록 선택한 경우 동일한 폴더에도 상세 로그가 있습니다.

자세한 정보 로그

자세한 로그는 주문하는 동안 사용하도록 설정할 수 있는 선택적 파일입니다. 각 파일에 대한 다음 정보와 함께 드라이브에서 성공적으로 가져온 모든 파일의 간단한 목록입니다. 자세한 로그는 요약 정보를 제공하지 않습니다.

필드 설명
CloudFormat BlockBlob, PageBlob 또는 AzureFile입니다.
Path 스토리지 계정 내의 파일 경로입니다.
크기 파일 또는 BLOB 크기입니다.
crc64 데이터 전송 중 데이터 무결성을 확인하는 데 사용된 CRC64(순환 중복 검사 64) 체크섬입니다.

샘플 상세 로그

다음 샘플 상세 정보 로그에는 블록 Blob, 페이지 Blob 및 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>

복사 로그

복사 로그에는 가져오기에 실패한 각 파일에 대한 오류 항목과 오류 세부 정보가 포함되어 있습니다. 복사 로그는 가져오기 중에 발생한 유효성 검사 및 복사 오류에 대한 요약으로 끝납니다.

각 오류 항목은 다음과 같은 정보를 포함합니다.

필드 설명
Path 컨테이너 또는 파일 공유 내의 대상 공유입니다.
범주 15가지 오류 범주 중 하나입니다. 자세한 내용은 로그 버전 2021-08-01의 데이터 업로드 오류를 참조하세요.
오류 코드 오류의 숫자 코드입니다.
ErrorMessage 오류를 설명합니다.

로그 끝에 있는 요약(CopyLog Summary 검색)은 다음 정보를 제공합니다.

  • 드라이브 로그 버전(이 경우 2021-08-01)
  • 드라이브 ID
  • 데이터 복사 상태
  • 오류 범주별 유효성 검사 오류 요약
  • 오류 범주별 복사 오류 요약

샘플 복사 로그

다음 샘플은 Azure Files 및 Azure Blob Storage 모두로 가져오기에 대한 복사 로그입니다.

이 복사는 유효성 검사 오류 없이 실패했지만 세 개의 복사 오류가 발생했습니다. 하나의 파일 공유 이름이 바뀌었고(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 복사 로그에서 발견된 오류는 다음과 같습니다.

오류 범주 설명
UploadErrorWin32 파일 시스템 오류입니다.
UploadErrorCloudHttp 지원되지 않는 blob 형식입니다. 이 범주의 오류에 대한 자세한 내용은 업로드 오류 요약을 참조하세요.
UploadErrorDataValidationError 데이터 수집 중에 계산된 CRC가 업로드 중에 계산된 CRC와 일치하지 않습니다.
UploadErrorManagedConversionError 가져오는 Blob의 크기가 잘못되었습니다. blob 크기는 <blob-size> 바이트입니다. 지원되는 크기는 20971520바이트와 8192GiB 사이입니다. 자세한 내용은 업로드 오류 요약을 참조하세요.
UploadErrorUnknownType 알 수 없는 오류입니다.
ContainerRenamed 원래 컨테이너 이름이 Azure 명명 규칙을 따르지 않기 때문에 컨테이너 이름이 변경되었습니다. 원래 컨테이너의 이름이 <원래 컨테이너 이름>에서 DataBox-<GUID>로 변경되었습니다.
ShareRenamed 원래 공유 이름이 Azure 명명 규칙을 따르지 않기 때문에 공유 이름이 변경되었습니다. 원래 공유는 <원래 폴더 이름>에서 DataBox-<GUID>로 이름이 변경되었습니다.
BlobRenamed 원래 blob 이름이 Azure 명명 규칙을 따르지 않기 때문에 blob 이름이 변경되었습니다. 원래 Blob의 이름이 <원래 이름>에서 BlockBlob/DataBox-<GUID>로 변경되었습니다.
FileRenamed 원래 파일 이름이 Azure 명명 규칙을 따르지 않기 때문에 파일 이름이 변경되었습니다. 원래 Blob의 이름이 <원래 이름>에서 AzureFile/DataBox-<GUID>로 변경되었습니다.
DiskRenamed 원래 파일 이름이 Azure 명명 규칙을 따르지 않기 때문에 관리 디스크 파일의 이름이 변경되었습니다. 원본 관리 디스크 파일의 이름이 <원본 이름>에서 ManagedDisk/DataBox-<GUID>로 바뀌었습니다.
ExportCloudHttp 지원되지 않는 blob 형식입니다.

다음 단계

Microsoft 지원에 문의하세요.