Share via


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 te kopiëren naar of vanuit een opslagaccount. Dit artikel helpt u logboeken te gebruiken om fouten vast te stellen en vervolgens planbestanden te gebruiken om taken te hervatten. In dit artikel wordt ook beschreven hoe u logboek- en planbestanden configureert door het uitgebreidheidsniveau te wijzigen en de standaardlocatie waar ze worden opgeslagen.

Opmerking

Raadpleeg de informatie in Aan de slag met AzCopy om te beginnen met AzCopy. Dit artikel is van toepassing op AzCopy V10 , omdat dit de momenteel ondersteunde versie van AzCopy is. Zie De vorige versie van AzCopy gebruiken als u een eerdere versie van AzCopy wilt 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, COPYFAILEDen DOWNLOADFAILED), het volledige pad en de reden voor 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. Voor fouten zoals netwerkfouten, time-outs en serverdrukte fouten probeert AzCopy het maximaal 20 keer opnieuw en meestal slaagt het opnieuw proberen. De eerste fout die u ziet, is mogelijk iets onschuldigs dat opnieuw is geprobeerd. Dus in plaats van naar de eerste fout in het bestand te kijken, zoekt u naar de fouten in de buurt UPLOADFAILED, COPYFAILEDof DOWNLOADFAILED.

Belangrijk

Wanneer u een aanvraag indient bij Microsoft Ondersteuning (of het probleem met een derde partij oplossen), deelt u de redacted versie van de opdracht die u wilt uitvoeren. Deze versie 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 de status UPLOADFAILED uit het 04dc9ca9-158f-7945-5933-564021086c79 logboek opgehaald.

Select-String UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log

Taken bekijken en hervatten

Elke overdracht creëert 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

Hint

De waarde van de --with-status vlag is hoofdlettergevoelig.

Gebruik de volgende opdracht om een mislukte of geannuleerde taak te hervatten. Met deze opdracht wordt de taak-id samen met het SAS-token gebruikt, omdat deze om veiligheidsredenen niet persistent is:

azcopy jobs resume <job-id> --source-sas="<sas-token>" --destination-sas="<sas-token>"

Hint

Plaats padargumenten zoals het SAS-token tussen enkele aanhalingstekens (''). Gebruik enkele aanhalingstekens in alle opdrachtshells, met uitzondering van de Windows Command Shell (cmd.exe). Als u een Windows Command Shell (cmd.exe) gebruikt, plaatst u padargumenten tussen dubbele aanhalingstekens ("") in plaats van enkele aanhalingstekens ('').

Wanneer u een taak hervat, kijkt AzCopy naar 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 die worden vermeld in het planbestand over te dragen en die nog niet zijn overgedragen.

De locatie van planbestanden wijzigen

Gebruik de volgende opdracht.

export AZCOPY_JOB_PLAN_LOCATION=<value>

De locatie van logboekbestanden wijzigen

Gebruik de volgende opdracht.

export AZCOPY_LOG_LOCATION=<value>

Het standaardlogboekniveau wijzigen

Standaard stelt AzCopy het logboekniveau in op INFO. Als u de uitgebreidheid van het logboek wilt verminderen en schijfruimte wilt besparen, gebruikt u de --log-level optie om deze instelling te overschrijven.

Beschikbare logboekniveaus zijn: DEBUG, INFO, WARNING, ERRORen NONE.

Plan- en logboekbestanden verwijderen

Als u alle plan- en logboekbestanden van uw lokale computer wilt verwijderen en schijfruimte wilt besparen, gebruikt u de azcopy jobs clean opdracht.

Als u het plan en de logboekbestanden voor slechts één taak wilt verwijderen, gebruikt u azcopy jobs rm <job-id>. Vervang de tijdelijke aanduiding <job-id> in dit voorbeeld door de taak-id van de taak.

Zie ook