Trovare gli errori e riprendere i processi usando i file di log e di piano in AzCopy
AzCopy è un'utilità della riga di comando che è possibile usare per copiare i BLOB o i file da e verso un account di archiviazione. Questo articolo illustra come usare i log per diagnosticare gli errori e quindi usare i file di piano per riprendere i processi. Questo articolo illustra anche come configurare i file di log e di piano modificando il livello di dettaglio e il percorso predefinito in cui sono archiviati.
Nota
Se si sta cercando contenuto per iniziare a usare AzCopy, vedere Introduzione ad AzCopy. Questo articolo si applica ad AzCopy V10 poiché si tratta della versione attualmente supportata di AzCopy. Se è necessario usare una versione precedente di AzCopy, vedere Usare la versione precedente di AzCopy.
File di log e di piano
AzCopy crea file di log e di piano per ogni processo. È possibile usare i log per analizzare e risolvere eventuali possibili problemi.
I log contengono lo stato dell'errore (UPLOADFAILED, COPYFAILED e DOWNLOADFAILED), il percorso completo e il motivo dell'errore.
Per impostazione predefinita, i file di log e di piano si trovano nella directory %USERPROFILE%\.azcopy su Windows o nella directory $HOME$\.azcopy su Mac e Linux, ma è possibile modificare tale percorso.
L'errore pertinente non è necessariamente il primo errore che compare nel file. Per gli errori, ad esempio errori di rete, timeout ed errori di server occupato, AzCopy eseguirà fino a 20 tentativi e in genere il processo di ripetizione dei tentativi ha esito positivo. Il primo errore visualizzato potrebbe essere un evento innocuo che è stato riprovato con successo. Invece di esaminare il primo errore nel file, cercare gli errori vicini a UPLOADFAILED, COPYFAILEDo DOWNLOADFAILED.
Importante
Quando si invia una richiesta al supporto tecnico Microsoft (o si risolve un problema che interessa terzi), condividere la versione modificata del comando che si vuole eseguire. Ciò garantisce che la firma di accesso condiviso non sia accidentalmente condivisa con nessuno. È possibile trovare la versione con modifiche all'inizio del file di log.
Esaminare i log degli errori
Il comando seguente otterrà tutti gli errori con stato UPLOADFAILED dal log 04dc9ca9-158f-7945-5933-564021086c79:
Windows (PowerShell)
Select-String UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
Linux
grep UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
Visualizzare e riprendere i processi
Ogni operazione di trasferimento creerà un processo di AzCopy. Per visualizzare la cronologia dei processi, usare il comando seguente:
azcopy jobs list
Per visualizzare le statistiche del processo, usare il comando seguente:
azcopy jobs show <job-id>
Per filtrare i trasferimenti in base allo stato, usare il comando seguente:
azcopy jobs show <job-id> --with-status=Failed
Suggerimento
Il valore del flag --with-status fa distinzione tra maiuscole e minuscole.
Usare il comando seguente per riprendere un processo non riuscito o annullato. Questo comando usa il proprio identificatore insieme al token SAS perché non è persistente per motivi di sicurezza:
azcopy jobs resume <job-id> --source-sas="<sas-token>" --destination-sas="<sas-token>"
Suggerimento
Racchiudere gli argomenti del percorso, ad esempio il token di firma di accesso condiviso con virgolette singole (''). Usare virgolette singole in tutte le shell dei comandi, ad eccezione della Shell dei comandi di Windows (cmd.exe). Se si usa una Shell dei comandi di Windows (cmd.exe), racchiudere gli argomenti path con virgolette doppie ("") anziché virgolette singole ('').
Quando si riprende un processo, AzCopy esamina il file di piano di processo. Il file di piano elenca tutti i file identificati per l'elaborazione al momento della creazione del processo. Quando si riprende un processo, AzCopy tenterà di trasferire tutti i file elencati nel file di piano che non sono già stati trasferiti.
Modificare il percorso dei file di piano
Usare uno dei comandi seguenti:
| Sistema operativo | Comando |
|---|---|
| Windows | PowerShell:$env:AZCOPY_JOB_PLAN_LOCATION="<value>" Usare set AZCOPY_JOB_PLAN_LOCATION=<value> nel prompt dei comandi. |
| Linux | export AZCOPY_JOB_PLAN_LOCATION=<value> |
| macOS | export AZCOPY_JOB_PLAN_LOCATION=<value> |
Usare azcopy env per verificare il valore corrente della variabile. Se il valore è vuoto, i file di piano vengono scritti nel percorso predefinito.
Modificare il percorso dei file di log
Usare uno dei comandi seguenti:
| Sistema operativo | Comando |
|---|---|
| Windows | PowerShell:$env:AZCOPY_LOG_LOCATION="<value>" Usare set AZCOPY_LOG_LOCATION=<value> nel prompt dei comandi. |
| Linux | export AZCOPY_LOG_LOCATION=<value> |
| macOS | export AZCOPY_LOG_LOCATION=<value> |
Usare azcopy env per verificare il valore corrente della variabile. Se il valore è vuoto, i log vengono scritti nel percorso predefinito.
Modificare il livello predefinito del log
Per impostazione predefinita, il livello del log di AzCopy è impostato su INFO. Se si vuole ridurre il livello di dettaglio del log per risparmiare spazio su disco, sovrascrivere l'impostazione usando l'opzione --log-level.
I livelli del log disponibili sono: DEBUG, INFO, WARNING, ERROR e NONE.
Rimuovere i file di piano e di log
Se si desidera rimuovere tutti i file di piano e di log dal computer locale per risparmiare spazio su disco, usare il comando azcopy jobs clean.
Per rimuovere i file di piano e di log associati a un solo processo, usare azcopy jobs rm <job-id>. Sostituire il segnaposto <job-id> in questo esempio con l'ID del processo.