Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
AzCopy — это утилита командной строки, которую можно использовать для копирования блобов или файлов в учетную запись хранения или из неё. Эта статья помогает использовать журналы для диагностики ошибок, а затем использовать файлы планов для возобновления заданий. В этой статье также показано, как настроить файлы журналов и планов, изменив уровень детализации и расположение по умолчанию, в котором они хранятся.
Примечание.
Если вы ищете содержимое, чтобы помочь вам приступить к работе с AzCopy, см. статью "Начало работы с AzCopy". Эта статья относится к AzCopy V10 , так как это текущая поддерживаемая версия AzCopy. Если вам нужно использовать предыдущую версию AzCopy, см. статью "Использовать предыдущую версию AzCopy".
Файлы журналов и планов
AzCopy создает файлы логов и планов для каждого задания. Эти журналы можно использовать для исследования и устранения возможных проблем.
Журналы будут содержать состояния сбоя (UPLOADFAILED,COPYFAILED и DOWNLOADFAILED), полный путь и причину сбоя.
По умолчанию файлы журналов и планов расположены в каталоге %USERPROFILE%\.azcopy в Windows или $HOME$\.azcopy в Mac и Linux, но это расположение можно изменить.
Соответствующая ошибка не обязательно является первой ошибкой, которая отображается в файле. Для таких ошибок, как сетевые ошибки, время ожидания и ошибки занятого сервера, AzCopy повторная попытка будет произведена до 20 раз, и обычно это позволяет успешно завершить процесс. Первая ошибка, которую вы видите, может быть чем-то безвредным, что было успешно повторено. Поэтому вместо того, чтобы просмотреть первую ошибку в файле, найдите ошибки, которые находятся рядом UPLOADFAILED, COPYFAILEDили DOWNLOADFAILED.
Это важно
При отправке запроса в службу поддержки Майкрософт (или устранении неполадок, связанных с любой стороной), поделитесь исправленной версией команды, которую вы хотите выполнить. Это гарантирует, что общий доступ к SAS не будет случайно предоставлен всем. Вы можете найти исправленную версию в начале файла журнала.
Проверка журналов на наличие ошибок
Следующая команда позволит получить все ошибки с состоянием UPLOADFAILED из журнала 04dc9ca9-158f-7945-5933-564021086c79:
Windows (PowerShell)
Select-String UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
Линукс
grep UPLOADFAILED .\04dc9ca9-158f-7945-5933-564021086c79.log
Просмотр и возобновление задач
В рамках каждой операции передачи будет создано задание AzCopy. Чтобы просмотреть журнал заданий, используйте следующую команду.
azcopy jobs list
Чтобы просмотреть статистику задания, используйте следующую команду:
azcopy jobs show <job-id>
Чтобы отфильтровать операции передачи по состоянию, используйте следующую команду:
azcopy jobs show <job-id> --with-status=Failed
Подсказка
Значение флага --with-status зависит от регистра.
Чтобы возобновить выполнение неудачного или отмененного задания, используйте следующую команду. Эта команда использует свой идентификатор вместе с маркером SAS, так как он не является постоянным в целях безопасности.
azcopy jobs resume <job-id> --source-sas="<sas-token>" --destination-sas="<sas-token>"
Подсказка
Заключите аргументы пути, такие как маркер SAS, в одинарные кавычки ('). Используйте одинарные кавычки во всех командных оболочках, кроме командной оболочки Windows (cmd.exe). Если вы используете командную оболочку Windows (cmd.exe), заключите аргументы пути в двойные кавычки ("") вместо одинарных (").
При возобновлении задания AzCopy просматривает файл плана задания. В файле плана перечислены все файлы, которые были определены для обработки при создании задания. При возобновлении задания AzCopy попытается передать все файлы, перечисленные в файле плана, которые еще не были переданы.
Изменение расположения файлов плана
Используйте любую из этих команд.
| Операционная система | Приказ |
|---|---|
| Виндоус | В PowerShell:$env:AZCOPY_JOB_PLAN_LOCATION="<value>" В командной строке используется:: set AZCOPY_JOB_PLAN_LOCATION=<value> |
| Линукс | export AZCOPY_JOB_PLAN_LOCATION=<value> |
| macOS | export AZCOPY_JOB_PLAN_LOCATION=<value> |
Чтобы проверить текущее значение этой переменной, выполните команду azcopy env. Если значение пустое, файлы плана записываются в расположение по умолчанию.
Изменение расположения файлов журнала
Используйте любую из этих команд.
| Операционная система | Приказ |
|---|---|
| Виндоус | В PowerShell:$env:AZCOPY_LOG_LOCATION="<value>" В командной строке используется:: set AZCOPY_LOG_LOCATION=<value> |
| Линукс | export AZCOPY_LOG_LOCATION=<value> |
| macOS | export AZCOPY_LOG_LOCATION=<value> |
Чтобы проверить текущее значение этой переменной, выполните команду azcopy env. Если значение пустое, журналы записываются в расположение по умолчанию.
Изменение уровня журнала по умолчанию
По умолчанию для уровня журнала AzCopy задано значение INFO. Если вы хотите уменьшить подробность журнала для экономии места на диске, перезапишите этот параметр, используя параметр --log-level.
Доступные уровни журнала: DEBUG, INFO, WARNING, ERRORи NONE.
Удаление файлов плана и журнала
Если вы хотите удалить все файлы планов и журналов с локального компьютера, чтобы сэкономить место на диске, используйте команду azcopy jobs clean.
Чтобы удалить файлы плана и журнала, связанные только с одним заданием, используйте azcopy jobs rm <job-id>. Замените заполнитель <job-id> в этом примере идентификатором задания.