az load test
Observação
Essa referência faz parte da extensão carregar para a CLI do Azure (versão 2.66.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az load test. Saiba mais sobre extensões.
Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus
Grupo de comandos para gerenciar testes de carga.
Grupo de comandos para gerenciar o teste de carga com criar, atualizar, excluir, listar, etc.
Comandos
Name | Description | Tipo | Status |
---|---|---|---|
az load test app-component |
Grupo de comandos para gerenciar componentes do aplicativo. |
Extensão | Previsualizar |
az load test app-component add |
Adicione um componente de aplicativo a um teste. |
Extensão | Previsualizar |
az load test app-component list |
Liste todos os componentes do aplicativo para um teste. |
Extensão | Previsualizar |
az load test app-component remove |
Remova o componente de aplicativo específico de um teste. |
Extensão | Previsualizar |
az load test compare-to-baseline |
Compare as estatísticas do amostrador de execuções de teste recentes com as da execução de teste de linha de base. |
Extensão | Previsualizar |
az load test convert-to-jmx |
Converta um teste de tipo de URL em teste JMX. |
Extensão | Previsualizar |
az load test create |
Crie um novo teste de carga. |
Extensão | Previsualizar |
az load test delete |
Exclua um teste de carga existente. |
Extensão | Previsualizar |
az load test download-files |
Baixar arquivos de um teste de carga existente. |
Extensão | Previsualizar |
az load test file |
Grupo de comandos para operações em arquivos de teste. |
Extensão | Previsualizar |
az load test file delete |
Exclua um arquivo do teste. |
Extensão | Previsualizar |
az load test file download |
Baixe um arquivo de um teste. |
Extensão | Previsualizar |
az load test file list |
Liste todos os arquivos em um teste. |
Extensão | Previsualizar |
az load test file upload |
Carregue um ficheiro para um teste. |
Extensão | Previsualizar |
az load test list |
Liste todos os testes no recurso de teste de carga fornecido. |
Extensão | Previsualizar |
az load test server-metric |
Grupo de comandos para gerenciar métricas do servidor. |
Extensão | Previsualizar |
az load test server-metric add |
Adicione uma métrica de servidor a um teste. |
Extensão | Previsualizar |
az load test server-metric list |
Liste todas as métricas do servidor para um teste. |
Extensão | Previsualizar |
az load test server-metric remove |
Remova a métrica de servidor fornecida do teste. |
Extensão | Previsualizar |
az load test set-baseline |
Defina uma execução de teste como a linha de base para comparação com outras execuções no teste. |
Extensão | Previsualizar |
az load test show |
Mostrar detalhes do teste. |
Extensão | Previsualizar |
az load test update |
Atualize um teste de carga existente. |
Extensão | Previsualizar |
az load test compare-to-baseline
O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus
Compare as estatísticas do amostrador de execuções de teste recentes com as da execução de teste de linha de base.
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]
Exemplos
Compare as execuções de teste recentes com a linha de base.
az load test compare-to-baseline --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id -o table
Compare as execuções de teste recentes com a linha de base com agregação específica.
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
Parâmetros Obrigatórios
Nome ou ID do recurso ARM do recurso Teste de Carga.
ID do teste de carga.
Parâmetros Opcionais
Especifique o método de agregação para o tempo de resposta.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az load test convert-to-jmx
O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus
Converta um teste de tipo de URL em teste JMX.
az load test convert-to-jmx --load-test-resource
--test-id
[--resource-group]
[--yes]
Exemplos
Converter para teste JMX.
az load test convert-to-jmx --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id
Parâmetros Obrigatórios
Nome ou ID do recurso ARM do recurso Teste de Carga.
ID do teste de carga.
Parâmetros Opcionais
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Não solicite confirmação.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az load test create
O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus
Crie um novo teste de carga.
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}]
Exemplos
Crie um teste com o arquivo de configuração de teste de carga.
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
Crie um teste com argumentos.
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
Crie um teste com o arquivo de configuração de teste de carga e substitua a instância do mecanismo e env usando argumentos e não espere pelo upload do arquivo.
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
Crie um teste com segredos e variáveis de ambiente.
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
Crie um teste com segredos usando a Identidade Gerenciada atribuída pelo usuário para acessar o Cofre da Chave.
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"
Crie um teste para um ponto de extremidade privado em uma Rede Virtual com a opção CSV dividida habilitada.
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
Crie um teste com critérios de parada automática personalizados ou habilite/desabilite a parada automática para um teste.
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
Crie um teste com uma configuração de carga de várias regiões usando nomes de região no formato aceito pelo Azure Resource Manager (ARM). Verifique se as regiões especificadas são suportadas pelo Teste de Carga do Azure. Os testes de carga de várias regiões são restritos apenas a pontos de extremidade públicos.
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
Crie um teste de URL avançado com várias solicitações HTTP usando um arquivo 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
Parâmetros Obrigatórios
Nome ou ID do recurso ARM do recurso Teste de Carga.
ID do teste de carga.
Parâmetros Opcionais
Se a paragem automática deve ser ativada ou desativada. Os valores permitidos são habilitados/desativados.
Porcentagem limite de erros nos quais a execução do teste deve ser interrompida automaticamente. Os valores permitidos estão no intervalo de [0,0,100.0].
Janela de tempo durante a qual a percentagem de erro deve ser avaliada em segundos.
Um único certificado no formato 'key[=value]'. O certificado deve ser armazenado no Cofre da Chave do Azure no formato PFX e o identificador do certificado deve ser fornecido como o valor.
Descrição do ensaio de carga.
Desative a implantação de um endereço IP público, balanceador de carga e grupo de segurança de rede enquanto testa um ponto de extremidade privado.
Nome de exibição do teste de carga.
Número de instâncias do motor em que o ensaio deve ser executado.
Variáveis de ambiente separadas por espaço: key[=value] [key[=value] ...].
A identidade que será usada para acessar o cofre de chaves.
Caminho para o arquivo de configuração de teste de carga. Consulte https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.
Não espere que a operação de longa duração termine.
Especifique a contagem de mecanismos para cada região no formato: region1=engineCount1 region2=engineCount2 .... Use nomes de região no formato aceito pelo Azure Resource Manager (ARM). Verifique se as regiões são suportadas pelo Teste de Carga do Azure. Os testes de carga de várias regiões só podem ter como alvo pontos de extremidade públicos.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Segredos separados por espaço: key[=value] [key[=value] ...]. Os segredos devem ser armazenados no Cofre da Chave do Azure e o identificador secreto deve ser fornecido como o valor.
Divida os arquivos CSV uniformemente entre as instâncias do mecanismo.
ID do recurso da sub-rede a ser usada para o teste de carga privada.
Referência ao arquivo de plano de teste. Se testType: JMX
: caminho para o script JMeter. Se testType: URL
: caminho para o arquivo JSON de solicitações.
Tipo de ensaio de carga.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az load test delete
O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus
Exclua um teste de carga existente.
az load test delete --load-test-resource
--test-id
[--resource-group]
[--yes]
Exemplos
Exclua um teste de carga.
az load test delete --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id
Parâmetros Obrigatórios
Nome ou ID do recurso ARM do recurso Teste de Carga.
ID do teste de carga.
Parâmetros Opcionais
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Não solicite confirmação.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az load test download-files
O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus
Baixar arquivos de um teste de carga existente.
az load test download-files --load-test-resource
--path
--test-id
[--force]
[--resource-group]
Exemplos
Faça o download de todos os arquivos de um teste. O diretório já deve existir.
az load test download-files --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --path ~/downloads
Baixe todos os arquivos de um teste criando o diretório, se ele não existir.
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
Parâmetros Obrigatórios
Nome ou ID do recurso ARM do recurso Teste de Carga.
Caminho do diretório para baixar arquivos.
ID do teste de carga.
Parâmetros Opcionais
Força executar o comando. Isso criará o diretório para baixar arquivos, se ele não existir.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az load test list
O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus
Liste todos os testes no recurso de teste de carga fornecido.
az load test list --load-test-resource
[--resource-group]
Exemplos
Liste todos os testes de carga em um recurso.
az load test list --load-test-resource sample-alt-resource --resource-group sample-rg
Parâmetros Obrigatórios
Nome ou ID do recurso ARM do recurso Teste de Carga.
Parâmetros Opcionais
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az load test set-baseline
O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus
Defina uma execução de teste como a linha de base para comparação com outras execuções no teste.
az load test set-baseline --load-test-resource
--test-id
--test-run-id
[--resource-group]
Exemplos
Defina a execução do teste de linha de base.
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
Parâmetros Obrigatórios
Nome ou ID do recurso ARM do recurso Teste de Carga.
ID do teste de carga.
ID da execução do teste de carga.
Parâmetros Opcionais
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az load test show
O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus
Mostrar detalhes do teste.
az load test show --load-test-resource
--test-id
[--resource-group]
Exemplos
Obtenha os detalhes de um teste de carga.
az load test show --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg
Parâmetros Obrigatórios
Nome ou ID do recurso ARM do recurso Teste de Carga.
ID do teste de carga.
Parâmetros Opcionais
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
az load test update
O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus
Atualize um teste de carga existente.
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]
Exemplos
Atualize um teste com o arquivo de configuração de teste de carga e não espere pelo upload do arquivo.
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
Atualize o nome para exibição e a descrição de um teste.
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"
Atualize um teste com o arquivo de configuração de teste de carga e substitua parâmetros usando argumentos.
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
Remova os segredos de um teste.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --secret secret_name1=""
Atualize a identidade de referência do Cofre da Chave para a Identidade Gerenciada atribuída ao sistema.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --keyvault-reference-id null
Atualize os critérios de parada automática.
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
Atualize a configuração de carga de várias regiões.
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
Parâmetros Obrigatórios
Nome ou ID do recurso ARM do recurso Teste de Carga.
ID do teste de carga.
Parâmetros Opcionais
Se a paragem automática deve ser ativada ou desativada. Os valores permitidos são habilitados/desativados.
Porcentagem limite de erros nos quais a execução do teste deve ser interrompida automaticamente. Os valores permitidos estão no intervalo de [0,0,100.0].
Janela de tempo durante a qual a percentagem de erro deve ser avaliada em segundos.
Um único certificado no formato 'key[=value]'. O certificado deve ser armazenado no Cofre da Chave do Azure no formato PFX e o identificador do certificado deve ser fornecido como o valor. Use "" para limpar o certificado existente.
Descrição do ensaio de carga.
Desative a implantação de um endereço IP público, balanceador de carga e grupo de segurança de rede enquanto testa um ponto de extremidade privado.
Nome de exibição do teste de carga.
Número de instâncias do motor em que o ensaio deve ser executado.
Variáveis de ambiente separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as variáveis de ambiente existentes.
A identidade que será usada para acessar o cofre de chaves. Forneça null
ou None
para usar a identidade atribuída ao sistema do recurso de teste de carga.
Caminho para o arquivo de configuração de teste de carga. Consulte https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.
Não espere que a operação de longa duração termine.
Especifique a contagem de mecanismos para cada região no formato: region1=engineCount1 region2=engineCount2 .... Use nomes de região no formato aceito pelo Azure Resource Manager (ARM). Verifique se as regiões são suportadas pelo Teste de Carga do Azure. Os testes de carga de várias regiões só podem ter como alvo pontos de extremidade públicos.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Segredos separados por espaço: key[=value] [key[=value] ...]. Os segredos devem ser armazenados no Cofre da Chave do Azure e o identificador secreto deve ser fornecido como o valor. Use "" para limpar segredos existentes.
Divida os arquivos CSV uniformemente entre as instâncias do mecanismo.
ID do recurso da sub-rede a ser usada para o teste de carga privada.
Referência ao arquivo de plano de teste. Se testType: JMX
: caminho para o script JMeter. Se testType: URL
: caminho para o arquivo JSON de solicitações.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.