Znajdowanie błędów i wznawianie zadań przy użyciu plików dziennika i planu w narzędziu AzCopy
AzCopy to narzędzie wiersza polecenia, przy użyciu którego można kopiować obiekty blob lub pliki do lub z konta magazynu. Ten artykuł ułatwia diagnozowanie błędów za pomocą dzienników, a następnie używanie plików planu do wznawiania zadań. W tym artykule przedstawiono również sposób konfigurowania plików dziennika i planowania przez zmianę poziomu szczegółowości oraz lokalizację domyślną, w której są przechowywane.
Uwaga
Jeśli szukasz zawartości ułatwiającej rozpoczęcie pracy z narzędziem AzCopy, zobacz Wprowadzenie do narzędzia AzCopy. Ten artykuł dotyczy narzędzia AzCopy w wersji 10 , ponieważ jest to obecnie obsługiwana wersja narzędzia AzCopy. Jeśli musisz użyć poprzedniej wersji narzędzia AzCopy, zobacz Use the previous version of AzCopy (Korzystanie z poprzedniej wersji narzędzia AzCopy).
Pliki dziennika i planu
Narzędzie AzCopy tworzy pliki dziennika i planu dla każdego zadania. Przy użyciu dzienników możesz zbadać i rozwiązać potencjalne problemy.
Dzienniki będą zawierały stan błędu (UPLOADFAILED, COPYFAILED i DOWNLOADFAILED), pełną ścieżkę i przyczynę błędu.
Domyślnie pliki dziennika i planu znajdują się w katalogu %USERPROFILE%\.azcopy w systemie Windows lub $HOME$\.azcopy w systemach Mac i Linux, ale możesz zmienić tę lokalizację.
Odpowiedni błąd nie musi być pierwszym błędem występującym w pliku. W przypadku takich błędów jak błędy sieci, limity czasu i błędy zajętości serwera narzędzie AzCopy ponawia próbę do 20 razy, a proces ponawiania zazwyczaj kończy się pomyślnie. Pierwszy błąd, który widzisz, może być czymś nieszkodliwym, który został pomyślnie ponowiony. Dlatego zamiast patrzeć na pierwszy błąd w pliku, poszukaj błędów, które znajdują się w pobliżu UPLOADFAILED, COPYFAILEDlub DOWNLOADFAILED.
Ważne
Podczas przesyłania żądania do pomoc techniczna firmy Microsoft (lub rozwiązywania problemu z udziałem dowolnej innej firmy) udostępnij zredagowaną wersję polecenia, które chcesz wykonać. Dzięki temu sygnatura SAS nie zostanie nikomu przypadkowo udostępniona. Wersję zredagowaną można znaleźć na początku pliku dziennika.
Sprawdzanie dzienników pod kątem błędów
Następujące polecenie pobierze wszystkie błędy ze stanem UPLOADFAILED z dziennika 04dc9ca9-158f-7945-5933-564021086c79:
Windows (PowerShell)
Select-String UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
Linux
grep UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
Wyświetlanie i wznawianie zadań
Każda operacja transferu spowoduje utworzenie zadania narzędzia AzCopy. Użyj następującego polecenia, aby wyświetlić historię zadań:
azcopy jobs list
Aby wyświetlić statystyki zadań, użyj następującego polecenia:
azcopy jobs show <job-id>
Aby przefiltrować transfery według stanu, użyj następującego polecenia:
azcopy jobs show <job-id> --with-status=Failed
Porada
Wartość flagi --with-status jest wrażliwa na wielkość liter.
Użyj następującego polecenia, aby wznowić zadanie, które zakończyło się niepowodzeniem lub zostało anulowane. To polecenie używa swojego identyfikatora wraz z tokenem SAS, ponieważ nie jest on trwały ze względów bezpieczeństwa:
azcopy jobs resume <job-id> --source-sas="<sas-token>" --destination-sas="<sas-token>"
Porada
Oto argumenty ścieżki, takie jak token SAS z pojedynczymi cudzysłowami (''). Używaj pojedynczych cudzysłowów we wszystkich powłokach poleceń z wyjątkiem powłoki poleceń systemu Windows (cmd.exe). Jeśli używasz powłoki poleceń systemu Windows (cmd.exe), zamiast cudzysłowów pojedynczych ('').
Po wznowieniu zadania narzędzie AzCopy analizuje plik planu zadania. Plik planu zawiera listę wszystkich plików, które zostały zidentyfikowane do przetwarzania podczas pierwszego utworzenia zadania. Po wznowieniu zadania narzędzie AzCopy podejmie próbę przeniesienia wszystkich plików wymienionych w pliku planu, które nie zostały jeszcze przeniesione.
Zmienianie lokalizacji plików planu
Użyj dowolnego z tych poleceń.
| System operacyjny | Polecenie |
|---|---|
| Windows | Powershell:$env:AZCOPY_JOB_PLAN_LOCATION="<value>" W wierszu polecenia użyj polecenia:: set AZCOPY_JOB_PLAN_LOCATION=<value> |
| Linux | export AZCOPY_JOB_PLAN_LOCATION=<value> |
| macOS | export AZCOPY_JOB_PLAN_LOCATION=<value> |
Użyj elementu , azcopy env aby sprawdzić bieżącą wartość tej zmiennej. Jeśli wartość jest pusta, pliki planu są zapisywane w domyślnej lokalizacji.
Zmienianie lokalizacji plików dziennika
Użyj dowolnego z tych poleceń.
| System operacyjny | Polecenie |
|---|---|
| Windows | Powershell:$env:AZCOPY_LOG_LOCATION="<value>" W wierszu polecenia użyj polecenia:: set AZCOPY_LOG_LOCATION=<value> |
| Linux | export AZCOPY_LOG_LOCATION=<value> |
| macOS | export AZCOPY_LOG_LOCATION=<value> |
Użyj elementu , azcopy env aby sprawdzić bieżącą wartość tej zmiennej. Jeśli wartość jest pusta, dzienniki są zapisywane w lokalizacji domyślnej.
Zmienianie domyślnego poziomu dziennika
Domyślnie poziom dziennika narzędzia AzCopy jest ustawiony na INFOwartość . Jeśli chcesz zmniejszyć szczegółowość dziennika, aby zaoszczędzić miejsce na dysku, zastąp --log-level to ustawienie przy użyciu opcji .
Dostępne poziomy dzienników to: DEBUG, , INFOWARNING, ERRORi NONE.
Usuwanie plików planu i dziennika
Jeśli chcesz usunąć wszystkie pliki planu i dziennika z komputera lokalnego, aby zaoszczędzić miejsce na dysku, użyj polecenia azcopy jobs clean.
Aby usunąć pliki planu i dziennika skojarzone tylko z jednym zadaniem, użyj polecenia azcopy jobs rm <job-id>. Zamień symbol zastępczy <job-id> w tym przykładzie na identyfikator zadania.