az load test
Nota
Essa referência faz parte da extensão de carga
Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: 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
Nome | Description | Tipo | Status |
---|---|---|---|
az load test app-component |
Grupo de comandos para gerenciar componentes do aplicativo. |
Extensão | Visualizar |
az load test app-component add |
Adicione um componente de aplicativo a um teste. |
Extensão | Visualizar |
az load test app-component list |
Liste todos os componentes do aplicativo para um teste. |
Extensão | Visualizar |
az load test app-component remove |
Remova o componente de aplicativo especificado de um teste. |
Extensão | Visualizar |
az load test compare-to-baseline |
Compare as estatísticas do sampler de execuções de teste recentes com as da execução do teste de linha de base. |
Extensão | Visualizar |
az load test convert-to-jmx |
Converter um teste de tipo de URL em teste JMX. |
Extensão | Visualizar |
az load test create |
Crie um novo teste de carga. |
Extensão | Visualizar |
az load test delete |
Exclua um teste de carga existente. |
Extensão | Visualizar |
az load test download-files |
Baixe arquivos de um teste de carga existente. |
Extensão | Visualizar |
az load test file |
Grupo de comandos para operações em arquivos de teste. |
Extensão | Visualizar |
az load test file delete |
Exclua um arquivo do teste. |
Extensão | Visualizar |
az load test file download |
Baixe um arquivo de um teste. |
Extensão | Visualizar |
az load test file list |
Listar todos os arquivos em um teste. |
Extensão | Visualizar |
az load test file upload |
Carregue um arquivo em um teste. |
Extensão | Visualizar |
az load test list |
Liste todos os testes no recurso de teste de carga especificado. |
Extensão | Visualizar |
az load test server-metric |
Grupo de comandos para gerenciar métricas de servidor. |
Extensão | Visualizar |
az load test server-metric add |
Adicione uma métrica de servidor a um teste. |
Extensão | Visualizar |
az load test server-metric list |
Liste todas as métricas do servidor para um teste. |
Extensão | Visualizar |
az load test server-metric remove |
Remova a métrica de servidor fornecida do teste. |
Extensão | Visualizar |
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 | Visualizar |
az load test show |
Mostrar detalhes do teste. |
Extensão | Visualizar |
az load test update |
Atualize um teste de carga existente. |
Extensão | Visualizar |
az load test compare-to-baseline
O grupo de comandos 'teste de carga' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Compare as estatísticas do sampler de execuções de teste recentes com as da execução do 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 a 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 Exigidos
Nome ou ID de recurso do ARM do recurso teste de carga.
ID de teste 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 Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
az load test convert-to-jmx
O grupo de comandos 'teste de carga' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Converter 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 em 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 Exigidos
Nome ou ID de recurso do ARM do recurso teste de carga.
ID de teste 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 Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
az load test create
O grupo de comandos 'teste de carga' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: 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 o env usando argumentos e não aguarde o upload de 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 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"
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 autoestop definidos personalizados ou habilite/desabilite a autoestop 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 ARM (Azure Resource Manager). Verifique se as regiões especificadas têm suporte no Teste de Carga do Azure. Testes de carga de várias regiões são restritos somente 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 Exigidos
Nome ou ID de recurso do ARM do recurso teste de carga.
ID de teste do teste de carga.
Parâmetros Opcionais
Se a parada automática deve ser habilitada ou desabilitada. Os valores permitidos são habilitados/desabilitados.
Percentual de limite de erros nos quais a execução de teste deve ser interrompida automaticamente. Os valores permitidos estão no intervalo de [0,0,100,0].
Janela de tempo durante a qual a porcentagem de erros deve ser avaliada em segundos.
Um único certificado no formato 'key[=value]'. O certificado deve ser armazenado no Azure Key Vault no formato PFX e o identificador de certificado deve ser fornecido como o valor.
Descrição do teste de carga.
Desabilite a implantação de um endereço IP público, balanceador de carga e grupo de segurança de rede ao testar um ponto de extremidade privado.
Nome de exibição do teste de carga.
Número de instâncias do mecanismo nas quais o teste 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 aguarde a conclusão da operação de execução prolongada.
Especifique a contagem de mecanismos para cada região no formato: region1=engineCount1 region2=engineCount2 .... Use nomes de região no formato aceito pelo ARM (Azure Resource Manager). Verifique se as regiões têm suporte no Teste de Carga do Azure. Testes de carga de várias regiões só podem direcionar 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 Azure Key Vault e o identificador de segredo deve ser fornecido como o valor.
Dividir arquivos CSV uniformemente entre instâncias do mecanismo.
ID do recurso da sub-rede a ser usada para teste de carga privado.
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 do teste de carga.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
az load test delete
O grupo de comandos 'teste de carga' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Exclua um teste de carga existente.
az load test delete --load-test-resource
--test-id
[--resource-group]
[--yes]
Exemplos
Excluir 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 Exigidos
Nome ou ID de recurso do ARM do recurso teste de carga.
ID de teste 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 Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
az load test download-files
O grupo de comandos 'teste de carga' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Baixe arquivos de um teste de carga existente.
az load test download-files --load-test-resource
--path
--test-id
[--force]
[--resource-group]
Exemplos
Baixe 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 Exigidos
Nome ou ID de recurso do ARM do recurso teste de carga.
Caminho do diretório para baixar arquivos.
ID de teste do teste de carga.
Parâmetros Opcionais
Force a execução do 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 Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
az load test list
O grupo de comandos 'teste de carga' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Liste todos os testes no recurso de teste de carga especificado.
az load test list --load-test-resource
[--resource-group]
Exemplos
Listar todos os testes de carga em um recurso.
az load test list --load-test-resource sample-alt-resource --resource-group sample-rg
Parâmetros Exigidos
Nome ou ID de recurso do 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 Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
az load test set-baseline
O grupo de comandos 'teste de carga' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: 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
Definir 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 Exigidos
Nome ou ID de recurso do ARM do recurso teste de carga.
ID de teste do teste de carga.
ID de execução de teste 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 Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
az load test show
O grupo de comandos 'teste de carga' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos
Nome ou ID de recurso do ARM do recurso teste de carga.
ID de teste 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 Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
az load test update
O grupo de comandos 'teste de carga' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: 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 aguarde o 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 de 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 os 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 Key Vault para a Identidade Gerenciada atribuída pelo 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 autoestop.
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 Exigidos
Nome ou ID de recurso do ARM do recurso teste de carga.
ID de teste do teste de carga.
Parâmetros Opcionais
Se a parada automática deve ser habilitada ou desabilitada. Os valores permitidos são habilitados/desabilitados.
Percentual de limite de erros nos quais a execução de teste deve ser interrompida automaticamente. Os valores permitidos estão no intervalo de [0,0,100,0].
Janela de tempo durante a qual a porcentagem de erros deve ser avaliada em segundos.
Um único certificado no formato 'key[=value]'. O certificado deve ser armazenado no Azure Key Vault no formato PFX e o identificador de certificado deve ser fornecido como o valor. Use "" para limpar o certificado existente.
Descrição do teste de carga.
Desabilite a implantação de um endereço IP público, balanceador de carga e grupo de segurança de rede ao testar um ponto de extremidade privado.
Nome de exibição do teste de carga.
Número de instâncias do mecanismo nas quais o teste deve ser executado.
Variáveis de ambiente separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar 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 pelo 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 aguarde a conclusão da operação de execução prolongada.
Especifique a contagem de mecanismos para cada região no formato: region1=engineCount1 region2=engineCount2 .... Use nomes de região no formato aceito pelo ARM (Azure Resource Manager). Verifique se as regiões têm suporte no Teste de Carga do Azure. Testes de carga de várias regiões só podem direcionar 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 Azure Key Vault e o identificador de segredo deve ser fornecido como o valor. Use "" para limpar os segredos existentes.
Dividir arquivos CSV uniformemente entre instâncias do mecanismo.
ID do recurso da sub-rede a ser usada para teste de carga privado.
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 Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
Mostre esta mensagem de ajuda e saia.
Apenas mostrar 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.