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

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 Data Box Disk são carregados no datacenter do Azure, um registo de cópia/erro e um registo 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 que falharam entre o disco e a conta de Armazenamento 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.

Localizar os registos

Para localizar os logs de um upload de dados, siga 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 optaste por salvar logs detalhados quando fizeste o teu pedido, também verás o caminho para o log detalhado.

Captura de tela do painel Visão geral de uma ordem de disco do Data Box com o status Cópia concluída 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 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	< nome-da-conta-de-armazenamento>/databoxcopylog/<order-name>_<device-serial-number>_CopyLog_<job-ID>.xml
log detalhado	< nome-da-conta-de-armazenamento>/databoxcopylog/<order-name>_<device-serial-number>_VerboseLog_<job-ID>.xml

Para os seus pedidos anteriores, o ecrã pode assemelhar-se ao seguinte exemplo.

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.

Captura de ecrã do painel de visão geral de uma encomenda anterior do Data Box Disk com cópias concluídas. Os caminhos dos registos de cópia estão realçados.

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	< nome-da-conta-de-armazenamento>/databoxlogs-<order-name>/waies/ri-<order-name>-guid_<drive-ID>_<timestamp>_error.xml
log detalhado	< nome da conta de armazenamento>/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 waies contêiner. Para obter ajuda com a interpretação dos logs, use as instruções para a versão do log de disco associado. 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

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 (_copy.xml) ou um log de erros (_error.xml), dependendo da liberação da unidade.

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

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

A ilustração a seguir mostra 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 uma ordem de disco do Data Box. A versão Drive Log está realçada.

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.

Versão do registo: 2021-08-01
Versão do registo: 2018-10-01

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 registo detalhado é um ficheiro opcional que pode ser ativado durante a encomenda. É 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 seguinte log de exemplo detalhado inclui entradas de arquivo para blobs de bloco, blobs de página e importações de 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 registo

O log de cópia contém uma entrada de erro para cada arquivo que falhou na importação, 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ódigo de erro	O código numérico para o erro.
Mensagem de Erro	Descreve o erro.

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

Versão do registo da unidade (neste caso, 2021-08-01)
ID do disco
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 os Azure Files e o Azure Blob Storage.

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>

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 ao copiar os dados do disco para a conta de Armazenamento do Azure.

O log verbose contém informações completas sobre o status da operação de cópia para cada blob ou ficheiro, enquanto o log de erros contém apenas as informações para blobs ou ficheiros que encontraram erros durante o upload.

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

Exemplo de log detalhado

Uma amostra do _verbose.xml é mostrada aqui. Neste caso, a encomenda foi concluída com sucesso 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>

Exemplos de logs de erros

Para a mesma ordem, uma amostra do _error.xml é mostrada 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>

Uma amostra do _error.xml é mostrada aqui onde o pedido foi concluído com erros.

O arquivo de erro, neste caso, tem uma Summary seção e outra seção que contém todos os erros de nível de 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, em seguida, carregados com êxito no Azure.

Os status de nível de arquivo estão em BlobStatus, 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 estavam 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 do 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 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.

Versão do registo: 2021-08-01
Versão do registo: 2018-10-01

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

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 de 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`	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 para <> do nome <do >.
`ShareRenamed`	Renomeado o compartilhamento porque o nome do compartilhamento original não segue as convenções de nomenclatura do Azure. A partilha original foi renomeada de <nome da pasta original> para <DataBox-GUID>.
`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 de <nome> original para <BlockBlob/DataBox-GUID>.
`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 do <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/<> do <nome> original.
`ExportCloudHttp`	Tipo de blob não suportado.

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

Código de erro	Descrição
`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 calculado durante a ingestão de dados não corresponde ao CRC calculado 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 ficheiros estão disponíveis na conta de armazenamento de pré-produção como blobs de página. 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 ficheiro é carregado como blob de página para a conta de armazenamento intermédio, 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 as convenções de nomenclatura e limites do Azure.
`InvalidPageBlobUploadAsBlockBlob`	Carregado como blocos de bloco em um contentor com prefixo `databoxdisk-invalid-pb-`.
`InvalidAzureFileUploadAsBlockBlob`	Carregado como blocos de dados em um contentor com prefixo `databoxdisk-invalid-af`-.
`InvalidManagedDiskUploadAsBlockBlob`	Carregado como blocos de dados em um contentor com prefixo `databoxdisk-invalid-md`-.
`InvalidManagedDiskUploadAsPageBlob`	Carregado como blobs de página num contentor com o prefixo `databoxdisk-invalid-md-`.
`MovedToOverflowShare`	Os ficheiros foram carregados para uma nova partilha porque o tamanho da partilha original excedia o limite de tamanho máximo do Azure. O novo nome de compartilhamento de arquivos tem o nome original com o sufixo `-2`.
`MovedToDefaultAzureShare`	Carregaram arquivos que não faziam parte de nenhuma pasta para um compartilhamento padrão. O nome do compartilhamento começa com `databox-`.
`ContainerRenamed`	O contêiner para esses arquivos não estava em conformidade com as convenções de nomenclatura do Azure e é renomeado. O novo nome começa com `databox-` e é sufixado por o hash SHA1 do nome original
`ShareRenamed`	O compartilhamento desses arquivos não estava em conformidade com as convenções de nomenclatura do Azure e é 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 para o novo nome `BlobPath`.
`FileRenamed`	Esses arquivos não estavam em conformidade com as convenções de nomenclatura do Azure e foram renomeados. Verifique o campo para o novo nome `FileStoragePath`.
`DiskRenamed`	Esses arquivos não estavam em conformidade com as convenções de nomenclatura do Azure e foram renomeados. Verifique o campo para o novo nome `BlobPath`.

Próximos passos

Entre em contato com o Suporte da Microsoft.

Feedback

Esta página foi útil?

Last updated on 2025-10-02

Partilhar via

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

Sobre os logs de upload

Localizar os registos

Identificar a versão do log

Exemplos de logs de upload

Registo verboso

Exemplo de log detalhado

Copiar registo

Exemplo de log de cópia

Erros de carregamento de dados

Próximos passos

Feedback

Recursos adicionais