az load test
Nota
Esta referencia forma parte de la extensión de carga
Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Grupo de comandos para administrar pruebas de carga.
Grupo de comandos para administrar la prueba de carga con la creación, actualización, eliminación, lista, etc.
Comandos
Nombre | Description | Tipo | Estado |
---|---|---|---|
az load test app-component |
Grupo de comandos para administrar los componentes de la aplicación. |
Extensión | Vista previa |
az load test app-component add |
Agregue un componente de aplicación a una prueba. |
Extensión | Vista previa |
az load test app-component list |
Enumere todos los componentes de la aplicación para una prueba. |
Extensión | Vista previa |
az load test app-component remove |
Quite el componente de aplicación especificado de una prueba. |
Extensión | Vista previa |
az load test compare-to-baseline |
Compare las estadísticas del sampler de las ejecuciones de pruebas recientes con las de la ejecución de pruebas de línea base. |
Extensión | Vista previa |
az load test convert-to-jmx |
Convierta una prueba de tipo de dirección URL en prueba de JMX. |
Extensión | Vista previa |
az load test create |
Cree una nueva prueba de carga. |
Extensión | Vista previa |
az load test delete |
Elimine una prueba de carga existente. |
Extensión | Vista previa |
az load test download-files |
Descargue los archivos de una prueba de carga existente. |
Extensión | Vista previa |
az load test file |
Grupo de comandos para operaciones en archivos de prueba. |
Extensión | Vista previa |
az load test file delete |
Elimine un archivo de prueba. |
Extensión | Vista previa |
az load test file download |
Descargue un archivo de una prueba. |
Extensión | Vista previa |
az load test file list |
Enumera todos los archivos de una prueba. |
Extensión | Vista previa |
az load test file upload |
Cargue un archivo en una prueba. |
Extensión | Vista previa |
az load test list |
Enumere todas las pruebas del recurso de prueba de carga especificado. |
Extensión | Vista previa |
az load test server-metric |
Grupo de comandos para administrar las métricas del servidor. |
Extensión | Vista previa |
az load test server-metric add |
Agregue una métrica de servidor a una prueba. |
Extensión | Vista previa |
az load test server-metric list |
Enumere todas las métricas de servidor para una prueba. |
Extensión | Vista previa |
az load test server-metric remove |
Quite la métrica de servidor especificada de la prueba. |
Extensión | Vista previa |
az load test set-baseline |
Establezca una ejecución de prueba como línea base para la comparación con otras ejecuciones de la prueba. |
Extensión | Vista previa |
az load test show |
Muestra los detalles de la prueba. |
Extensión | Vista previa |
az load test update |
Actualice una prueba de carga existente. |
Extensión | Vista previa |
az load test compare-to-baseline
El grupo de comandos "prueba de carga" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Compare las estadísticas del sampler de las ejecuciones de pruebas recientes con las de la ejecución de pruebas de línea 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]
Ejemplos
Compare las ejecuciones de pruebas recientes con la línea 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 las ejecuciones de pruebas recientes con la línea base con una agregación 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 requeridos
Nombre o identificador de recurso de ARM del recurso Load Testing.
Id. de prueba de la prueba de carga.
Parámetros opcionales
Especifique el método de agregación para el tiempo de respuesta.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az load test convert-to-jmx
El grupo de comandos "prueba de carga" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Convierta una prueba de tipo de dirección URL en prueba de JMX.
az load test convert-to-jmx --load-test-resource
--test-id
[--resource-group]
[--yes]
Ejemplos
Convierta en prueba de 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 requeridos
Nombre o identificador de recurso de ARM del recurso Load Testing.
Id. de prueba de la prueba de carga.
Parámetros opcionales
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
No solicite confirmación.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az load test create
El grupo de comandos "prueba de carga" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Cree una nueva prueba 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}]
Ejemplos
Cree una prueba con el archivo de configuración de pruebas 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
Cree una prueba con 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
Cree una prueba con el archivo de configuración de prueba de carga e invalide engine-instance y env mediante argumentos y no espere a la carga de archivos.
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
Cree una prueba con secretos y variables de entorno.
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
Cree una prueba con secretos mediante la identidad administrada asignada por el usuario para acceder a 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"
Cree una prueba para un punto de conexión privado en una red virtual con la opción 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
Cree una prueba con criterios de autotop definidos personalizados o habilite o deshabilite la conmutación automática para una prueba.
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
Cree una prueba con una configuración de carga de varias regiones mediante nombres de región en el formato aceptado por Azure Resource Manager (ARM). Asegúrese de que Azure Load Testing admite las regiones especificadas. Las pruebas de carga de varias regiones solo están restringidas a puntos de conexión 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
Cree una prueba avanzada de direcciones URL con varias solicitudes HTTP mediante un archivo 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 requeridos
Nombre o identificador de recurso de ARM del recurso Load Testing.
Id. de prueba de la prueba de carga.
Parámetros opcionales
Indica si la detención automática debe estar habilitada o deshabilitada. Los valores permitidos son enable/disable.
Porcentaje de umbral de errores en los que se debe detener automáticamente la ejecución de pruebas. Los valores permitidos están en el intervalo de [0,0,100.0].
Período de tiempo durante el cual se debe evaluar el porcentaje de error en segundos.
Un solo certificado en formato 'key[=value]'. El certificado debe almacenarse en Azure Key Vault en formato PFX y el identificador de certificado debe proporcionarse como valor.
Descripción de la prueba de carga.
Deshabilite la implementación de una dirección IP pública, un equilibrador de carga y un grupo de seguridad de red al probar un punto de conexión privado.
Nombre para mostrar de la prueba de carga.
Número de instancias del motor en las que se debe ejecutar la prueba.
Variables de entorno separadas por espacios: key[=value] [key[=value] ...].
Identidad que se usará para acceder al almacén de claves.
Ruta de acceso al archivo de configuración de prueba de carga. Consulte https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.
No espere a que finalice la operación de ejecución prolongada.
Especifique el número de motores para cada región con el formato: region1=engineCount1 region2=engineCount2 .... Use los nombres de región en el formato aceptado por Azure Resource Manager (ARM). Asegúrese de que las regiones son compatibles con Azure Load Testing. Las pruebas de carga de varias regiones solo pueden tener como destino puntos de conexión públicos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Secretos separados por espacios: key[=value] [key[=value] ...]. Los secretos se deben almacenar en Azure Key Vault y el identificador del secreto debe proporcionarse como valor.
Dividir archivos CSV uniformemente entre instancias del motor.
Identificador de recurso de la subred que se va a usar para la prueba de carga privada.
Referencia al archivo del plan de prueba. Si testType: JMX
: ruta de acceso al script JMeter. Si testType: URL
: ruta de acceso al archivo JSON de solicitudes.
Tipo de la prueba de carga.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az load test delete
El grupo de comandos "prueba de carga" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Elimine una prueba de carga existente.
az load test delete --load-test-resource
--test-id
[--resource-group]
[--yes]
Ejemplos
Elimine una prueba de carga.
az load test delete --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id
Parámetros requeridos
Nombre o identificador de recurso de ARM del recurso Load Testing.
Id. de prueba de la prueba de carga.
Parámetros opcionales
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
No solicite confirmación.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az load test download-files
El grupo de comandos "prueba de carga" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Descargue los archivos de una prueba de carga existente.
az load test download-files --load-test-resource
--path
--test-id
[--force]
[--resource-group]
Ejemplos
Descargue todos los archivos de una prueba. El directorio ya debe existir.
az load test download-files --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --path ~/downloads
Descargue todos los archivos de una prueba mediante la creación del directorio si no existe.
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 requeridos
Nombre o identificador de recurso de ARM del recurso Load Testing.
Ruta de acceso del directorio para descargar archivos.
Id. de prueba de la prueba de carga.
Parámetros opcionales
Forzar la ejecución del comando. Esto creará el directorio para descargar archivos si no existe.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az load test list
El grupo de comandos "prueba de carga" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Enumere todas las pruebas del recurso de prueba de carga especificado.
az load test list --load-test-resource
[--resource-group]
Ejemplos
Enumere todas las pruebas de carga de un recurso.
az load test list --load-test-resource sample-alt-resource --resource-group sample-rg
Parámetros requeridos
Nombre o identificador de recurso de ARM del recurso Load Testing.
Parámetros opcionales
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az load test set-baseline
El grupo de comandos "prueba de carga" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Establezca una ejecución de prueba como línea base para la comparación con otras ejecuciones de la prueba.
az load test set-baseline --load-test-resource
--test-id
--test-run-id
[--resource-group]
Ejemplos
Establezca la ejecución de pruebas de línea 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 requeridos
Nombre o identificador de recurso de ARM del recurso Load Testing.
Id. de prueba de la prueba de carga.
Identificador de ejecución de prueba de la ejecución de pruebas de carga.
Parámetros opcionales
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az load test show
El grupo de comandos "prueba de carga" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Muestra los detalles de la prueba.
az load test show --load-test-resource
--test-id
[--resource-group]
Ejemplos
Obtenga los detalles de una prueba de carga.
az load test show --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg
Parámetros requeridos
Nombre o identificador de recurso de ARM del recurso Load Testing.
Id. de prueba de la prueba de carga.
Parámetros opcionales
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az load test update
El grupo de comandos "prueba de carga" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus
Actualice una prueba 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]
Ejemplos
Actualice una prueba con el archivo de configuración de prueba de carga y no espere a la carga de archivos.
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
Actualice el nombre para mostrar y la descripción de una prueba.
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"
Actualice una prueba con el archivo de configuración de pruebas de carga e invalide los parámetros mediante 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
Quite los secretos de una prueba.
az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --secret secret_name1=""
Actualice la identidad de referencia de Key Vault a la identidad administrada asignada por el 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
Actualice los criterios de autotop.
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
Actualice la configuración de carga de varias regiones.
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 requeridos
Nombre o identificador de recurso de ARM del recurso Load Testing.
Id. de prueba de la prueba de carga.
Parámetros opcionales
Indica si la detención automática debe estar habilitada o deshabilitada. Los valores permitidos son enable/disable.
Porcentaje de umbral de errores en los que se debe detener automáticamente la ejecución de pruebas. Los valores permitidos están en el intervalo de [0,0,100.0].
Período de tiempo durante el cual se debe evaluar el porcentaje de error en segundos.
Un solo certificado en formato 'key[=value]'. El certificado debe almacenarse en Azure Key Vault en formato PFX y el identificador de certificado debe proporcionarse como valor. Use "" para borrar el certificado existente.
Descripción de la prueba de carga.
Deshabilite la implementación de una dirección IP pública, un equilibrador de carga y un grupo de seguridad de red al probar un punto de conexión privado.
Nombre para mostrar de la prueba de carga.
Número de instancias del motor en las que se debe ejecutar la prueba.
Variables de entorno separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las variables de entorno existentes.
Identidad que se usará para acceder al almacén de claves. Proporcione null
o None
para usar la identidad asignada por el sistema del recurso de prueba de carga.
Ruta de acceso al archivo de configuración de prueba de carga. Consulte https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.
No espere a que finalice la operación de ejecución prolongada.
Especifique el número de motores para cada región con el formato: region1=engineCount1 region2=engineCount2 .... Use los nombres de región en el formato aceptado por Azure Resource Manager (ARM). Asegúrese de que las regiones son compatibles con Azure Load Testing. Las pruebas de carga de varias regiones solo pueden tener como destino puntos de conexión públicos.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>
.
Secretos separados por espacios: key[=value] [key[=value] ...]. Los secretos se deben almacenar en Azure Key Vault y el identificador del secreto debe proporcionarse como valor. Use "" para borrar los secretos existentes.
Dividir archivos CSV uniformemente entre instancias del motor.
Identificador de recurso de la subred que se va a usar para la prueba de carga privada.
Referencia al archivo del plan de prueba. Si testType: JMX
: ruta de acceso al script JMeter. Si testType: URL
: ruta de acceso al archivo JSON de solicitudes.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.