Dela via


Hitta fel och återuppta jobb med hjälp av logg- och planfiler i AzCopy

AzCopy är ett kommandoradsverktyg som du kan använda för att kopiera blobar eller filer till eller från ett lagringskonto. Den här artikeln hjälper dig att använda loggar för att diagnostisera fel och sedan använda planfiler för att återuppta jobb. Den här artikeln visar också hur du konfigurerar logg- och planfiler genom att ändra deras utförlighetsnivå och standardplatsen där de lagras.

Anmärkning

Innehåll som hjälper dig att komma igång med AzCopy finns i Komma igång med AzCopy. Den här artikeln gäller för AzCopy V10 eftersom detta är den version av AzCopy som stöds för närvarande. Om du behöver använda en tidigare version av AzCopy kan du läsa Använda den tidigare versionen av AzCopy.

Logg- och planfiler

AzCopy skapar logg- och planfiler för varje jobb. Du kan undersöka och felsöka eventuella problem med hjälp av dessa loggar.

Loggarna innehåller statusen för felet (UPLOADFAILED, COPYFAILED, och DOWNLOADFAILED), den fullständiga sökvägen och orsaken till felet.

Som standard finns logg- och planfilerna i katalogen %USERPROFILE%\.azcopy i Windows eller i katalogen $HOME$\.azcopy på Mac och Linux, men du kan byta plats om du vill.

Det relevanta felet är inte nödvändigtvis det första felet som visas i filen. För fel som: nätverksfel, tidsgränsöverskridanden och fel på grund av upptagen server, försöker AzCopy igen upp till 20 gånger och vanligtvis lyckas återförsökssekvensen. Det första felet som du ser kan vara något ofarligt som har gjorts om. I stället för att titta på det första felet i filen letar du efter felen som är nära UPLOADFAILED, COPYFAILEDeller DOWNLOADFAILED.

Viktigt!

När du skickar en begäran till Microsoft Support (eller felsöker problemet med tredje part) delar du den redigerade versionen av kommandot som du vill köra. Den här versionen säkerställer att SAS inte delas av misstag med någon. Du hittar den redigerade versionen i början av loggfilen.

Kontrollera om loggarna innehåller fel

Följande kommando hämtar alla fel med UPLOADFAILED status från loggen 04dc9ca9-158f-7945-5933-564021086c79 :

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

Visa och återuppta jobb

Varje överföringsåtgärd skapar ett AzCopy-jobb. Kör följande kommando om du vill visa jobbhistoriken:

azcopy jobs list

Om du vill visa jobbstatistiken använder du följande kommando:

azcopy jobs show <job-id>

Om du vill filtrera överföringarna efter status kör du följande kommando:

azcopy jobs show <job-id> --with-status=Failed

Tips/Råd

Flaggans --with-status värde är skiftlägeskänsligt.

Använd följande kommando för att återuppta ett misslyckat eller avbrutet jobb. Det här kommandot använder jobbidentifieraren tillsammans med SAS-token eftersom den inte är beständig av säkerhetsskäl:

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

Tips/Råd

Omsluta sökvägsargument som SAS-token med enkla citattecken (''). Använd enkla citattecken i alla kommandogränssnitt förutom Windows Command Shell (cmd.exe). Om du använder ett Windows-kommandogränssnitt (cmd.exe) omger du sökvägsargument med dubbla citattecken ("") i stället för enkla citattecken ('').

När du återupptar ett jobb tittar AzCopy på jobbplansfilen. Planfilen visar alla filer som identifierades för bearbetning när jobbet först skapades. När du återupptar ett jobb försöker AzCopy överföra alla filer som visas i planfilen och som inte redan har överförts.

Ändra platsen för planfiler

Använd följande kommando.

export AZCOPY_JOB_PLAN_LOCATION=<value>

Ändra platsen för loggfiler

Använd följande kommando.

export AZCOPY_LOG_LOCATION=<value>

Ändra standardloggnivå

Som standard anger AzCopy loggnivån till INFO. Om du vill minska loggverositeten och spara diskutrymme använder du alternativet för att skriva över den --log-level här inställningen.

Tillgängliga loggnivåer är: DEBUG, INFO, WARNING, ERRORoch NONE.

Ta bort plan- och loggfiler

Om du vill ta bort alla plan- och loggfiler från den lokala datorn och spara diskutrymme använder du azcopy jobs clean kommandot .

Om du bara vill ta bort planen och loggfilerna för ett jobb använder du azcopy jobs rm <job-id>. Ersätt <job-id>-platshållaren i det här exemplet med jobbets jobb-ID.

Se även