Fouten zoeken en taken hervatten met behulp van logboek- en planbestanden in AzCopy
AzCopy is een opdrachtregelprogramma dat u kunt gebruiken om blobs of bestanden vanuit of naar een opslagaccount te kopiëren. Dit artikel helpt u bij het gebruik van logboeken om fouten te diagnosticeren en vervolgens planbestanden te gebruiken om taken te hervatten. In dit artikel wordt ook beschreven hoe u logboek- en planbestanden configureert door het uitgebreidheidsniveau en de standaardlocatie te wijzigen waar ze zijn opgeslagen.
Notitie
Als u op zoek bent naar inhoud om aan de slag te gaan met AzCopy, raadpleegt u Aan de slag met AzCopy. Dit artikel is van toepassing op AzCopy V10 , omdat dit de momenteel ondersteunde versie van AzCopy is. Als u een eerdere versie van AzCopy wilt gebruiken, raadpleegt u De vorige versie van AzCopy gebruiken.
Logboeken en planbestanden
AzCopy maakt logboek- en planbestanden voor elke taak. U kunt deze logboeken gebruiken om potentiële problemen te onderzoeken en op te lossen.
De logboeken bevatten de status van de fout (UPLOADFAILED, COPYFAILED en DOWNLOADFAILED), het volledige pad en de reden van de fout.
De logboek- en planbestanden bevinden zich standaard in de map %USERPROFILE%\.azcopy op Windows of $HOME$\.azcopy op Mac en Linux, maar u kunt deze locatie desgewenst wijzigen.
De relevante fout is niet noodzakelijkerwijs de eerste fout die in het bestand wordt weergegeven. Bij fouten zoals netwerkfouten, time-outs, en Server bezet-fouten, worden in AzCopy maximaal 20 nieuwe pogingen uitgevoerd. Meestal slaagt een van deze pogingen. De eerste fout die u ziet, is mogelijk onschadelijk en is opnieuw geprobeerd. Dus in plaats van te kijken naar de eerste fout in het bestand, zoekt u naar de fouten in de buurt UPLOADFAILEDvan , COPYFAILEDof DOWNLOADFAILED.
Belangrijk
Wanneer u een aanvraag indient bij Microsoft Ondersteuning (of het probleem met derden oplost), deelt u de geredigeerde versie van de opdracht die u wilt uitvoeren. Dit zorgt ervoor dat de SAS niet per ongeluk met iemand wordt gedeeld. U vindt de geredigeerde versie aan het begin van het logboekbestand.
De logboeken controleren op fouten
Met de volgende opdracht worden alle fouten met status UPLOADFAILED uit het logboek 04dc9ca9-158f-7945-5933-564021086c79 opgehaald:
Windows (PowerShell)
Select-String UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
Linux
grep UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
Taken bekijken en hervatten
Elke overdrachtsbewerking maakt een AzCopy-taak. Gebruik de volgende opdracht om de geschiedenis van taken weer te geven:
azcopy jobs list
Gebruik de volgende opdracht om de taakstatistieken weer te geven:
azcopy jobs show <job-id>
Gebruik de volgende opdracht om de overdrachten op status te filteren:
azcopy jobs show <job-id> --with-status=Failed
Tip
De waarde van de --with-status vlag is hoofdlettergevoelig.
Gebruik de volgende opdracht om een mislukte/geannuleerde taak te hervatten. Deze opdracht maakt gebruik van de id samen met het SAS-token, omdat het om veiligheidsredenen niet persistent is:
azcopy jobs resume <job-id> --source-sas="<sas-token>" --destination-sas="<sas-token>"
Tip
Plaats padargumenten zoals het SAS-token tussen enkele aanhalingstekens (''). Gebruik enkele aanhalingstekens in alle opdrachtshells, met uitzondering van de Windows-opdrachtshell (cmd.exe). Als u een Windows-opdrachtshell (cmd.exe) gebruikt, plaatst u padargumenten tussen dubbele aanhalingstekens ("") in plaats van enkele aanhalingstekens ('').
Wanneer u een taak hervat, bekijkt AzCopy het taakplanbestand. Het planbestand bevat alle bestanden die zijn geïdentificeerd voor verwerking toen de taak voor het eerst werd gemaakt. Wanneer u een taak hervat, probeert AzCopy alle bestanden over te dragen die worden vermeld in het planbestand die nog niet zijn overgedragen.
De locatie van planbestanden wijzigen
Gebruik een van deze opdrachten.
| Besturingssysteem | Opdracht |
|---|---|
| Windows | Powershell:$env:AZCOPY_JOB_PLAN_LOCATION="<value>" Gebruik in een opdrachtprompt:: set AZCOPY_JOB_PLAN_LOCATION=<value> |
| Linux | export AZCOPY_JOB_PLAN_LOCATION=<value> |
| MacOS | export AZCOPY_JOB_PLAN_LOCATION=<value> |
Gebruik de azcopy env om de huidige waarde van deze variabele te controleren. Als de waarde leeg is, worden planbestanden naar de standaardlocatie geschreven.
De locatie van logboekbestanden wijzigen
Gebruik een van deze opdrachten.
| Besturingssysteem | Opdracht |
|---|---|
| Windows | Powershell:$env:AZCOPY_LOG_LOCATION="<value>" Gebruik in een opdrachtprompt:: set AZCOPY_LOG_LOCATION=<value> |
| Linux | export AZCOPY_LOG_LOCATION=<value> |
| MacOS | export AZCOPY_LOG_LOCATION=<value> |
Gebruik de azcopy env om de huidige waarde van deze variabele te controleren. Als de waarde leeg is, worden logboeken naar de standaardlocatie geschreven.
Het standaardlogboekniveau wijzigen
AzCopy-logboekniveau is standaard ingesteld op INFO. Als u de uitgebreidheid van het logboek wilt verminderen om schijfruimte te besparen, overschrijft u deze instelling met behulp van de --log-level optie .
Beschikbare logboekniveaus zijn: DEBUG, INFO, WARNINGERRORen NONE.
Plan- en logboekbestanden verwijderen
Als u alle plan- en logboekbestanden van uw lokale computer wilt verwijderen om schijfruimte te besparen, gebruikt u de opdracht azcopy jobs clean.
Gebruik azcopy jobs rm <job-id> om de plan- en logboekbestanden te verwijderen die aan slechts één taak zijn gekoppeld. Vervang de tijdelijke aanduiding <job-id> in dit voorbeeld door de taak-id van de taak.