az load test
Nota
Questo riferimento fa parte dell'estensione caricamento per l'interfaccia della riga di comando di Azure (versione 2.66.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az load test
Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Gruppo di comandi per gestire i test di carico.
Gruppo di comandi per gestire il test di carico con creazione, aggiornamento, eliminazione, elenco e così via.
Comandi
Nome | Descrizione | Tipo | Status |
---|---|---|---|
az load test app-component |
Gruppo di comandi per gestire i componenti dell'app. |
Estensione | Anteprima |
az load test app-component add |
Aggiungere un componente dell'app a un test. |
Estensione | Anteprima |
az load test app-component list |
Elencare tutti i componenti dell'app per un test. |
Estensione | Anteprima |
az load test app-component remove |
Rimuovere il componente dell'app specificato da un test. |
Estensione | Anteprima |
az load test compare-to-baseline |
Confrontare le statistiche del campionatore dalle esecuzioni di test recenti con quelle dell'esecuzione del test di base. |
Estensione | Anteprima |
az load test convert-to-jmx |
Convertire un test di tipo URL in test JMX. |
Estensione | Anteprima |
az load test create |
Creare un nuovo test di carico. |
Estensione | Anteprima |
az load test delete |
Eliminare un test di carico esistente. |
Estensione | Anteprima |
az load test download-files |
Scaricare i file di un test di carico esistente. |
Estensione | Anteprima |
az load test file |
Gruppo di comandi per le operazioni sui file di test. |
Estensione | Anteprima |
az load test file delete |
Eliminare un file dal test. |
Estensione | Anteprima |
az load test file download |
Scaricare un file da un test. |
Estensione | Anteprima |
az load test file list |
Elencare tutti i file in un test. |
Estensione | Anteprima |
az load test file upload |
Caricare un file in un test. |
Estensione | Anteprima |
az load test list |
Elencare tutti i test nella risorsa test di carico specificata. |
Estensione | Anteprima |
az load test server-metric |
Gruppo di comandi per gestire le metriche del server. |
Estensione | Anteprima |
az load test server-metric add |
Aggiungere una metrica server a un test. |
Estensione | Anteprima |
az load test server-metric list |
Elencare tutte le metriche del server per un test. |
Estensione | Anteprima |
az load test server-metric remove |
Rimuovere la metrica server specificata dal test. |
Estensione | Anteprima |
az load test set-baseline |
Impostare un'esecuzione di test come baseline per il confronto con altre esecuzioni nel test. |
Estensione | Anteprima |
az load test show |
Mostra i dettagli del test. |
Estensione | Anteprima |
az load test update |
Aggiornare un test di carico esistente. |
Estensione | Anteprima |
az load test compare-to-baseline
Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Confrontare le statistiche del campionatore dalle esecuzioni di test recenti con quelle dell'esecuzione del test di 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]
Esempio
Confrontare le esecuzioni di test recenti con la baseline.
az load test compare-to-baseline --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id -o table
Confrontare le esecuzioni di test recenti con la baseline con un'aggregazione specifica.
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
Parametri necessari
Nome o ID risorsa ARM della risorsa test di carico.
ID test del test di carico.
Parametri facoltativi
Specificare il metodo di aggregazione per il tempo di risposta.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az load test convert-to-jmx
Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Convertire un test di tipo URL in test JMX.
az load test convert-to-jmx --load-test-resource
--test-id
[--resource-group]
[--yes]
Esempio
Convertire in test JMX.
az load test convert-to-jmx --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id
Parametri necessari
Nome o ID risorsa ARM della risorsa test di carico.
ID test del test di carico.
Parametri facoltativi
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Non richiedere conferma.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az load test create
Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Creare un nuovo test di carico.
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}]
Esempio
Creare un test con il file di configurazione del test di carico.
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
Creare un test con argomenti.
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
Creare un test con il file di configurazione del test di carico ed eseguire l'override dell'istanza del motore e di env usando argomenti e non attendere il caricamento dei file.
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
Creare un test con segreti e variabili di 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
Creare un test con segreti usando l'identità gestita assegnata dall'utente per accedere all'insieme di credenziali delle chiavi.
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"
Creare un test per un endpoint privato in una rete virtuale con l'opzione split CSV abilitata.
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
Creare un test con criteri di top automatici definiti personalizzati o abilitare/disabilitare l'autostop per un test.
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
Creare un test con una configurazione di carico in più aree usando i nomi delle aree nel formato accettato da Azure Resource Manager (ARM). Verificare che le aree specificate siano supportate dal test di carico di Azure. I test di carico in più aree sono limitati solo agli endpoint pubblici.
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
Creare un test dell'URL avanzato con più richieste HTTP usando un file 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
Parametri necessari
Nome o ID risorsa ARM della risorsa test di carico.
ID test del test di carico.
Parametri facoltativi
Indica se l'arresto automatico deve essere abilitato o disabilitato. I valori consentiti sono abilita/disabilita.
Percentuale di soglie di errori in cui l'esecuzione del test deve essere arrestata automaticamente. I valori consentiti sono compresi nell'intervallo [0,0,100,0].
Intervallo di tempo durante il quale la percentuale di errore deve essere valutata in secondi.
Un singolo certificato in formato 'key[=value]'. Il certificato deve essere archiviato in Azure Key Vault in formato PFX e l'identificatore del certificato deve essere fornito come valore.
Descrizione del test di carico.
Disabilitare la distribuzione di un indirizzo IP pubblico, di un servizio di bilanciamento del carico e di un gruppo di sicurezza di rete durante il test di un endpoint privato.
Nome visualizzato del test di carico.
Numero di istanze del motore in cui deve essere eseguito il test.
Variabili di ambiente separate da spazi: key[=value] [key[=value] ...].
Identità che verrà usata per accedere all'insieme di credenziali delle chiavi.
Percorso del file di configurazione del test di carico. Fare riferimento a https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.
Non attendere il completamento dell'operazione a esecuzione prolungata.
Specificare il numero di motori per ogni area nel formato: region1=engineCount1 region2=engineCount2 .... Usare i nomi delle aree nel formato accettato da Azure Resource Manager (ARM). Verificare che le aree siano supportate da Test di carico di Azure. I test di carico in più aree possono essere destinati solo agli endpoint pubblici.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Segreti separati da spazi: key[=value] [key[=value] ...]. I segreti devono essere archiviati in Azure Key Vault e l'identificatore del segreto deve essere specificato come valore.
Suddividere i file CSV in modo uniforme tra le istanze del motore.
ID risorsa della subnet da usare per il test di carico privato.
Riferimento al file del piano di test. Se testType: JMX
: percorso dello script JMeter. Se testType: URL
: percorso del file JSON delle richieste.
Tipo del test di carico.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az load test delete
Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Eliminare un test di carico esistente.
az load test delete --load-test-resource
--test-id
[--resource-group]
[--yes]
Esempio
Eliminare un test di carico.
az load test delete --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id
Parametri necessari
Nome o ID risorsa ARM della risorsa test di carico.
ID test del test di carico.
Parametri facoltativi
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Non richiedere conferma.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az load test download-files
Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Scaricare i file di un test di carico esistente.
az load test download-files --load-test-resource
--path
--test-id
[--force]
[--resource-group]
Esempio
Scaricare tutti i file di un test. La directory dovrebbe già esistere.
az load test download-files --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --path ~/downloads
Scaricare tutti i file di un test creando la directory se non esiste.
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
Parametri necessari
Nome o ID risorsa ARM della risorsa test di carico.
Percorso della directory per scaricare i file.
ID test del test di carico.
Parametri facoltativi
Forzare l'esecuzione del comando. Verrà creata la directory per scaricare i file, se non esiste.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az load test list
Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Elencare tutti i test nella risorsa test di carico specificata.
az load test list --load-test-resource
[--resource-group]
Esempio
Elencare tutti i test di carico in una risorsa.
az load test list --load-test-resource sample-alt-resource --resource-group sample-rg
Parametri necessari
Nome o ID risorsa ARM della risorsa test di carico.
Parametri facoltativi
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az load test set-baseline
Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Impostare un'esecuzione di test come baseline per il confronto con altre esecuzioni nel test.
az load test set-baseline --load-test-resource
--test-id
--test-run-id
[--resource-group]
Esempio
Impostare l'esecuzione dei test di 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
Parametri necessari
Nome o ID risorsa ARM della risorsa test di carico.
ID test del test di carico.
ID esecuzione test dell'esecuzione del test di carico.
Parametri facoltativi
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az load test show
Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Mostra i dettagli del test.
az load test show --load-test-resource
--test-id
[--resource-group]
Esempio
Ottenere i dettagli di un test di carico.
az load test show --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg
Parametri necessari
Nome o ID risorsa ARM della risorsa test di carico.
ID test del test di carico.
Parametri facoltativi
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az load test update
Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Aggiornare un test di carico esistente.
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]
Esempio
Aggiornare un test con il file di configurazione del test di carico e non attendere il caricamento del file.
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
Aggiornare il nome visualizzato e la descrizione per un test.
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"
Aggiornare un test con il file di configurazione del test di carico ed eseguire l'override dei parametri usando gli argomenti.
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
Rimuovere i segreti da un test.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --secret secret_name1=""
Aggiornare l'identità di riferimento di Key Vault all'identità gestita assegnata dal 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
Aggiornare i criteri di aggiornamento automatico.
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
Aggiornare la configurazione del carico in più aree.
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
Parametri necessari
Nome o ID risorsa ARM della risorsa test di carico.
ID test del test di carico.
Parametri facoltativi
Indica se l'arresto automatico deve essere abilitato o disabilitato. I valori consentiti sono abilita/disabilita.
Percentuale di soglie di errori in cui l'esecuzione del test deve essere arrestata automaticamente. I valori consentiti sono compresi nell'intervallo [0,0,100,0].
Intervallo di tempo durante il quale la percentuale di errore deve essere valutata in secondi.
Un singolo certificato in formato 'key[=value]'. Il certificato deve essere archiviato in Azure Key Vault in formato PFX e l'identificatore del certificato deve essere fornito come valore. Usare "" per cancellare il certificato esistente.
Descrizione del test di carico.
Disabilitare la distribuzione di un indirizzo IP pubblico, di un servizio di bilanciamento del carico e di un gruppo di sicurezza di rete durante il test di un endpoint privato.
Nome visualizzato del test di carico.
Numero di istanze del motore in cui deve essere eseguito il test.
Variabili di ambiente separate da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare le variabili di ambiente esistenti.
Identità che verrà usata per accedere all'insieme di credenziali delle chiavi. Specificare null
o None
per usare l'identità assegnata dal sistema della risorsa di test di carico.
Percorso del file di configurazione del test di carico. Fare riferimento a https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.
Non attendere il completamento dell'operazione a esecuzione prolungata.
Specificare il numero di motori per ogni area nel formato: region1=engineCount1 region2=engineCount2 .... Usare i nomi delle aree nel formato accettato da Azure Resource Manager (ARM). Verificare che le aree siano supportate da Test di carico di Azure. I test di carico in più aree possono essere destinati solo agli endpoint pubblici.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Segreti separati da spazi: key[=value] [key[=value] ...]. I segreti devono essere archiviati in Azure Key Vault e l'identificatore del segreto deve essere specificato come valore. Usare "" per cancellare i segreti esistenti.
Suddividere i file CSV in modo uniforme tra le istanze del motore.
ID risorsa della subnet da usare per il test di carico privato.
Riferimento al file del piano di test. Se testType: JMX
: percorso dello script JMeter. Se testType: URL
: percorso del file JSON delle richieste.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.