Udostępnij za pośrednictwem

Używanie dzienników do rozwiązywania problemów z importami i eksportami za pośrednictwem usługi Azure Import/Export

  • Artykuł

Gdy usługa Microsoft Azure Import/Export przetwarza dyski dla zadania importu lub eksportu, usługa zapisuje dzienniki kopiowania i pełne dzienniki na użyte konto magazynu. Oba dzienniki są zapisywane dla każdego dysku.

  • Dziennik kopiowania zgłasza zdarzenia dla wszystkich nieudanych operacji kopiowania między dyskiem a kontem usługi Azure Storage. Dziennik kopiowania kończy się podsumowaniem błędów według kategorii błędów.

  • Pełny dziennik zawiera listę wszystkich operacji kopiowania, które zakończyły się powodzeniem dla każdego obiektu blob i pliku.

Lokalizowanie dzienników

Gdy używasz usługi Import/Export do utworzenia zadania importu lub eksportu na urządzeniu Azure Data Box, wyświetlisz zadanie Importuj/Eksportuj wraz z innymi zasobami urządzenia Data Box .

Wykonaj następujące kroki, aby sprawdzić stan kopii danych dla zadania importu/eksportu:

  1. Zaloguj się w witrynie Azure Portal.

  2. Wyszukaj pole danych platformy Azure.

    Zrzut ekranu przedstawiający sposób wyszukiwania zadań urządzenia Data Box w witrynie Azure Portal. Pole Wyszukiwania i wybrana usługa Azure Data Box są wyróżnione.

  3. Aby przefiltrować zadania importu/eksportu platformy Azure, wprowadź ciąg "Import/Export" w polu wyszukiwania.

    Zrzut ekranu przedstawiający sposób filtrowania zasobów usługi Data Box w witrynie Azure Portal w celu wyświetlenia zadań importu/eksportu. Pole Wyszukiwania zostało wyróżnione.

    Na stronie zostanie wyświetlona lista zadań importu/eksportu.

    Zrzut ekranu przedstawiający zasoby usługi Data Box w witrynie Azure Portal przefiltrowane do zadań importu eksportu. Nazwa zadania, typ transferu, stan i model są wyróżnione.

  4. Wyświetl szczegóły zadania, wybierając nazwę zadania.

    Bieżący stan zamówienia wybranego zadania i szczegóły kopiowania danych są wyświetlane dla każdego dysku.

    • Jeśli masz dostęp do konta magazynu, możesz wybrać ścieżkę dziennika kopiowania lub pełnej ścieżki dziennika, aby wyświetlić dziennik.

    • Wybierz identyfikator dysku, aby otworzyć panel z pełnymi informacjami o kopii, w tym plikiem manifestu i skrótem.

    Zrzut ekranu przedstawiający przegląd zadania importu eksportu w witrynie Azure Portal. Stan zamówienia oraz stan kopiowania danych i adresy URL dziennika dla dysku są wyróżnione.

Dziennik kopiowania jest zapisywany automatycznie. Jeśli zdecydujesz się zapisać pełne dzienniki po złożeniu zamówienia, zobaczysz również ścieżkę do pełnego dziennika.

Dzienniki są przekazywane do kontenera (w przypadku importowania i eksportowania obiektów blob) lub udziału (w przypadku importu do usługi Azure Files) na koncie magazynu. Kontener nosi nazwę databoxcopylog. Adresy URL mają następujące formaty:

Typ dziennika Format adresu URL
kopiuj dziennik <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_CopyLog_<job-ID>.xml
pełny dziennik <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_VerboseLog_<job-ID>.xml

W przypadku zadań eksportu plik manifestu jest również zapisywany na dysku.

Każdy transfer danych dla dysku generuje dziennik kopiowania. Jeśli zdecydujesz się zapisać pełny dziennik podczas tworzenia zamówienia, w tym samym folderze znajduje się również pełny dziennik.

Uwaga

W przypadku wcześniejszych zamówień możesz znaleźć dziennik błędów (_error.xml) wraz z pełnym dziennikiem waies w kontenerze na koncie magazynu. Element DriveLog Version, wyświetlany w podsumowaniu dziennika błędów, będzie mieć wartość 2018-10-01. Formaty dziennika różnią się od tych opisanych w tym artykule.

Przeglądanie dzienników importu

Podczas importowania usługa Import/Export generuje pełny dziennik i dziennik kopiowania dla każdego dysku.

Pełny dziennik

Pełny dziennik jest opcjonalnym plikiem, który można włączyć podczas zamawiania. Jest to prosta lista wszystkich plików, które zostały pomyślnie zaimportowane z dysku. Pełny dziennik zawiera następujące informacje dla każdego pliku. Pełny dziennik nie zawiera informacji podsumowujących.

Pole opis
CloudFormat BlockBlob, PageBlob lub AzureFile.
Ścieżka Ścieżka do pliku na koncie magazynu.
Rozmiar Rozmiar pliku lub obiektu blob.
crc64 Cykliczna suma kontrolna kontroli nadmiarowości 64 (CRC64), która została użyta do weryfikowania integralności danych podczas transferu danych.

Przykładowy pełny dziennik: importowanie

Poniższy przykładowy pełny dziennik zawiera przykładowe wpisy plików dla blokowych obiektów blob, stronicowych obiektów blob i importów plików platformy 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>

Kopiuj dziennik

Dziennik kopiowania zawiera wpis błędu dla każdego pliku, który nie może zaimportować lub wyeksportować, ze szczegółami błędu. Dziennik kopiowania kończy się podsumowaniem błędów weryfikacji i kopiowania, które wystąpiły podczas transferu danych.

Każdy wpis błędu zawiera następujące informacje.

Pole opis
Ścieżka Udział docelowy w kontenerze lub udziale plików.
Kategoria Identyfikuje kategorię błędów. Aby uzyskać więcej informacji, zobacz Błędy transferu danych.
ErrorCode Kod liczbowy błędu.
ErrorMessage Opisuje błąd.

Podsumowanie na końcu dziennika (wyszukaj CopyLog Summary) zawiera następujące informacje:

  • Wersja dziennika dysku (w tym przypadku 2021-08-01)
  • Identyfikator dysku
  • Stan kopiowania danych
  • Podsumowanie błędów walidacji według kategorii błędów
  • Podsumowanie błędów kopiowania według kategorii błędów

Przykładowy dziennik kopiowania: importowanie

Poniższy przykład to dziennik kopiowania importu do usług Azure Files i Azure Blob Storage.

Ta kopia nie powiodła się, bez błędów walidacji, ale z trzema błędami kopiowania. Zmieniono nazwę jednego udziału plików (ShareRenamed błąd), a zmieniono nazwę dwóch kontenerów (ContainerRenamed błąd). Wpis błędu zawiera oryginalne i nowe nazwy plików.

<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>

Przeglądanie dzienników eksportu

Podczas eksportowania usługa Import/Export generuje pełny dziennik i dziennik kopiowania dla każdego transferu danych z usługi Azure Storage na dysk. Istnieje również plik manifestu, który jest zapisywany na dysku.

Pełny dziennik

Pełny dziennik eksportu to prosta lista wszystkich plików, które zostały pomyślnie wyeksportowane z konta usługi Azure Storage na dysk. Pełny dziennik zawiera następujące informacje dla każdego pliku. Pełny dziennik nie zawiera informacji podsumowujących.

Pole opis
CloudFormat BlockBlob, PageBlob lub AzureFile.
Etag Tag jednostki (ETag) dla zasobu, który jest używany do sprawdzania współbieżności podczas transferu danych.
Ścieżka Ścieżka do pliku na koncie magazynu.
Rozmiar Rozmiar pliku lub obiektu blob.
crc64 Cykliczna suma kontrolna kontroli nadmiarowości 64 (CRC64), która została obliczona podczas eksportowania danych na dysk.

Przykładowy pełny dziennik: eksportowanie

W poniższym przykładowym dzienniku pełnej zadanie eksportu pomyślnie przetransferował trzy obiekty blob z usługi Azure Blob Storage.

<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>

Kopiuj dziennik

Dziennik kopiowania dla eksportu zawiera wpis błędu dla każdego pliku, który nie może pomyślnie przenieść z usługi Azure Storage do dysku z szczegółami błędu. Dziennik kopiowania kończy się podsumowaniem błędów weryfikacji i kopiowania, które wystąpiły podczas transferu danych.

Dziennik kopiowania dla eksportu zgłasza problemy, takie jak transfer danych, który kończy się niepowodzeniem z powodu uszkodzonego dysku lub klucza konta magazynu, który zmienił się podczas transferu danych. Aby uzyskać listę problemów, zobacz Błędy transferu danych.

Przykładowy dziennik kopiowania: eksportowanie

Poniższy przykład to dziennik kopiowania eksportu, który napotkał trzy błędy systemu plików ( UploadErrorWin32), które spowodowały niepowodzenie eksportu trzech plików. Błąd 267 wskazuje, że nazwa katalogu jest nieprawidłowa. Błąd 123 wskazuje nieprawidłową nazwę pliku, nazwę katalogu lub składnię etykiety woluminu.

<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>

Błędy transferu danych

W dziennikach kopiowania dla zadań importu i/lub zadań eksportu znajdziesz następujące błędy.

Kategoria błędów Komunikat o błędzie Operacje importu Eksporty
UploadErrorWin32 Błąd systemu plików. Tak Tak
UploadErrorCloudHttp Nieobsługiwany typ obiektu blob. Aby uzyskać więcej informacji o błędach w tej kategorii, zobacz Podsumowanie błędów przekazywania. Tak Tak
UploadErrorDataValidationError CRC obliczone podczas pozyskiwania danych nie jest zgodne z CRC obliczonym podczas przekazywania. Tak Tak
UploadErrorManagedConversionError Rozmiar importowanego obiektu blob jest nieprawidłowy. Rozmiar obiektu blob to <bajty o rozmiarze> obiektu blob. Obsługiwane rozmiary to między 20971520 bajtami i 8192 GiB. Aby uzyskać więcej informacji, zobacz Podsumowanie błędów przekazywania. Tak Tak
UploadErrorUnknownType Nieznany błąd. Tak Tak
ContainerRenamed Zmieniono nazwę kontenera, ponieważ oryginalna nazwa kontenera nie jest zgodna z konwencjami nazewnictwa platformy Azure. Nazwa oryginalnego kontenera została zmieniona na DataBox-GUID<> z< oryginalnej nazwy> kontenera. Nie. Tak
ShareRenamed Zmieniono nazwę udziału, ponieważ oryginalna nazwa udziału nie jest zgodna z konwencjami nazewnictwa platformy Azure. Nazwa oryginalnego udziału została zmieniona na DataBox-GUID<> z <oryginalnej nazwy> folderu. Nie. Tak
BlobRenamed Zmieniono nazwę obiektu blob, ponieważ oryginalna nazwa obiektu blob nie jest zgodna z konwencjami nazewnictwa platformy Azure. Nazwa oryginalnego obiektu blob została zmieniona na BlockBlob/DataBox-GUID<> z< oryginalnej nazwy.> Nie. Tak
FileRenamed Zmieniono nazwę pliku, ponieważ oryginalna nazwa pliku nie jest zgodna z konwencjami nazewnictwa platformy Azure. Nazwa oryginalnego pliku została zmieniona na AzureFile/DataBox-GUID<> z <oryginalnej nazwy.> Nie. Tak
DiskRenamed Zmieniono nazwę pliku dysku zarządzanego, ponieważ oryginalna nazwa pliku nie jest zgodna z konwencjami nazewnictwa platformy Azure dla dysków zarządzanych. Nazwa oryginalnego pliku dysku zarządzanego została zmieniona na ManagedDisk/DataBox-GUID<> z< oryginalnej nazwy.> Nie. Tak
FileNameTrailsWithSlash Nazwa obiektu blob lub nazwa pliku kończy się ukośnikiem końcowym. Nie można wyeksportować nazwy obiektu blob lub nazwy pliku kończącego się ukośnikiem odwrotnym lub ukośnikiem do przodu. Nie. Tak
ExportCloudHttp Nieobsługiwany typ obiektu blob. Nie. Tak

Następne kroki