Usar logs para solucionar problemas de carregamento no Azure Data Box Disk

  • Artigo

Este artigo descreve os problemas que você vê quando carrega dados no datacenter do Azure usando o Azure Data Box Disk.

Sobre os logs de upload

Quando os dados de um disco Data Box são carregados no datacenter do Azure, um log de cópia/erro e um log detalhado são gerados para cada conta de armazenamento. Esses logs são carregados para a mesma conta de armazenamento que foi usada para carregar dados.

  • 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

Para localizar os logs de um upload de dados, siga as etapas a seguir.

  1. Abra seu pedido no portal do Azure.

  2. À medida que o carregamento de dados é concluído para cada disco, o painel Visão geral exibe o status do disco e os caminhos para os logs de diagnóstico do disco.

    • Para novos pedidos, os detalhes do disco se parecem com os da tela a seguir. 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.

      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.

      Os logs são carregados em um contêiner (para importaçõ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 seus pedidos anteriores, a exibição pode se parecer com a tela a seguir.

      Se houver algum erro ao carregar os dados no Azure, Copiar logs exibirá um caminho para a pasta onde os logs de diagnóstico estão localizados.

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

      Os logs são carregados em um waies contêiner na conta de armazenamento. Os URLs têm estes formatos:

      Tipo de log Formato do URL
      registo de erros <storage-account-name/databoxlogs-order-name/waies/ri-order-name-guid_><><><drive-ID>_<timestamp_error.xml>
      log detalhado <storage-account-name/databoxlogs-order-name/waies/ri-order-name-guid_><><><drive-ID>_<timestamp_verbose.xml>

    Nota

    Os logs no contêiner databoxcopylog têm um formato diferente dos logs no waies contêiner. Para obter ajuda na interpretação dos logs, use as instruções para a versão do log de unidade associada. Consulte Identificar versão do log para obter mais informações.

  3. Para exibir os logs, abra o contêiner que armazena os logs em sua conta de armazenamento. A ilustração a seguir mostra os logs em um waies contêiner.

    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. Selecione cada log e baixe uma cópia local.

Identificar a versão do log

Existem duas versões do log de cópia/erro e do log detalhado, com formatos diferentes. As versões de log são discutidas separadamente nas seções a seguir.

Junto com o log detalhado, você verá um log de cópia () ou um log de erros (_copy.xml_error.xml), dependendo da liberação da unidade.

Para descobrir a liberação de log para o log de cópia/erro e o log detalhado que o acompanha, verifique a versão do log da unidade no log de cópia/erro.

Nome do arquivo de log Campo Versão do log do drive
_copy.xml DriveLogVersão 2021-08-01
_error.xml Versão DriveLog 2018-10-01

A ilustração a seguir mostra a DriveLogVersion seção de resumo de um log de cópia.

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

Exemplos de logs de upload

Os formatos de log de cópia/log de erros e log detalhado diferem para as duas versões de log. Se você não tiver certeza de qual versão dos logs você tem, consulte Identificar a versão do log.

Cada transferência de dados para um disco gera um log de cópia. Se você optou por salvar um log detalhado quando fez seu pedido, também há um log detalhado na mesma pasta.

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

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, 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 importação.

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 Uma das 15 categorias de erro. Para obter mais informações, consulte Erros de carregamento de dados para a versão de log 2021-08-01.
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

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 (erro) e dois contêineres foram renomeados (ShareRenamedContainerRenamederro). 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>

Erros de carregamento de dados

Os erros relatados nos logs variam ligeiramente nas duas versões de log. Se você não tiver certeza de qual versão dos logs você tem, consulte Identificar a versão do log.

Os erros encontrados no log de cópia 2018-10-01 são descritos abaixo.

Categoria de erro Descrição
UploadErrorWin32 Erro do sistema de arquivos.
UploadErrorCloudHttp Tipo de blob não suportado. Para obter mais informações sobre erros nesta categoria, consulte Resumo dos erros de carregamento.
UploadErrorDataValidationError O CRC calculado durante a ingestão de dados não corresponde ao CRC calculado durante o upload.
UploadErrorManagedConversionError O tamanho do blob que está sendo importado é inválido. O tamanho do blob é <blob-size> bytes. Os tamanhos suportados estão entre 20971520 bytes e 8192 GiB. Para obter mais informações, consulte Resumo dos erros de carregamento.
UploadErrorUnknownType Uma margem de erro desconhecida.
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.
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.
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.
FileRenamed Renomeado o arquivo porque o nome do arquivo original não segue as convenções de nomenclatura do Azure. O blob original foi renomeado para AzureFile/DataBox-GUID<> do< nome> original.
DiskRenamed Renomeado o arquivo de disco gerenciado porque o nome do arquivo original não segue as convenções de nomenclatura do Azure. O arquivo de disco gerenciado original foi renomeado para ManagedDisk/DataBox-GUID<> do< nome> original.
ExportCloudHttp Tipo de blob não suportado.

Próximos passos

Entre em contato com o Suporte da Microsoft.