az load test
Заметка
Эта ссылка входит в расширение загрузки для Azure CLI (версия 2.66.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az load test. Узнайте больше о расширениях.
Эта группа команд находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus
Группа команд для управления нагрузочных тестов.
Группа команд для управления нагрузочного теста с помощью создания, обновления, удаления, списка и т. д.
Команды
Имя | Описание | Тип | Состояние |
---|---|---|---|
az load test app-component |
Группа команд для управления компонентами приложения. |
Расширение | Предварительный просмотр |
az load test app-component add |
Добавьте компонент приложения в тест. |
Расширение | Предварительный просмотр |
az load test app-component list |
Список всех компонентов приложения для теста. |
Расширение | Предварительный просмотр |
az load test app-component remove |
Удалите заданный компонент приложения из теста. |
Расширение | Предварительный просмотр |
az load test compare-to-baseline |
Сравните статистику выборки из последних тестовых запусков с базовым запуском теста. |
Расширение | Предварительный просмотр |
az load test convert-to-jmx |
Преобразование теста типа URL-адреса в тест JMX. |
Расширение | Предварительный просмотр |
az load test create |
Создайте новый нагрузочный тест. |
Расширение | Предварительный просмотр |
az load test delete |
Удалите существующий нагрузочный тест. |
Расширение | Предварительный просмотр |
az load test download-files |
Скачайте файлы существующего нагрузочного теста. |
Расширение | Предварительный просмотр |
az load test file |
Группа команд для операций с тестовых файлами. |
Расширение | Предварительный просмотр |
az load test file delete |
Удаление файла из теста. |
Расширение | Предварительный просмотр |
az load test file download |
Скачайте файл из теста. |
Расширение | Предварительный просмотр |
az load test file list |
Вывод списка всех файлов в тесте. |
Расширение | Предварительный просмотр |
az load test file upload |
Отправьте файл в тест. |
Расширение | Предварительный просмотр |
az load test list |
Перечислить все тесты в заданном ресурсе нагрузочного теста. |
Расширение | Предварительный просмотр |
az load test server-metric |
Группа команд для управления метриками сервера. |
Расширение | Предварительный просмотр |
az load test server-metric add |
Добавьте серверную метрику в тест. |
Расширение | Предварительный просмотр |
az load test server-metric list |
Перечислить все метрики сервера для теста. |
Расширение | Предварительный просмотр |
az load test server-metric remove |
Удалите указанную метрику сервера из теста. |
Расширение | Предварительный просмотр |
az load test set-baseline |
Задайте тестовый запуск в качестве базового плана для сравнения с другими запусками в тесте. |
Расширение | Предварительный просмотр |
az load test show |
Отображение сведений о тесте. |
Расширение | Предварительный просмотр |
az load test update |
Обновите существующий нагрузочный тест. |
Расширение | Предварительный просмотр |
az load test compare-to-baseline
Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus
Сравните статистику выборки из последних тестовых запусков с базовым запуском теста.
az load test compare-to-baseline --load-test-resource
--test-id
[--aggregation {MAX, MEAN, MEDIAN, MIN, P75, P90, P95, P96, P98, P99, P999, P9999}]
[--resource-group]
Примеры
Сравните последние тестовые запуски с базовыми показателями.
az load test compare-to-baseline --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id -o table
Сравните последние тестовые запуски с базовыми показателями с конкретным агрегированием.
az load test compare-to-baseline --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --aggregation P95 -o table
Обязательные параметры
Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.
Идентификатор теста нагрузочного теста.
Необязательные параметры
Укажите метод агрегирования для времени отклика.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az load test convert-to-jmx
Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus
Преобразование теста типа URL-адреса в тест JMX.
az load test convert-to-jmx --load-test-resource
--test-id
[--resource-group]
[--yes]
Примеры
Преобразование в тест JMX.
az load test convert-to-jmx --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id
Обязательные параметры
Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.
Идентификатор теста нагрузочного теста.
Необязательные параметры
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Не запрашивайте подтверждение.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az load test create
Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus
Создайте новый нагрузочный тест.
az load test create --load-test-resource
--test-id
[--autostop]
[--autostop-error-rate]
[--autostop-time-window]
[--certificate]
[--description]
[--disable-public-ip]
[--display-name]
[--engine-instances]
[--env]
[--keyvault-reference-id]
[--load-test-config-file]
[--no-wait]
[--regionwise-engines]
[--resource-group]
[--secret]
[--split-csv]
[--subnet-id]
[--test-plan]
[--test-type {JMX, URL}]
Примеры
Создайте тест с файлом конфигурации нагрузочного теста.
az load test create --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-test-id --load-test-config-file ~/resources/sample-config.yaml
Создайте тест с аргументами.
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --description "Test description" --test-plan sample-jmx.jmx --engine-instances 1 --env rps=2 count=1
Создайте тест с файлом конфигурации нагрузочного теста и переопределите экземпляр ядра и env с помощью аргументов и не дождитесь отправки файла.
az load test create --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-test-id --load-test-config-file ~/resources/sample-config.yaml --engine-instances 1 --env rps=2 count=1 --no-wait
Создайте тест с помощью секретов и переменных среды.
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --description "Test description" --test-plan sample-jmx.jmx --secret secret_name1=secret_uri1 secret_name2=secret_uri2 --env rps=2 count=1
Создайте тест с секретами с помощью назначаемого пользователем управляемого удостоверения для доступа к Key Vault.
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --secret secret_name1=secret_uri1 secret_name2=secret_uri2 --keyvault-reference-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/microsoft.managedidentity/userassignedidentities/sample-mi"
Создайте тест для частной конечной точки в виртуальной сети с включенным параметром split CSV.
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --subnet-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.Network/virtualNetworks/SampleVMVNET/subnets/SampleVMSubnet" --split-csv true
Создайте тест с настраиваемыми критериями автостопирования или включите или отключите автостоп для теста.
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --autostop-error-rate 80.5 --autostop-time-window 120
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --autostop disable
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --autostop enable
Создайте тест с конфигурацией загрузки с несколькими регионами с помощью имен регионов в формате, принятом Azure Resource Manager (ARM). Убедитесь, что указанные регионы поддерживаются нагрузочном тестировании Azure. Нагрузочные тесты с несколькими регионами ограничены только общедоступными конечными точками.
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --engine-instances 3 --regionwise-engines eastus=1 westus2=1 germanywestcentral=1 --test-plan sample-jmx.jmx
Создайте расширенный тест URL-адресов с несколькими HTTP-запросами с помощью JSON-файла.
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --test-plan ~/resources/sample-url-requests.json --test-type URL
Обязательные параметры
Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.
Идентификатор теста нагрузочного теста.
Необязательные параметры
Следует ли включить или отключить автоматическую остановку. Допустимые значения : включить или отключить.
Пороговое значение ошибок, при которых тестовый запуск должен быть остановлен автоматически. Допустимые значения находятся в диапазоне [0,0,100,0].
Временное окно, в течение которого процент ошибок должен оцениваться в секундах.
Один сертификат в формате key[=value]. Сертификат должен храниться в Azure Key Vault в формате PFX, а идентификатор сертификата должен быть указан в качестве значения.
Описание нагрузочного теста.
Отключите развертывание общедоступного IP-адреса, подсистемы балансировки нагрузки и группы безопасности сети при тестировании частной конечной точки.
Отображаемое имя нагрузочного теста.
Количество экземпляров подсистемы, в которых должен выполняться тест.
Переменные среды, разделенные пробелами: key[=value] [key[=value] ...].
Удостоверение, которое будет использоваться для доступа к хранилищу ключей.
Путь к файлу конфигурации нагрузочного теста. См. https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.
Не дождитесь завершения длительной операции.
Укажите число обработчиков для каждого региона в формате: region1=engineCount1 region2=engineCount2 .... Используйте имена регионов в формате, принятом Azure Resource Manager (ARM). Убедитесь, что регионы поддерживаются нагрузочном тестировании Azure. Нагрузочные тесты с несколькими регионами могут использовать только общедоступные конечные точки.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Секреты, разделенные пробелами: key[=value] [key[=value] ...]. Секреты должны храниться в Azure Key Vault, а идентификатор секрета должен быть указан в качестве значения.
Разделение CSV-файлов равномерно между экземплярами ядра.
Идентификатор ресурса подсети, используемой для частного нагрузочного теста.
Ссылка на файл плана тестирования. Если testType: JMX
: путь к скрипту JMeter. Если testType: URL
: путь к JSON-файлу запросов.
Тип нагрузочного теста.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az load test delete
Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus
Удалите существующий нагрузочный тест.
az load test delete --load-test-resource
--test-id
[--resource-group]
[--yes]
Примеры
Удаление нагрузочного теста.
az load test delete --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id
Обязательные параметры
Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.
Идентификатор теста нагрузочного теста.
Необязательные параметры
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Не запрашивайте подтверждение.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az load test download-files
Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus
Скачайте файлы существующего нагрузочного теста.
az load test download-files --load-test-resource
--path
--test-id
[--force]
[--resource-group]
Примеры
Скачайте все файлы теста. Каталог уже должен существовать.
az load test download-files --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --path ~/downloads
Скачайте все файлы теста, создав каталог, если он не существует.
az load test download-files --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --path "~/downloads/new folder" --force
Обязательные параметры
Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.
Путь к каталогу для скачивания файлов.
Идентификатор теста нагрузочного теста.
Необязательные параметры
Принудительно выполните команду. При этом каталог будет создан для скачивания файлов, если он не существует.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az load test list
Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus
Перечислить все тесты в заданном ресурсе нагрузочного теста.
az load test list --load-test-resource
[--resource-group]
Примеры
Перечислить все нагрузочные тесты в ресурсе.
az load test list --load-test-resource sample-alt-resource --resource-group sample-rg
Обязательные параметры
Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.
Необязательные параметры
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az load test set-baseline
Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus
Задайте тестовый запуск в качестве базового плана для сравнения с другими запусками в тесте.
az load test set-baseline --load-test-resource
--test-id
--test-run-id
[--resource-group]
Примеры
Задайте базовый тестовый запуск.
az load test set-baseline --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --test-run-id sample-associated-test-run-id
Обязательные параметры
Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.
Идентификатор теста нагрузочного теста.
Идентификатор тестового запуска нагрузочного теста.
Необязательные параметры
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az load test show
Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus
Отображение сведений о тесте.
az load test show --load-test-resource
--test-id
[--resource-group]
Примеры
Получение сведений о нагрузочном тесте.
az load test show --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg
Обязательные параметры
Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.
Идентификатор теста нагрузочного теста.
Необязательные параметры
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az load test update
Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus
Обновите существующий нагрузочный тест.
az load test update --load-test-resource
--test-id
[--autostop]
[--autostop-error-rate]
[--autostop-time-window]
[--certificate]
[--description]
[--disable-public-ip]
[--display-name]
[--engine-instances]
[--env]
[--keyvault-reference-id]
[--load-test-config-file]
[--no-wait]
[--regionwise-engines]
[--resource-group]
[--secret]
[--split-csv]
[--subnet-id]
[--test-plan]
Примеры
Обновите тест с помощью файла конфигурации нагрузочного теста и не дождитесь отправки файлов.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --load-test-config-file ~/resources/sample-config.yaml --no-wait
Обновите отображаемое имя и описание теста.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --description "Test description" --display-name "Sample Name"
Обновите тест с помощью файла конфигурации нагрузочного теста и переопределите параметры с помощью аргументов.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --load-test-config-file ~/resources/sample-config.yaml --engine-instances 1 --env name=value name=value
Удалите секреты из теста.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --secret secret_name1=""
Обновите удостоверение ссылки key Vault на назначенное системой управляемое удостоверение.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --keyvault-reference-id null
Обновление условий автостопирования.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --autostop-error-rate 90 --autostop-time-window 180
Обновление конфигурации загрузки с несколькими регионами.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --engine-instances 5 --regionwise-engines eastus=2 westus2=1 eastasia=2
Обязательные параметры
Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.
Идентификатор теста нагрузочного теста.
Необязательные параметры
Следует ли включить или отключить автоматическую остановку. Допустимые значения : включить или отключить.
Пороговое значение ошибок, при которых тестовый запуск должен быть остановлен автоматически. Допустимые значения находятся в диапазоне [0,0,100,0].
Временное окно, в течение которого процент ошибок должен оцениваться в секундах.
Один сертификат в формате key[=value]. Сертификат должен храниться в Azure Key Vault в формате PFX, а идентификатор сертификата должен быть указан в качестве значения. Используйте "" для очистки существующего сертификата.
Описание нагрузочного теста.
Отключите развертывание общедоступного IP-адреса, подсистемы балансировки нагрузки и группы безопасности сети при тестировании частной конечной точки.
Отображаемое имя нагрузочного теста.
Количество экземпляров подсистемы, в которых должен выполняться тест.
Переменные среды, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих переменных среды.
Удостоверение, которое будет использоваться для доступа к хранилищу ключей. Предоставьте null
или None
использовать удостоверение, назначенное системой ресурса нагрузочного теста.
Путь к файлу конфигурации нагрузочного теста. См. https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.
Не дождитесь завершения длительной операции.
Укажите число обработчиков для каждого региона в формате: region1=engineCount1 region2=engineCount2 .... Используйте имена регионов в формате, принятом Azure Resource Manager (ARM). Убедитесь, что регионы поддерживаются нагрузочном тестировании Azure. Нагрузочные тесты с несколькими регионами могут использовать только общедоступные конечные точки.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Секреты, разделенные пробелами: key[=value] [key[=value] ...]. Секреты должны храниться в Azure Key Vault, а идентификатор секрета должен быть указан в качестве значения. Используйте "" для очистки существующих секретов.
Разделение CSV-файлов равномерно между экземплярами ядра.
Идентификатор ресурса подсети, используемой для частного нагрузочного теста.
Ссылка на файл плана тестирования. Если testType: JMX
: путь к скрипту JMeter. Если testType: URL
: путь к JSON-файлу запросов.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.