Hibák keresése és feladatok folytatása napló- és tervfájlok használatával az AzCopyban
Az AzCopy egy parancssori segédprogram, amellyel blobokat és fájlokat másolhat a tárfiókok között. Ez a cikk segít naplók használatával diagnosztizálni a hibákat, majd tervfájlokat használni a feladatok folytatásához. Ez a cikk azt is bemutatja, hogyan konfigurálhatja a napló- és csomagfájlokat a részletességi szint és az alapértelmezett tárolási hely módosításával.
Megjegyzés
Ha olyan tartalmat keres, amely segít az AzCopy használatának megkezdésében, olvassa el az AzCopy használatának első lépéseit ismertető cikket. Ez a cikk az AzCopy V10-re vonatkozik, mivel ez az AzCopy jelenleg támogatott verziója. Ha az AzCopy egy korábbi verzióját kell használnia, olvassa el az AzCopy előző verziójának használata című témakört.
Napló- és tervfájlok
Az AzCopy minden feladathoz létrehoz napló- és tervfájlokat . A naplók segítségével kivizsgálhatja és elháríthatja a lehetséges problémákat.
A naplók a hiba állapotát (UPLOADFAILED
, COPYFAILED
és DOWNLOADFAILED
), a teljes elérési utat és a hiba okát tartalmazzák.
A napló- és tervfájlok a Windows rendszeren alapértelmezés szerint a %USERPROFILE%\.azcopy
könyvtárban, Mac és Linux esetében pedig a $HOME$\.azcopy
könyvtárban találhatók, de módosíthatja a helyüket.
A releváns hiba nem feltétlenül az első hiba, amely megjelenik a fájlban. Az olyan hibák, mint a hálózati hibák, időtúllépések és a foglalt kiszolgálóval kapcsolatos hibák esetén az AzCopy legfeljebb 20-szor próbálkozik újra, és az újrapróbálkozás általában sikeres. Az első látható hiba lehet valami ártalmatlan, amelyet sikeresen újrapróbáltak. Ezért a fájl első hibájának keresése helyett keresse meg azokat a hibákat, amelyek közel vannak a , COPYFAILED
vagy DOWNLOADFAILED
a fájlhozUPLOADFAILED
.
Fontos
Amikor kérést küld a Microsoft ügyfélszolgálata (vagy elhárítja a harmadik feleket érintő problémát), ossza meg a végrehajtani kívánt parancs újrafuttatott verzióját. Így gondoskodni lehet róla, hogy ne ossza meg véletlenül másokkal az SAS-t. A kivonatos verziót a naplófájl elején találja.
Ellenőrizze, hogy a naplók tartalmaznak-e hibát
A következő paranccsal megjelenítheti az összes UPLOADFAILED
állapotú hibát a 04dc9ca9-158f-7945-5933-564021086c79
naplóból:
Windows (PowerShell)
Select-String UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
Linux
grep UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
Feladatok megtekintése és folytatása
Minden átviteli művelet létrehoz egy AzCopy-feladatot. A következő paranccsal tekintheti meg a feladatelőzményeket:
azcopy jobs list
A feladatstatisztikák megtekintéséhez használja a következő parancsot:
azcopy jobs show <job-id>
Az átvitelek állapot szerinti szűréséhez használja a következő parancsot:
azcopy jobs show <job-id> --with-status=Failed
Tipp
A jelölő értéke megkülönbözteti a --with-status
kis- és nagybetűk értékét.
Egy meghiúsult/megszakított feladat folytatásához használja a következő parancsot. Ez a parancs az azonosítóját és az SAS-jogkivonatot használja, mivel biztonsági okokból nem állandó:
azcopy jobs resume <job-id> --source-sas="<sas-token>" --destination-sas="<sas-token>"
Tipp
Csatolja az elérésiút-argumentumokat, például az SAS-jogkivonatot egyetlen idézőjelekkel ('). A Windows command Shell (cmd.exe) kivételével minden parancshéjban használjon egyetlen idézőjelet. Ha Windows Command Shellt (cmd.exe) használ, az elérésiút-argumentumokat idézőjelek (') helyett dupla idézőjelekkel ("") foglalja össze.
A feladat folytatásakor az AzCopy megvizsgálja a feladattervfájlt. A tervfájl felsorolja a feladat első létrehozásakor feldolgozásra azonosított összes fájlt. A feladat folytatásakor az AzCopy megpróbálja átvinni a tervfájlban felsorolt összes olyan fájlt, amely még nem került át.
Tervfájlok helyének módosítása
Használja ezeket a parancsokat.
Operációs rendszer | Parancs |
---|---|
Windows | Powershell:$env:AZCOPY_JOB_PLAN_LOCATION="<value>" Parancssorban használja a következőt: set AZCOPY_JOB_PLAN_LOCATION=<value> |
Linux | export AZCOPY_JOB_PLAN_LOCATION=<value> |
macOS | export AZCOPY_JOB_PLAN_LOCATION=<value> |
azcopy env
A változó aktuális értékének ellenőrzéséhez használja az értéket. Ha az érték üres, a rendszer a tervfájlokat az alapértelmezett helyre írja.
A naplófájlok helyének megváltoztatása
Használja ezeket a parancsokat.
Operációs rendszer | Parancs |
---|---|
Windows | Powershell:$env:AZCOPY_LOG_LOCATION="<value>" Parancssorban használja a következőt: set AZCOPY_LOG_LOCATION=<value> |
Linux | export AZCOPY_LOG_LOCATION=<value> |
macOS | export AZCOPY_LOG_LOCATION=<value> |
azcopy env
A változó aktuális értékének ellenőrzéséhez használja az értéket. Ha az érték üres, a rendszer a naplókat az alapértelmezett helyre írja.
Az alapértelmezett naplószint módosítása
Alapértelmezés szerint az AzCopy naplószintje a következőre INFO
van állítva: . Ha csökkenteni szeretné a napló részletességét a lemezterület mentése érdekében, írja felül ezt a beállítást a --log-level
beállítással.
A rendelkezésre álló naplószintek a következők: DEBUG
, INFO
, WARNING
, ERROR
, és NONE
.
Terv- és naplófájlok eltávolítása
Ha el szeretné távolítani az összes terv- és naplófájlt a helyi gépéről, hogy lemezterületet takarítson meg, használja a következő parancsot: azcopy jobs clean
.
Ha csak egy bizonyos feladathoz társított terv- és naplófájlokat szeretne eltávolítani, használja a következő parancsot: azcopy jobs rm <job-id>
. Cserélje le az ebben a példában szereplő <job-id>
helyőrzőt a feladat feladatazonosítójára.