Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
AzCopy è un'utilità della riga di comando che è possibile usare per copiare BLOB o file da o verso un account di archiviazione. Questo articolo consente di utilizzare i log per diagnosticare gli errori e quindi di utilizzare i file di piano per riprendere i processi. In questo articolo viene inoltre illustrato come configurare i file di log e di pianificazione modificandone il livello di dettaglio e il percorso predefinito in cui sono archiviati.
Annotazioni
Se si sta cercando contenuto che consenta di iniziare a usare AzCopy, vedere Introduzione ad AzCopy. Questo articolo si applica ad AzCopy V10 in quanto questa è la 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 appare nel file. Per errori come errori di rete, timeout ed errori di server occupato, AzCopy riproverà fino a 20 volte e in genere il processo di ripetizione dei tentativi ha esito positivo. Il primo errore che vedi potrebbe essere qualcosa di innocuo che è stato riprovato con successo. Quindi, invece di esaminare il primo errore nel file, cercare gli errori vicini a UPLOADFAILED, COPYFAILED, o DOWNLOADFAILED.
Importante
Quando invii una richiesta al supporto tecnico Microsoft (o risolvi il problema che coinvolge terze parti), condividi la versione oscurata del comando che desideri 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, utilizzare il seguente comando:
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 --with-status flag 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, tra 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 del piano del 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 del piano che non sono già stati trasferiti.
Modificare la posizione dei file del piano
Utilizzare uno di questi comandi.
| Sistema operativo | Comando |
|---|---|
| Finestre | PowerShell:$env:AZCOPY_JOB_PLAN_LOCATION="<value>" In un prompt dei comandi utilizzare: set AZCOPY_JOB_PLAN_LOCATION=<value> |
| Linux | export AZCOPY_JOB_PLAN_LOCATION=<value> |
| macOS | export AZCOPY_JOB_PLAN_LOCATION=<value> |
Usare azcopy env per controllare il valore corrente di questa variabile. Se il valore è vuoto, i file di piano vengono scritti nel percorso predefinito.
Modificare la posizione dei file di registro
Utilizzare uno di questi comandi.
| Sistema operativo | Comando |
|---|---|
| Finestre | PowerShell:$env:AZCOPY_LOG_LOCATION="<value>" In un prompt dei comandi utilizzare: set AZCOPY_LOG_LOCATION=<value> |
| Linux | export AZCOPY_LOG_LOCATION=<value> |
| macOS | export AZCOPY_LOG_LOCATION=<value> |
Usare azcopy env per controllare il valore corrente di questa variabile. Se il valore è vuoto, i log vengono scritti nel percorso predefinito.
Modificare il livello di registro predefinito
Per impostazione predefinita, il livello di log AzCopy è impostato su INFO. Se si desidera ridurre il livello di dettaglio del log per risparmiare spazio su disco, sovrascrivere questa impostazione utilizzando l'opzione --log-level .
I livelli di registro disponibili sono: DEBUG, INFO, WARNING, , ERRORe 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.