Usar logs para solucionar problemas de importações e exportações por meio do serviço de Importação/Exportação do Microsoft Azure

  • Artigo

Quando o serviço de Importação/Exportação do Microsoft Azure processa as unidades para um trabalho de importação ou exportação, o serviço grava logs de cópia e logs detalhados na conta de armazenamento que você usou. Ambos os logs são salvos para cada unidade.

  • O log de cópia relata eventos para todas as operações de cópia com falha entre o disco e a conta de Armazenamento do Microsoft Azure. O log de cópia termina com um resumo de erros por categoria de erro.

  • O log detalhado tem uma lista de todas as operações de cópia que foram bem-sucedidas em cada blob e arquivo.

Localizar os logs

Ao usar o serviço de Importação/Exportação para criar um trabalho de importação ou exportação no Azure Data Box, você exibirá o trabalho de Importação/Exportação junto com os outros recursos do Data Box.

Use as etapas a seguir para descobrir o status das cópias de dados para um trabalho de Importação/Exportação:

  1. Entre no portal do Azure.

  2. Pesquise o Azure Data Box.

    Captura de tela mostrando como pesquisar trabalhos do Data Box no portal do Azure. A caixa Pesquisar e o serviço Azure Data Box estão realçados.

  3. Para filtrar para trabalhos de Importação/Exportação do Azure, insira "Importação/Exportação" na caixa de pesquisa.

    Captura de tela mostrando como filtrar os recursos do Data Box no portal do Azure para mostrar trabalhos de Importação/Exportação. A Caixa Pesquisar é realçada.

    Uma lista dos seus trabalhos de Importação/Exportação será exibida na página.

    Captura de tela dos recursos do Data Box no portal do Azure filtrados para trabalhos de Importação/Exportação. O nome do trabalho, tipo de transferência, status e modelo estão realçados.

  4. Visualize detalhes do trabalho selecionando um nome de trabalho.

    O Status atual do pedido e os Detalhes da cópia de dados do trabalho selecionado são exibidos para cada unidade.

    • Se você tiver acesso à conta de armazenamento, poderá selecionar um Copiar caminho de log ou Caminho de log detalhado para ver o log.

    • Selecione uma ID da Unidade para abrir um painel com informações de cópia completas, incluindo o arquivo de manifesto e o hash.

    Captura de tela da Visão geral de um trabalho de Importação/Exportação no portal do Azure. O Status do Pedido, o Status de Cópia dos Dados e as URLs de Log para uma unidade estão realçados.

Um log de cópia é salvo automaticamente. Se optar por salvar logs detalhados ao fazer o pedido, você também verá o caminho para o log detalhado.

Os logs são carregados em um contêiner (para importações e exportações de blobs) ou compartilhamento (para importações para Arquivos do Azure) na conta de armazenamento. O contêiner é denominado databoxcopylog. As URLs têm estes formatos:

Tipo de log Formato de URL
log de cópia <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_CopyLog_<job-ID>.xml
log detalhado <storage-account-name>/databoxcopylog/<order-name>_<device-serial-number>_VerboseLog_<job-ID>.xml

Para trabalhos de exportação, um arquivo de manifesto também é salvo no disco.

Cada transferência de dados para um disco gera um log de cópia. Se você optar por salvar um log detalhado ao criar o pedido, também haverá um log detalhado na mesma pasta.

Observação

Para seus pedidos anteriores, você pode encontrar um log de erros (_error.xml) junto com o log detalhado em um contêiner waies na conta de armazenamento. O DriveLog Version, mostrado no resume do log de erros, será 2018-10-01. Os formatos de log diferem daqueles descritos neste artigo.

Examinar logs de importação

Durante uma importação, o serviço de Importação/Exportação gera um log detalhado e um log de cópia para cada disco.

Log detalhado

O log detalhado é um arquivo opcional que você pode habilitar durante a ordenação. É uma lista simples de todos os arquivos que foram importados com êxito da unidade. O log detalhado fornece as seguintes informações para cada arquivo. O log detalhado não fornece informações resumidas.

Campo Descrição
CloudFormat BlockBlob, PageBlob ou AzureFile.
Caminho Caminho para o arquivo dentro da conta de armazenamento.
Tamanho Tamanho do arquivo ou do blob.
crc64 A soma de verificação de redundância cíclica 64 (CRC64) que foi usada para verificar a integridade dos dados durante a transferência de dados.

Log detalhado de amostra: importar

O log detalhado de amostra a seguir tem entradas de arquivo de amostra para importações de blob de blocos, blob de páginas e Arquivos do 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>

Log de cópia

O log de cópia contém uma entrada de erro para cada arquivo que falhou ao importar ou exportar, com detalhes do erro. O log de cópia termina com um resumo dos erros de cópia e validação que ocorreram durante a transferência de dados.

Cada entrada de erro contém as seguintes informações.

Campo Descrição
Caminho Compartilhamento de destino dentro do contêiner ou do compartilhamento de arquivo.
Categoria Identifica a categoria de erro. Para obter mais informações, consulte Erros de transferência de dados.
ErrorCode O código numérico do erro.
ErrorMessage Descreve o erro.

O resumo no final do log (procure CopyLog Summary) fornece as seguintes informações:

  • Versão do log da unidade (nesse caso, 2021-08-01)
  • ID da Unidade
  • Status da cópia de dados
  • Resumo dos erros de validação por categoria de erro
  • Resumo dos erros de cópia por categoria de erro

Log de cópia de amostra: importar

O exemplo a seguir é um log de cópia de uma importação dos Arquivos do Azure e o Armazenamento de Blobs do Azure.

Essa cópia falhou, sem erros de validação, mas com três erros de cópia. Um compartilhamento de arquivo foi renomeado (ShareRenamed erro) e dois contêineres foram renomeados (ContainerRenamed erro). A entrada de erro fornece os nomes de arquivo originais e novos.

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

Examinar logs de exportação

Durante uma exportação, o serviço de Importação/Exportação gera um log detalhado e um log de cópia para cada transferência de dados do Armazenamento do Microsoft Azure para um disco. Há também um arquivo de manifesto, que é salvo no disco.

Log detalhado

O log detalhado para uma exportação é uma lista simples de todos os arquivos que foram exportados com êxito da conta de armazenamento do Azure para a unidade. O log detalhado fornece as seguintes informações para cada arquivo. O log detalhado não fornece informações resumidas.

Campo Descrição
CloudFormat BlockBlob, PageBlob ou AzureFile.
Etag ETag (marca da entidade) do recurso, que é usada para verificação de simultaneidade durante a transferência de dados.
Caminho Caminho para o arquivo dentro da conta de armazenamento.
Tamanho Tamanho do arquivo ou do blob.
crc64 Soma de verificação da CRC64 (verificação de redundância cíclica 64) que foi calculada durante a exportação de dados para o disco.

Log detalhado de amostra: exportar

No log detalhado de amostra a seguir, o trabalho de exportação transferiu com êxito três blobs do armazenamento de blobs do Azure.

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

Log de cópia

O log de cópia de uma exportação contém uma entrada de erro para cada arquivo que falhou ao ser transferido com êxito do Armazenamento do Microsoft Azure para o disco, com detalhes do erro. O log de cópia termina com um resumo dos erros de cópia e validação que ocorreram durante a transferência de dados.

O log de cópia para uma exportação relata problemas como uma transferência de dados que falha devido a uma unidade danificada ou uma chave de conta de armazenamento que foi alterada durante a transferência de dados. Para ver uma lista de problemas, consulte Erros de transferência de dados.

Log de cópia de amostra: exportar

A amostra a seguir é um log de cópia para uma exportação que teve três erros do sistema de arquivos (UploadErrorWin32) que causaram a falha na exportação de três arquivos. O erro 267 indica que o nome do diretório é inválido. O erro 123 indica um nome de arquivo, nome de diretório ou sintaxe de rótulo de volume incorreto.

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

Erros de transferência de dados

Você encontrará os seguintes erros nos logs de cópia para trabalhos de importação e/ou exportação.

Categoria do erro Mensagem de erro Importações Exportações
UploadErrorWin32 Erro do sistema de arquivos. Sim Yes
UploadErrorCloudHttp Tipos de blob sem suporte. Para obter mais informações sobre erros nessa categoria, confira Resumo de erros de upload. Sim Yes
UploadErrorDataValidationError A CRC computada durante a ingestão de dados não corresponde à CRC computada durante o carregamento. Sim Yes
UploadErrorManagedConversionError O tamanho do blob que está sendo importado é inválido. O tamanho do blob é <blob-size> bytes. Os tamanhos aceitos estão entre 20971520 bytes e 8192 GiB. Para obter mais informações, confira Resumo de erros de upload. Sim Yes
UploadErrorUnknownType Erro desconhecido. Sim Yes
ContainerRenamed O contêiner foi renomeado porque o nome do contêiner original não segue as convenções de nomenclatura do Azure. O contêiner original foi renomeado para DataBox-<GUID> do <nome do contêiner original>. Não Sim
ShareRenamed O compartilhamento foi renomeado porque o nome do compartilhamento original não segue as convenções de nomenclatura do Azure. O compartilhamento original foi renomeado para DataBox-<GUID> do <nome do compartilhamento original>. Não Sim
BlobRenamed O blob foi renomeado porque o nome do blob original não segue as convenções de nomenclatura do Azure. O blob original foi renomeado para BlockBlob/DataBox-<GUID> do <nome do compartilhamento original>. Não Sim
FileRenamed O arquivo foi renomeado porque o nome do arquivo original não segue as convenções de nomenclatura do Azure. O arquivo original foi renomeado para AzureFile/DataBox-<GUID> do <nome do compartilhamento original>. Não Sim
DiskRenamed O arquivo de disco gerenciado foi renomeado porque o nome do arquivo original não segue as convenções de nomenclatura do Azure para discos gerenciados. O arquivo de disco gerenciado original foi renomeado do <nome original>. para ManagedDisk/DataBox-<GUID>. Não Sim
FileNameTrailsWithSlash O nome do blob ou o nome do arquivo termina com uma barra à direita. Um nome de blob ou nome de arquivo que termine com uma barra à direita ou uma barra à direita não pode ser exportado para o disco. Não Sim
ExportCloudHttp Tipos de blob sem suporte. Não Sim

Próximas etapas