Vyhledání chyb a obnovení úloh pomocí souborů protokolu a plánů v AzCopy

AzCopy je nástroj příkazového řádku, který můžete použít ke kopírování blobů nebo souborů do nebo z účtu úložiště. Tento článek vám pomůže s diagnostikou chyb pomocí protokolů a následné použití souborů plánu k obnovení úloh. Tento článek také ukazuje, jak nakonfigurovat soubory protokolů a plánů změnou úrovně podrobností a výchozího umístění, kde jsou uložené.

Poznámka:

Obsah, který vám pomůže začít s nástrojem AzCopy, najdete v tématu Začínáme s nástrojem AzCopy. Tento článek se týká AzCopy V10, protože se jedná o aktuálně podporovanou verzi AzCopy. Pokud potřebujete použít předchozí verzi Nástroje AzCopy, přečtěte si téma Použití předchozí verze nástroje AzCopy.

Soubory protokolů a plánů

AzCopy vytvoří soubory protokolu a plánu pro každou úlohu. Tyto protokoly můžete použít ke zkoumání případných problémů a jejich odstraňování.

Protokoly obsahují stav selhání (UPLOADFAILED, COPYFAILED a DOWNLOADFAILED), úplnou cestu a důvod selhání.

Ve výchozím nastavení se soubory protokolů a plánů nacházejí v adresáři %USERPROFILE%\.azcopy ve Windows nebo v adresáři $HOME$\.azcopy v systému Mac a Linux, ale toto umístění můžete změnit.

Relevantní chyba nemusí nutně být první chybou, která se zobrazí v souboru. V případě chyb, jako jsou chyby sítě, vypršení časového limitu a chyby zaneprázdněného serveru, AzCopy opakuje pokusy až 20krát a obvykle proces opakování proběhne úspěšně. První chyba, kterou můžete vidět, může být něco neškodného, co bylo úspěšně znovu pokuseno. Takže místo toho, abyste se podívali na první chybu v souboru, vyhledejte chyby, které jsou blízko UPLOADFAILED, COPYFAILEDnebo DOWNLOADFAILED.

Důležité

Při odesílání žádosti podpoře Microsoftu (nebo řešení potíží s problémem zahrnujícím jakoukoli třetí stranu) sdílejte upravenou verzi příkazu, který chcete spustit. Tato verze zajišťuje, že SAS není neúmyslně sdílen s nikým. Upravenou verzi najdete na začátku souboru protokolu.

Kontrola případných chyb v protokolech

Následující příkaz získá všechny chyby se stavem UPLOADFAILED04dc9ca9-158f-7945-5933-564021086c79 z protokolu:

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

Zobrazení a obnovení úloh

Každá operace přenosu vytvoří úlohu AzCopy. Pokud chcete zobrazit historii úloh, použijte následující příkaz:

azcopy jobs list

Pokud chcete zobrazit statistiku úlohy, použijte následující příkaz:

azcopy jobs show <job-id>

Pokud chcete filtrovat přenosy podle stavu, použijte následující příkaz:

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

Návod

Hodnota příznaku --with-status rozlišuje malá a velká písmena.

K obnovení neúspěšné nebo zrušené úlohy použijte následující příkaz. Tento příkaz používá identifikátor úlohy spolu s tokenem SAS, protože z bezpečnostních důvodů není trvalý:

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

Návod

Vložte argumenty cesty, jako je token SAS, do jednoduchých uvozovek (''). Použití jednoduchých uvozovek ve všech příkazových prostředích s výjimkou prostředí Windows Command Shell (cmd.exe). Pokud používáte příkazový řádek Windows (cmd.exe), uzavřete argumenty cesty do dvojitých uvozovek („") místo jednoduchých uvozovek ('').

Když obnovíte úlohu, AzCopy se podívá na soubor plánu úlohy. V souboru plánu jsou uvedeny všechny soubory, které byly identifikovány ke zpracování při prvním vytvoření úlohy. Když obnovíte úlohu, AzCopy se pokusí přenést všechny soubory uvedené v souboru plánu, které ještě nebyly přeneseny.

Změna umístění souborů plánu

Použijte následující příkaz.

export AZCOPY_JOB_PLAN_LOCATION=<value>

Změna umístění souborů protokolu

Použijte následující příkaz.

export AZCOPY_LOG_LOCATION=<value>

Změna výchozí úrovně protokolu

Ve výchozím nastavení AzCopy nastaví úroveň protokolu na INFO. Pokud chcete snížit úroveň podrobností protokolu a ušetřit místo na disku, použijte --log-level možnost přepsání tohoto nastavení.

Dostupné úrovně protokolů jsou: DEBUG, INFO, WARNING, ERRORa NONE.

Odebrání souborů plánů a protokolů

Pokud chcete odebrat všechny soubory plánů a protokolů z místního počítače a ušetřit místo na disku, použijte azcopy jobs clean příkaz.

Chcete-li odebrat plán a soubory protokolu pouze pro jednu úlohu, použijte azcopy jobs rm <job-id>. Zástupný text <job-id> v tomto příkladu nahraďte identifikátorem dané úlohy.

Viz také