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

  • Artigo

Este artigo descreve os problemas encontrados ao carregar dados no datacenter do Azure usando o Azure Data Box Disk.

Sobre os logs de carregamento

Quando os dados de um Data Box Disk 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 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

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

  1. Abra o pedido no portal do Azure.

  2. À medida que o upload 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 são parecidos com os da tela a seguir. 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.

      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 nos 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 os pedidos anteriores, a exibição pode ser semelhante à tela a seguir.

      Se houver erros ao carregar os dados no Azure, a ação Copiar logs exibirá um caminho para a pasta em que 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 contêiner waies na conta de armazenamento. As URLs têm estes formatos:

      Tipo de log Formato de URL
      log 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

    Observação

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

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

    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 faça o download de uma cópia local.

Identificar a versão do log

Há duas versões do log de cópia/erro e o 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 (_copy.xml) ou um log de erros (_error.xml), dependendo da versão da unidade.

Para descobrir a versão do log de cópia/erro e do 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 da unidade
_copy.xml DriveLogVersion 01/08/2021
_error.xml Versão do DriveLog 01-10-2018

A ilustração a seguir mostra o DriveLogVersion na 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.

Logs de upload de exemplo

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

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

Log detalhado

O log detalhado é um arquivo opcional que você pode habilitar durante a ordenação. É uma listagem simples de todos os arquivos da unidade que foram importados com êxito, com as informações a seguir 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 exemplo

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 não foi importado, com detalhes do erro. O log de cópia termina com um resumo dos erros de validação e de cópia que ocorreram durante a importação.

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 Uma das 15 categorias de erro. Para obter mais informações, confira Erros de upload de dados da Versão de log 2021-08-01.
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 exemplo

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>

Erros de upload de dados

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

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

Categoria do erro Descrição
UploadErrorWin32 Erro do sistema de arquivos.
UploadErrorCloudHttp Tipos de blob sem suporte. Para obter mais informações sobre erros nessa categoria, confira Resumo de erros de upload.
UploadErrorDataValidationError A CRC computada durante a ingestão de dados não corresponde à CRC computada durante o carregamento.
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.
UploadErrorUnknownType Erro desconhecido.
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>.
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>.
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>.
FileRenamed O arquivo foi renomeado porque o nome do arquivo original não segue as convenções de nomenclatura do Azure. O blob original foi renomeado de <nome original> para AzureFile/DataBox-<GUID>.
DiskRenamed O arquivo de disco gerenciado foi renomeado porque o nome do arquivo original não segue as convenções de nomenclatura do Azure. O arquivo de disco gerenciado original foi renomeado do <nome original>. para ManagedDisk/DataBox-<GUID>.
ExportCloudHttp Tipos de blob sem suporte.

Próximas etapas

Entre em contato com o Suporte da Microsoft.