Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
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.
Просмотр и возобновление задач
Каждая операция передачи данных создает задачу 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 пытается передать все файлы, перечисленные в файле плана и ещё не переданные.
Изменение расположения файлов плана
Используйте следующую команду.
Изменение расположения файлов журнала
Используйте следующую команду.
Изменение уровня журнала по умолчанию
По умолчанию AzCopy задает для уровня журнала значение INFO. Чтобы уменьшить детализацию журнала и сэкономить место на диске, используйте --log-level параметр для перезаписи этого параметра.
Доступные уровни журнала: DEBUG, INFO, WARNING, ERRORи NONE.
Удаление файлов плана и журнала
Чтобы удалить все файлы плана и журнала с локального компьютера и сэкономить место на диске, используйте azcopy jobs clean команду.
Чтобы удалить файлы плана и журнала только для одного задания, используйте azcopy jobs rm <job-id>. Замените заполнитель <job-id> в этом примере идентификатором задания.