로그를 사용하여 Azure Import/Export를 통해 가져오기 및 내보내기 문제 해결

아티클
10/26/2023

Microsoft Azure Import/Export 서비스가 가져오기 또는 내보내기 작업에 대한 드라이브를 처리할 때 서비스는 사용자가 사용한 스토리지 계정에 복사 로그 및 자세한 로그를 씁니다. 두 로그는 각 드라이브에 대해 저장됩니다.

복사 로그는 디스크와 Azure Storage 계정 간의 모든 실패한 복사 작업에 대한 이벤트를 보고합니다. 복사 로그는 오류 범주별 오류 요약으로 끝납니다.
자세한 로그에는 모든 blob 및 파일에서 성공한 모든 복사 작업 목록이 있습니다.

로그 찾기

Import/Export 서비스를 사용하여 Azure Data Box에서 가져오기 또는 내보내기 작업을 만드는 경우 다른 Data Box 리소스와 함께 Import/Export 작업을 볼 수 있습니다.

다음 단계를 사용하여 Import/Export 작업의 데이터 복사 상태를 확인합니다.

Azure Portal에 로그인합니다.
Azure Data Box를 검색합니다.
Azure Import/Export 작업으로 필터링하려면 검색 상자에 "Import/Export"를 입력합니다.

Import/Export 작업 목록이 페이지에 나타납니다.
작업 이름을 선택하여 작업 세부 정보를 봅니다.

선택한 작업의 현재 순서 상태 및 데이터 복사 세부 정보가 각 드라이브에 대해 표시됩니다.
- 스토리지 계정에 액세스할 수 있는 경우 복사 로그 경로 또는 자세한 로그 경로를 선택하여 로그를 볼 수 있습니다.
- 드라이브 ID를 선택하여 매니페스트 파일 및 해시를 포함한 전체 복사 정보가 있는 패널을 엽니다.

복사 로그가 자동으로 저장됩니다. 주문을 할 때 자세한 로그를 저장하도록 선택한 경우 자세한 로그의 경로도 표시됩니다.

로그는 스토리지 계정의 컨테이너(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

내보내기 작업의 경우 매니페스트 파일도 디스크에 저장됩니다.

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

참고 항목

이전 주문의 경우 스토리지 계정의 waies 컨테이너에 있는 자세한 로그와 함께 오류 로그(_error.xml)도 찾을 수 있습니다. 오류 로그 요약에 표시되는 DriveLog Version은 2018-10-01이 됩니다. 로그 형식은 이 문서에 설명된 형식과 다릅니다.

가져오기 로그 검토

가져오는 동안 Import/Export 서비스는 각 디스크에 대해 자세한 로그와 복사 로그를 생성합니다.

자세한 정보 로그

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

필드	설명
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	컨테이너 또는 파일 공유 내의 대상 공유입니다.
범주	오류 범주를 식별합니다. 자세한 내용은 데이터 전송 오류를 참조하세요.
오류 코드	오류의 숫자 코드입니다.
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>

내보내기 로그 검토

내보내기 중에 Import/Export 서비스는 Azure Storage에서 디스크로의 각 데이터 전송에 대한 자세한 로그와 복사 로그를 생성합니다. 디스크에 저장된 매니페스트 파일도 있습니다.

자세한 정보 로그

내보내기의 자세한 로그는 Azure Storage 계정에서 드라이브로 성공적으로 내보낸 모든 파일의 간단한 목록입니다. 자세한 로그는 각 파일에 대해 다음 정보를 제공합니다. 자세한 로그는 요약 정보를 제공하지 않습니다.

필드	설명
CloudFormat	BlockBlob, PageBlob 또는 AzureFile입니다.
ETag	데이터 전송 중에 동시성 검사에 사용되는 리소스의 ETag(엔터티 태그)입니다.
Path	스토리지 계정 내의 파일 경로입니다.
크기	파일 또는 BLOB 크기입니다.
crc64	데이터를 디스크로 내보내는 동안 계산된 순환 중복도 검사 64(CRC64) 체크섬입니다.

자세한 로그 샘플: 내보내기

다음 자세한 로그 샘플에서는 내보내기 작업이 Azure Blob Storage에서 3개의 Blob을 성공적으로 전송했습니다.

<File CloudFormat="BlockBlob" ETag="0x8D804D87F976907" Path="export-blobs/movie/sc%3Aifi/block.blob" Size="4096" crc64="16033727819182370206">
</File><File CloudFormat="BlockBlob" ETag="0x8D804D889880CC6" Path="export-blobs/movie/sc#Aifi/block.blob" Size="4096" crc64="16033727819182370206">
</File><File CloudFormat="BlockBlob" ETag="0x8D804D8F1BC81C0" Path="export-blobs/@GMT-2001.03.30-14.44.00/block.blob" Size="4096" crc64="16033727819182370206">
</File>

복사 로그

내보내기에 대한 복사 로그에는 Azure Storage에서 디스크로 성공적으로 전송하지 못한 각 파일에 대한 오류 항목과 오류 세부 정보가 포함되어 있습니다. 복사 로그는 데이터 전송 중에 발생한 유효성 검사 및 복사 오류의 요약으로 끝납니다.

내보내기의 복사 로그는 손상된 드라이브로 인해 실패한 데이터 전송 또는 데이터 전송 중에 변경된 스토리지 계정 키와 같은 이슈를 보고합니다. 이슈 목록은 데이터 전송 오류를 참조하세요.

복사 로그 샘플: 내보내기

다음 샘플은 3개 파일의 내보내기를 실패하게 만든 3개의 파일 시스템 오류(UploadErrorWin32)가 발견된 내보내기의 복사 로그입니다. 오류 267은 디렉터리 이름이 잘못되었음을 나타냅니다. 오류 123은 잘못된 파일 이름, 디렉터리 이름 또는 볼륨 레이블 구문을 나타냅니다.

<ErroredEntity CloudFormat="BlockBlob" Path="export-ut-invaliddirblobpath/movie/sc:Aifi/block.blob">
  <Category>UploadErrorWin32</Category>
  <ETag>0x8D804D8840B92C9</ETag>
  <ErrorCode>267</ErrorCode>
  <ErrorMessage>File Create failed</ErrorMessage>
  <Type>File</Type>
</ErroredEntity><ErroredEntity CloudFormat="BlockBlob" Path="export-ut-invaliddirblobpath/movie/sc-Aifi/block.blob">
  <Category>UploadErrorWin32</Category>
  <ETag>0x8D804D8AD026B2A</ETag>
  <ErrorCode>123</ErrorCode>
  <ErrorMessage>File Create failed</ErrorMessage>
  <Type>File</Type>
</ErroredEntity><ErroredEntity CloudFormat="BlockBlob" Path="export-ut-invaliddirblobpath/movie/sc*Aifi/block.blob">
  <Category>UploadErrorWin32</Category>
  <ETag>0x8D804D8A858F705</ETag>
  <ErrorCode>123</ErrorCode>
  <ErrorMessage>File Create failed</ErrorMessage>
  <Type>File</Type>
</ErroredEntity><CopyLog Summary="Summary">
  <DriveLogVersion>2021-08-01</DriveLogVersion>
  <DriveId>cb57dbe8-0b67-45e0-ad40-a08fb5305c60</DriveId>
  <Status>Failed</Status>
  <TotalFiles_Blobs>9</TotalFiles_Blobs>
  <FilesErrored>6</FilesErrored>
  <Summary>
    <ValidationErrors>
      <None Count="3" />
    </ValidationErrors>
    <CopyErrors>
      <UploadErrorWin32 Count="3" Description="File Create failed because of UploadErrorWin32 exception" />
    </CopyErrors>
  </Summary>
</CopyLog>

데이터 전송 오류

가져오기 작업 및/또는 내보내기 작업에 대한 복사 로그에서 다음 오류를 찾을 수 있습니다.

오류 범주	오류 메시지	가져오기	내보내기
`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 명명 규칙을 따르지 않기 때문에 파일 이름이 변경되었습니다. 원본 파일 이름이 <원본 이름>에서 AzureFile/DataBox-<GUID>로 바뀌었습니다.	예	예
`DiskRenamed`	원본 파일 이름이 관리 디스크에 대한 Azure 명명 규칙을 따르지 않기 때문에 관리 디스크 파일의 이름이 바뀌었습니다. 원본 관리 디스크 파일의 이름이 <원본 이름>에서 ManagedDisk/DataBox-<GUID>로 바뀌었습니다.	예	예
`FileNameTrailsWithSlash`	Blob 이름 또는 파일 이름은 후행 슬래시로 끝납니다. 후행 백슬래시 또는 슬래시로 끝나는 Blob 이름 또는 파일 이름은 디스크로 내보낼 수 없습니다.	예	예
`ExportCloudHttp`	지원되지 않는 blob 형식입니다.	예	예

다음을 통해 공유

로그를 사용하여 Azure Import/Export를 통해 가져오기 및 내보내기 문제 해결

로그 찾기

가져오기 로그 검토

자세한 정보 로그

자세한 로그 샘플: 가져오기

복사 로그

복사 로그 샘플: 가져오기

내보내기 로그 검토

자세한 정보 로그

자세한 로그 샘플: 내보내기

복사 로그

복사 로그 샘플: 내보내기

데이터 전송 오류

다음 단계

피드백

추가 리소스