Настроить, оптимизировать и устранение неполадок с AzCopyConfigure, optimize, and troubleshoot AzCopy

AzCopy — программа командной строки, который можно использовать для копирования больших двоичных объектов или файлов из учетной записи хранения.AzCopy is a command-line utility that you can use to copy blobs or files to or from a storage account. В этой статье объясняется, как выполнять задачи расширенной конфигурации и помогает устранять неполадки, которые могут возникнуть при использовании AzCopy.This article helps you to perform advanced configuration tasks and helps you to troubleshoot issues that can arise as you use AzCopy.

Примечание

Если вы ищете материалы и помочь вам приступить к работе с помощью AzCopy, см. в любой из следующих статей:If you're looking for content to help you get started with AzCopy, see any of the following articles:

Настройка параметров проксиConfigure proxy settings

Чтобы настроить параметры прокси-сервера для AzCopy, задать https_proxy переменной среды.To configure the proxy settings for AzCopy, set the https_proxy environment variable.

Операционная системаOperating system КомандаCommand
WindowsWindows В командной строке, используйте: set https_proxy=<proxy IP>:<proxy port>In a command prompt use: set https_proxy=<proxy IP>:<proxy port>
В PowerShell, введите команду: $env:https_proxy="<proxy IP>:<proxy port>"In PowerShell use: $env:https_proxy="<proxy IP>:<proxy port>"
LinuxLinux export https_proxy=<proxy IP>:<proxy port>
MacOSMacOS export https_proxy=<proxy IP>:<proxy port>

В настоящее время AzCopy не поддерживает прокси-серверов, требующих проверки подлинности с протоколом NTLM или Kerberos.Currently, AzCopy doesn't support proxies that require authentication with NTLM or Kerberos.

Оптимизация пропускной способностиOptimize throughput

Задайте AZCOPY_CONCURRENCY_VALUE переменной среды для настройки количество одновременных запросов, а также для управления пропускной способности производительность и потребление ресурсов.Set the AZCOPY_CONCURRENCY_VALUE environment variable to configure the number of concurrent requests, and to control the throughput performance and resource consumption. Если ваш компьютер имеет менее чем 5 ЦП, а затем значение этой переменной присваивается 32.If your computer has fewer than 5 CPUs, then the value of this variable is set to 32. В противном случае — значение по умолчанию равно 16, умноженное на количество процессоров.Otherwise, the default value is equal to 16 multiplied by the number of CPUs. По умолчанию максимальное значение этой переменной является 300, однако можно вручную задать это значение выше или ниже.The maximum default value of this variable is 300, but you can manually set this value higher or lower.

Операционная системаOperating system КомандаCommand
WindowsWindows set AZCOPY_CONCURRENCY_VALUE=<value>
LinuxLinux export AZCOPY_CONCURRENCY_VALUE=<value>
MacOSMacOS export AZCOPY_CONCURRENCY_VALUE=<value>

Используйте azcopy env для проверки текущего значения этой переменной.Use the azcopy env to check the current value of this variable. Если значение пусто, то AZCOPY_CONCURRENCY_VALUE переменной присваивается значение по умолчанию 300.If the value is blank, then the AZCOPY_CONCURRENCY_VALUE variable is set to the default value of 300.

Изменение расположения файлов журналаChange the location of the log files

По умолчанию файлы журналов находятся в %USERPROFILE\\.azcopy каталог на Windows или в $HOME\\.azcopy каталог в Mac и Linux.By default, log files are located in the %USERPROFILE\\.azcopy directory on Windows, or in the $HOME\\.azcopy directory on Mac and Linux. Это расположение можно изменить, если необходимо выполнить с помощью следующих команд.You can change this location if you need to by using these commands.

Операционная системаOperating system КомандаCommand
WindowsWindows set AZCOPY_LOG_LOCATION=<value>
LinuxLinux export AZCOPY_LOG_LOCATION=<value>
MacOSMacOS export AZCOPY_LOG_LOCATION=<value>

Используйте azcopy env для проверки текущего значения этой переменной.Use the azcopy env to check the current value of this variable. Если значение пусто, журналы записываются в расположение по умолчанию.If the value is blank, then logs are written to the default location.

Изменение уровня ведения журнала по умолчаниюChange the default log level

По умолчанию присваивается уровень ведения журнала AzCopy INFO.By default, AzCopy log level is set to INFO. Если вы хотите уменьшить уровень детализации журнала для экономии места на диске, перезаписать этот параметр с помощью --log-level параметр.If you would like to reduce the log verbosity to save disk space, overwrite this setting by using the --log-level option.

Уровни журнала доступны: DEBUG, INFO, WARNING, ERROR, PANIC, и FATAL.Available log levels are: DEBUG, INFO, WARNING, ERROR, PANIC, and FATAL.

Устранение неполадокTroubleshoot issues

AzCopy создает файлы журнала и план для каждого задания.AzCopy creates log and plan files for every job. Вы можете использовать журналы для исследования и устранения возможных проблем.You can use the logs to investigate and troubleshoot any potential problems.

Журналы будут содержать состояние сбоя (UPLOADFAILED, COPYFAILED, и DOWNLOADFAILED), полный путь, а также причина сбоя.The logs will contain the status of failure (UPLOADFAILED, COPYFAILED, and DOWNLOADFAILED), the full path, and the reason of the failure.

По умолчанию файлы журнала и план, находятся в %USERPROFILE\\.azcopy каталоге Windows или $HOME\\.azcopy каталог в Mac и Linux.By default, the log and plan files are located in the %USERPROFILE\\.azcopy directory on Windows or $HOME\\.azcopy directory on Mac and Linux.

Важно!

При отправке запроса поддержки Microsoft (или устранении неполадок, связанных с третьим лицам), совместно использовать исправленная версия версия команды, которую требуется выполнить.When submitting a request to Microsoft Support (or troubleshooting the issue involving any third party), share the redacted version of the command you want to execute. Это гарантирует, что подписанный URL-адрес не предоставлен случайно любой пользователь.This ensures the SAS isn't accidentally shared with anybody. Вы можете найти исправленную версию в начале файла журнала.You can find the redacted version at the start of the log file.

Проверка журналов на наличие ошибокReview the logs for errors

Следующая команда позволит получить все ошибки с UPLOADFAILED состояние из 04dc9ca9-158f-7945-5933-564021086c79 журнала:The following command will get all errors with UPLOADFAILED status from the 04dc9ca9-158f-7945-5933-564021086c79 log:

WindowsWindows

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

LinuxLinux

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

Просмотр и возобновление заданияView and resume jobs

В рамках каждой операции передачи будет создано задание AzCopy.Each transfer operation will create an AzCopy job. Чтобы просмотреть журнал заданий, используйте следующую команду:Use the following command to view the history of jobs:

azcopy jobs list

Чтобы просмотреть статистику задания, используйте следующую команду:To view the job statistics, use the following command:

azcopy jobs show <job-id>

Чтобы отфильтровать операции передачи по состоянию, используйте следующую команду:To filter the transfers by status, use the following command:

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

Используйте следующую команду, чтобы возобновить задание сбой или отменено.Use the following command to resume a failed/canceled job. Эта команда использует свой идентификатор, а также маркер SAS, так как оно не постоянное по соображениям безопасности:This command uses its identifier along with the SAS token as it isn't persistent for security reasons:

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

При возобновлении задания, AzCopy проверяет файл плана задания.When you resume a job, AzCopy looks at the job plan file. В файле плана перечислены все файлы, которые были определены для обработки при первом создании задания.The plan file lists all the files that were identified for processing when the job was first created. При возобновлении задания AzCopy будет предпринята попытка передачи, все файлы, которые перечислены в файле план, который уже не были перенесены.When you resume a job, AzCopy will attempt to transfer all of the files that are listed in the plan file which weren't already transferred.