Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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, em seguida, usar arquivos de plano para retomar trabalhos. Este artigo também mostra como configurar arquivos de log e planejamento alterando seu nível de detalhamento e o local padrão onde eles estã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 aplica-se ao AzCopy V10 , pois esta é a versão atualmente suportada do AzCopy. Se você precisar usar uma versão anterior do AzCopy, consulte Usar a versão anterior do AzCopy.
Ficheiros de registo e de plano
O AzCopy cria arquivos de log e planejamento para cada trabalho. Pode utilizar os registos para investigar e resolver os possíveis problemas.
Os logs contêm o status da falha (UPLOADFAILED, COPYFAILED, e DOWNLOADFAILED), o caminho completo e o motivo da falha.
Por predefinição, os ficheiros de registo e de plano estão localizados no diretório %USERPROFILE%\.azcopy no Windows ou $HOME$\.azcopy no Mac e Linux, mas poderá alterar essa localização.
O erro relevante não é necessariamente o primeiro erro que aparece no arquivo. Para erros como erros de rede, tempos limite e erros de servidor ocupado, o AzCopy tenta novamente até 20 vezes e, geralmente, o processo de repetição é bem-sucedido. O primeiro erro que você vê pode ser algo inofensivo que foi repetido com sucesso. Então, em vez de olhar para o primeiro erro no arquivo, procure os erros que estão perto de UPLOADFAILED, de COPYFAILED ou de DOWNLOADFAILED.
Importante
Ao enviar uma solicitação ao Suporte da Microsoft (ou solucionar o problema envolvendo terceiros), compartilhe a versão editada do comando que você deseja executar. Esta versão garante que o SAS não é acidentalmente partilhado com ninguém. Pode encontrar a versão redigida no início do ficheiro de registo.
Verificar a existência de erros nos registos
O comando a seguir obtém todos os erros com UPLOADFAILED status do 04dc9ca9-158f-7945-5933-564021086c79 log:
Select-String UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
Visualizar e retomar trabalhos
Cada operação de transferência cria um trabalho AzCopy. Utilize 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 estado, utilize o seguinte comando:
azcopy jobs show <job-id> --with-status=Failed
Sugestão
O valor da --with-status bandeira é sensível a maiúsculas e minúsculas.
Use o comando a seguir para retomar um trabalho com falha ou cancelado. Este comando usa o identificador de tarefa 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>"
Sugestão
Coloque argumentos de caminho, como o token SAS, entre aspas simples (''). Use aspas simples em todos os shells de comando, exceto no Shell de Comando do Windows (cmd.exe). Se você estiver usando um Shell de Comando do Windows (cmd.exe), coloque argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').
Quando você retoma um trabalho, o AzCopy examina o arquivo de plano de trabalho. O arquivo de plano lista todos os arquivos que foram 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.
Alterar a localização dos ficheiros de plano
Use o seguinte comando.
export AZCOPY_JOB_PLAN_LOCATION=<value>
Alterar a localização dos ficheiros de registo
Use o seguinte comando.
export AZCOPY_LOG_LOCATION=<value>
Alterar o nível de log padrão
Por padrão, AzCopy define o nível de log como INFO. Para reduzir a verbosidade do 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, ERRORe NONE.
Remover ficheiros de plano e de registo
Para remover todos os arquivos de plano e log da máquina local e economizar espaço em disco, use o azcopy jobs clean comando.
Para remover apenas os arquivos de plano e log de um trabalho, use azcopy jobs rm <job-id>. Substitua o marcador de posição <job-id> neste exemplo pelo ID do trabalho.