Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O AzCopy é um utilitário de linha de comando que você pode usar para copiar blobs ou arquivos de ou para uma conta de armazenamento. Este artigo ajuda você a usar logs para diagnosticar erros e depois usar arquivos de plano para retomar trabalhos. Este artigo também mostra como configurar arquivos de log e de plano alterando seu nível de verbosidade e o local padrão em que eles são armazenados.
Observação
Para obter conteúdo para ajudá-lo a começar a usar o AzCopy, consulte Introdução ao AzCopy. Este artigo se aplica ao AzCopy V10, já que esta é a versão com suporte do AzCopy no momento. Se você precisa usar uma versão anterior do AzCopy, consulte Usar a versão anterior do AzCopy.
Registrar e planejar arquivos
O AzCopy cria arquivos de log e de plano para cada trabalho. Você pode usar estes logs para investigar e solucionar problemas potenciais.
Os logs contêm o status da falha (UPLOADFAILEDe COPYFAILEDDOWNLOADFAILED), o caminho completo e o motivo da falha.
Por padrão, os arquivos de log e de plano estão localizados no diretório %USERPROFILE%\.azcopy no Windows, ou no diretório $HOME$\.azcopy no Mac e no Linux, mas você pode alterar o local, se desejar.
O erro pertinente não é necessariamente o primeiro erro que aparece no arquivo. Para erros como erros de rede, timeouts e erros de sobrecarga do servidor, o AzCopy realiza novas tentativas até 20 vezes e normalmente tem sucesso. O primeiro erro que você vê pode ser algo inofensivo que foi repetido com sucesso. Portanto, em vez de examinar o primeiro erro no arquivo, procure os erros que estão próximos de UPLOADFAILED, COPYFAILED ou DOWNLOADFAILED.
Importante
Ao enviar uma solicitação ao Suporte da Microsoft (ou solucionar problemas que envolve um terceiro), compartilhe a versão redigida do comando que quer executar. Essa versão garante que a SAS não seja compartilhada acidentalmente com ninguém. Você pode encontrar a versão editada no início do arquivo de log.
Examinar os logs em busca de erros
O comando a seguir obtém todos os erros com o status UPLOADFAILED do log 04dc9ca9-158f-7945-5933-564021086c79:
Exibir e retomar trabalhos
Cada operação de transferência cria uma tarefa do AzCopy. Use o seguinte comando para ver o histórico de trabalhos:
azcopy jobs list
Para exibir as estatísticas de trabalho, use o seguinte comando:
azcopy jobs show <job-id>
Para filtrar as transferências por status, use o seguinte comando:
azcopy jobs show <job-id> --with-status=Failed
Dica
O valor do sinalizador --with-status é sensível para diferenciar maiúsculas de minúsculas.
Use o comando a seguir para retomar um trabalho com falha ou cancelado. Esse comando usa o identificador de trabalho junto com o token SAS, pois ele não é persistente por motivos de segurança:
azcopy jobs resume <job-id> --source-sas="<sas-token>" --destination-sas="<sas-token>"
Dica
Coloque argumentos de caminho, como o token SAS, entre aspas simples (''). Use aspas simples em todos os shells de comando, exceto pelo shell de comando do Windows (cmd.exe). Se você estiver usando um shell de comando do Windows (cmd.exe), coloque os argumentos de caminho entre aspas duplas ("") em vez de aspas simples ('').
Quando você retoma um trabalho, o AzCopy analisa o arquivo de plano de trabalho. O arquivo de plano lista todos os arquivos identificados para processamento quando o trabalho foi criado pela primeira vez. Quando você retoma um trabalho, o AzCopy tenta transferir todos os arquivos listados no arquivo de plano e que ainda não foram transferidos.
Mudar a localização dos arquivos do plano
Use o seguinte comando:
Mudar a localização dos arquivos de log
Use o seguinte comando:
Alterar o nível de log padrão
Por padrão, o AzCopy define o nível de log como INFO. Para reduzir a verbosidade de log e economizar espaço em disco, use a opção --log-level para substituir essa configuração.
Os níveis de log disponíveis são: DEBUG, INFO, WARNING, ERROR e NONE.
Remover arquivos de plano e de log
Para remover todos os arquivos de plano e de log do computador local e economizar espaço em disco, use o azcopy jobs clean comando.
Para remover os arquivos de planejamento e de log de apenas um trabalho, use azcopy jobs rm <job-id>. Substitua o espaço reservado <job-id> neste exemplo pela ID do trabalho.