Partilhar via

Usar logs para solucionar problemas de importações e exportações por meio do Azure Import/Export

  • 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 Azure. O log de cópia termina com um resumo dos 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.

Localize os logs

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

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

  1. Inicie sessão no portal do Azure.

  2. Caixa de dados azure.

    Captura de ecrã a mostrar como procurar trabalhos do Data Box no portal do Azure. A caixa Pesquisar e o serviço Azure Data Box selecionado são realçados.

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

    Captura de ecrã a mostrar como filtrar recursos da Caixa de Dados no portal do Azure para mostrar trabalhos de Importação/Exportação. A caixa Pesquisar está realçada.

    Uma lista de trabalhos de Importação/Exportação aparece na página.

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

  4. Exiba os detalhes do trabalho selecionando um nome de trabalho.

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

    • Se você tiver acesso à conta de armazenamento, poderá selecionar um caminho de log de cópia ou um caminho de log detalhado para exibir o log.

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

    Captura de ecrã da Descrição Geral de um trabalho de Importação de Exportação no portal do Azure. O Status do pedido, o Status da cópia de dados e as URLs de log de uma unidade são realçados.

Um log de cópia é salvo automaticamente. Se você optar por salvar logs detalhados quando fez seu 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 blob) ou compartilhamento (para importações para Arquivos do Azure) na conta de armazenamento. É atribuído o nome databoxcopylog ao contentor. Os URLs têm estes formatos:

Tipo de log Formato do URL
Copiar registo <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 quando criou o pedido, também há um log detalhado na mesma pasta.

Nota

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

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

Registo verboso

O log detalhado é um arquivo opcional que você pode ativar durante o pedido. É 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 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.

Exemplo de log detalhado: importação

O log detalhado de exemplo a seguir tem entradas de arquivo de exemplo para blob de bloco, blob de página e importações de Arquivo 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>

Copiar registo

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 validação e cópia que ocorreram durante a transferência de dados.

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

Campo Descrição
Caminho O compartilhamento de destino dentro do contêiner ou compartilhamento de arquivos.
Categoria Identifica a categoria de erro. Para obter mais informações, consulte Erros de transferência de dados.
CódigoDoErro O código numérico para o 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 (neste caso, 2021-08-01)
  • ID da unidade
  • Estado da cópia dos dados
  • Resumo dos erros de validação por categoria de erro
  • Resumo dos erros de cópia por categoria de erro

Exemplo de log de cópia: importação

O exemplo a seguir é um log de cópia para uma importação para Arquivos do Azure e armazenamento de Blob do Azure.

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

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

Revisar logs de exportação

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

Registo verboso

O log detalhado para uma exportação é uma listagem 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 A marca de entidade (ETag) para o 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 blob.
CRC64 A soma de verificação de redundância cíclica 64 (CRC64) que foi calculada durante a exportação de dados para o disco.

Exemplo de log detalhado: exportação

No log detalhado de exemplo 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>

Copiar registo

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

O log de cópia de 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 obter uma lista de problemas, consulte Erros de transferência de dados.

Exemplo de log de cópia: exportação

O exemplo a seguir é um log de cópia para uma exportação que encontrou 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 incorreto, nome de diretório ou sintaxe de rótulo de volume.

<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 na transferência de dados

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

Categoria de erro Mensagem de Erro Importações Exportações
UploadErrorWin32 Erro do sistema de arquivos. Sim Sim
UploadErrorCloudHttp Tipo de blob não suportado. Para obter mais informações sobre erros nesta categoria, consulte Resumo de erros de carregamento. Sim Sim
UploadErrorDataValidationError O CRC calculado durante a ingestão de dados não corresponde ao CRC calculado durante o upload. Sim Sim
UploadErrorManagedConversionError O tamanho do blob que está sendo importado é inválido. O tamanho do blob é <bytes de tamanho> blob. Os tamanhos suportados estão entre 20971520 bytes e 8192 GiB. Para obter mais informações, consulte Resumo dos erros de carregamento. Sim Sim
UploadErrorUnknownType Uma margem de erro desconhecida. Sim Sim
ContainerRenamed Renomeado o contêiner 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 Renomeado o compartilhamento 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> da <pasta original. Não Sim
BlobRenamed Renomeado o blob 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> original. Não Sim
FileRenamed Renomeado o arquivo 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> original. Não Sim
DiskRenamed Renomeado o arquivo de disco gerenciado 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 para ManagedDisk/DataBox-GUID<> do< nome> original. 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 termina com uma barra invertida ou barra frontal não pode ser exportado para o disco. Não Sim
ExportCloudHttp Tipo de blob não suportado. Não Sim

Próximos passos