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

Este artigo descreve os problemas que você vê 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 na mesma conta de armazenamento que foi usada para carregar dados.

O log de cópia registra eventos de todas as operações de cópia que falharam entre o disco e a conta de Armazenamento do 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 localizar os logs de um upload de dados, execute as etapas a seguir.

Abra seu pedido no portal do Azure.

À 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ê optou por salvar logs detalhados quando fez o pedido, também verá o caminho para o log detalhado.

Captura de tela do painel Visão geral de um pedido do Data Box Disk com o status Copiar Concluído com Avisos. Um caminho de log de cópia e um caminho de log detalhado são realçados.

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

Se houver erros ao carregar os dados no Azure, Copy logs exibe um caminho para a pasta em que os logs de diagnóstico estão localizados.

Captura de tela do painel de Visão Geral de um pedido anterior do Data Box Disk com cópias concluídas. Os caminhos de log de cópia são destacados.

Os logs são carregados em um waies contêiner 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 de 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 a versão do log para obter mais informações.

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.
Selecione cada log e baixe 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.

Ilustração da seção Resumo de um log de cópia para um pedido do Data Box Disk. A versão do log do disco está destacada.

Exemplo de logs de upload

Os formatos de log de cópia/log de erros e log detalhado diferem 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.

Versão de log: 2021-08-01
Versão de log: 2018-10-01

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

Log detalhado de exemplo

O log detalhado de exemplo a seguir tem entradas de arquivo de exemplo 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>

Copiar log

O log de cópia contém uma entrada de erro para cada arquivo que não foi importado, com detalhes de 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 informações a seguir.

Campo	Description
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, confira Erros de upload de dados da Versão de log 2021-08-01.
ErrorCode	O código numérico do erro.
Mensagem de Erro	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

Exemplo de log de cópia

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

Esta 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 renomeado (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>

Na versão de log da unidade 2018-10-01, o carregamento de dados produz um log de erros e um log detalhado. Ambos os logs estão no mesmo formato e contêm descrições XML dos eventos que ocorreram durante a cópia dos dados do disco para a conta de Armazenamento do Azure.

O log detalhado contém a conclusão do status da operação de cópia para cada blob ou arquivo, enquanto o log de erros contém apenas as informações de blobs ou arquivos que tiveram erros durante o upload.

O log de erros tem a mesma estrutura como o log detalhado, mas filtra operações bem-sucedidas.

Log detalhado de exemplo

Um exemplo do _verbose.xml é mostrado aqui. Nesse caso, a ordem foi concluída com êxito sem erros.


<?xml version="1.0" encoding="utf-8"?>
<DriveLog Version="2018-10-01">
  <DriveId>184020D95632</DriveId>
  <Blob Status="Completed">
    <BlobPath>$root/botetapageblob.vhd</BlobPath>
    <FilePath>\PageBlob\botetapageblob.vhd</FilePath>
    <Length>1073742336</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <PageRangeList>
      <PageRange Offset="0" Length="4194304" Status="Completed" />
      <PageRange Offset="4194304" Length="4194304" Status="Completed" />
      <PageRange Offset="8388608" Length="4194304" Status="Completed" />
      --------CUT-------------------------------------------------------
      <PageRange Offset="1061158912" Length="4194304" Status="Completed" />
      <PageRange Offset="1065353216" Length="4194304" Status="Completed" />
      <PageRange Offset="1069547520" Length="4194304" Status="Completed" />
      <PageRange Offset="1073741824" Length="512" Status="Completed" />
    </PageRangeList>
  </Blob>
  <Blob Status="Completed">
    <BlobPath>$root/botetablockblob.txt</BlobPath>
    <FilePath>\BlockBlob\botetablockblob.txt</FilePath>
    <Length>19</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <BlockList>
      <Block Offset="0" Length="19" Status="Completed" />
    </BlockList>
  </Blob>
  <File Status="Completed">
    <FileStoragePath>botetaazurefilesfolder/botetaazurefiles.txt</FileStoragePath>
    <FilePath>\AzureFile\botetaazurefilesfolder\botetaazurefiles.txt</FilePath>
    <Length>20</Length>
    <ImportDisposition Status="Created">rename</ImportDisposition>
    <FileRangeList>
      <FileRange Offset="0" Length="20" Status="Completed" />
    </FileRangeList>
  </File>
  <Status>Completed</Status>
</DriveLog>

Logs de erros de exemplo

Para a mesma ordem, um exemplo do _error.xml é mostrado aqui.


<?xml version="1.0" encoding="utf-8"?>
<DriveLog Version="2018-10-01">
  <DriveId>184020D95632</DriveId>
  <Summary>
    <ValidationErrors>
      <None Count="3" />
    </ValidationErrors>
    <CopyErrors>
      <None Count="3" Description="No errors encountered" />
    </CopyErrors>
  </Summary>
  <Status>Completed</Status>
</DriveLog>

Um exemplo do _error.xml é mostrado aqui onde a ordem foi concluída com erros.

O arquivo de erro nesse caso tem uma Summary seção e outra seção que contém todos os erros no nível do arquivo.

O Summary contém o ValidationErrors e o CopyErrors. Nesse caso, oito arquivos ou pastas foram carregados no Azure e não houve erros de validação. Quando os dados foram copiados para a conta de Armazenamento do Azure, cinco arquivos ou pastas foram carregados com êxito. Os três arquivos ou pastas restantes foram renomeados de acordo com as convenções de nomenclatura de contêiner do Azure e carregados com êxito no Azure.

Os status de nível de arquivo estão dentro BlobStatus, o que descreve todas as ações tomadas para carregar os blobs. Nesse caso, três contêineres são renomeados porque as pastas para as quais os dados foram copiados não estão em conformidade com as convenções de nomenclatura do Azure para contêineres. Para os blobs carregados nesses contêineres, o novo nome do contêiner, o caminho do blob no Azure, o caminho de arquivo inválido original e o tamanho do blob estão incluídos.

 <?xml version="1.0" encoding="utf-8"?>
  <DriveLog Version="2018-10-01">
    <DriveId>18041C582D7E</DriveId>
    <Summary>
      <ValidationErrors>
        <None Count="8" />
      </ValidationErrors>
      <CopyErrors>
        <Completed Count="5" Description="No errors encountered" />
        <ContainerRenamed Count="3" Description="Renamed the container as the original container name does not follow Azure conventions." />
      </CopyErrors>
    </Summary>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/private.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\private.vhd</OriginalFilePath>
      <SizeInBytes>10490880</SizeInBytes>
    </Blob>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/resource.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\resource.vhd</OriginalFilePath>
      <SizeInBytes>71528448</SizeInBytes>
    </Blob>
    <Blob Status="ContainerRenamed">
      <BlobPath>databox-c2073fd1cc379d83e03d6b7acce23a6cf29d1eef/role.vhd</BlobPath>
      <OriginalFilePath>\PageBlob\pageblob test\role.vhd</OriginalFilePath>
      <SizeInBytes>10490880</SizeInBytes>
    </Blob>
    <Status>CompletedWithErrors</Status>
  </DriveLog>

Erros de upload 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.

Versão de log: 2021-08-01
Versão de log: 2018-10-01

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

Categoria de erro	Description
`UploadErrorWin32`	Erro do sistema de arquivos.
`UploadErrorCloudHttp`	Tipo de blob sem suporte. Para obter mais informações sobre erros nessa categoria, consulte Resumo dos erros de upload.
`UploadErrorDataValidationError`	O CRC computado durante a ingestão de dados não corresponde ao CRC computado durante o upload.
`UploadErrorManagedConversionError`	O tamanho do blob que está sendo importado é inválido. O tamanho do blob é <blob-size> bytes. Os tamanhos com suporte estão entre 20971520 Bytes e 8192 GiB. Para obter mais informações, consulte Resumo dos erros de upload.
`UploadErrorUnknownType`	Erro desconhecido.
`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 de <nome do contêiner original> para DataBox-<GUID>.
`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 de <nome original da pasta> para DataBox-<GUID>.
`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> a partir 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 de <nome original> para AzureFile/DataBox-<GUID>.
`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 sem suporte.

Os erros gerados ao carregar os dados no Azure são resumidos na tabela a seguir. Esse conjunto de erros é encontrado no log de erros 2018-10-01.

Código do erro	Description
`Renamed`	O blob foi renomeado com êxito.
`CompletedWithErrors`	Upload concluído com erros. Os detalhes dos arquivos em erro são incluídos no arquivo de log.
`Corrupted`	O CRC computado durante a ingestão de dados não corresponde ao CRC computado durante o upload.
`StorageRequestFailed`	Falha na solicitação de armazenamento do Azure.
`LeasePresent`	Este item é alugado e está sendo usado por outro usuário.
`StorageRequestForbidden`	Não foi possível carregar devido a problemas de autenticação.
`ManagedDiskCreationTerminalFailure`	Não foi possível carregar como discos gerenciados. Os arquivos estão disponíveis na conta de armazenamento de preparo como BLOBs de páginas. Você pode converter manualmente blobs de página em discos gerenciados.
`DiskConversionNotStartedTierInfoMissing`	Como o arquivo VHD foi copiado fora das pastas de camada pré-criadas, um disco gerenciado não foi criado. O arquivo é carregado como blob de páginas para a conta de armazenamento de preparo conforme especificado durante a criação do pedido. Você pode convertê-lo manualmente em um disco gerenciado.
`InvalidWorkitem`	Não foi possível carregar os dados, pois eles não estão em conformidade com convenções de nomenclatura e limites do Azure.
`InvalidPageBlobUploadAsBlockBlob`	Carregados como BLOBs de blocos em um contêiner com prefixo `databoxdisk-invalid-pb-`.
`InvalidAzureFileUploadAsBlockBlob`	Carregados como BLOBs de blocos em um contêiner com prefixo `databoxdisk-invalid-af`-.
`InvalidManagedDiskUploadAsBlockBlob`	Carregados como BLOBs de blocos em um contêiner com prefixo `databoxdisk-invalid-md`-.
`InvalidManagedDiskUploadAsPageBlob`	Carregados como BLOBs de blocos em um contêiner com prefixo `databoxdisk-invalid-md-`.
`MovedToOverflowShare`	Arquivos carregados em um novo compartilhamento, pois o tamanho do compartilhamento original excedeu o limite máximo de tamanho do Azure. O novo nome do compartilhamento de arquivos é o nome original sufixado com `-2`.
`MovedToDefaultAzureShare`	Arquivos carregados que não fazem parte de nenhuma pasta para um compartilhamento padrão. O nome do compartilhamento começa com `databox-`.
`ContainerRenamed`	O contêiner desses arquivos não estava em conformidade com as convenções de nomenclatura do Azure e foi renomeado. O novo nome começa com `databox-` e é sufixado com o hash SHA1 do nome original
`ShareRenamed`	O compartilhamento desses arquivos não está em conformidade com as convenções de nomenclatura do Azure e foi renomeado. O novo nome começa com `databox-` e é sufixado com o hash SHA1 do nome original.
`BlobRenamed`	Esses arquivos não estavam em conformidade com as convenções de nomenclatura do Azure e foram renomeados. Verifique o campo `BlobPath` para o novo nome.
`FileRenamed`	Esses arquivos não estavam em conformidade com as convenções de nomenclatura do Azure e foram renomeados. Verifique o campo `FileStoragePath` para o novo nome.
`DiskRenamed`	Esses arquivos não estavam em conformidade com as convenções de nomenclatura do Azure e foram renomeados. Verifique o campo `BlobPath` para o novo nome.

Próximas etapas

Entre em contato com o Suporte da Microsoft.

Comentários

Esta página foi útil?

Last updated on 2025-10-05

Compartilhar via

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

Sobre os logs de carregamento

Localizar os logs

Identificar a versão do log

Exemplo de logs de upload

Log detalhado

Log detalhado de exemplo

Copiar log

Exemplo de log de cópia

Erros de upload de dados

Próximas etapas

Comentários

Recursos adicionais