Configuración de una prueba de carga en YAML

Aprenda a configurar la prueba de carga en Azure Load Testing mediante YAML. Use el archivo YAML de configuración de prueba para crear y ejecutar pruebas de carga desde el flujo de trabajo de integración continua y entrega continua (CI/CD).

Sintaxis de YAML de prueba de carga

Una configuración de prueba de carga usa las siguientes claves:

Ejemplo de configuración de pruebas de carga

El fragmento de código YAML siguiente contiene una configuración de prueba de carga de ejemplo.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.jmx
testType: JMX
engineInstances: 1
subnetId: /subscriptions/abcdef01-2345-6789-0abc-def012345678/resourceGroups/sample-rg/providers/Microsoft.Network/virtualNetworks/load-testing-vnet/subnets/load-testing
configurationFiles:
  - 'sampledata.csv'
zipArtifacts:
   - bigdata.zip
splitAllCSVs: True
failureCriteria:
  - avg(response_time_ms) > 300
  - percentage(error) > 50
  - GetCustomerDetails: avg(latency) >200
autoStop:
  errorPercentage: 80
  timeWindow: 60
secrets:
  - name: my-secret
    value: https://akv-contoso.vault.azure.net/secrets/MySecret/abc1234567890def12345
keyVaultReferenceIdentity: /subscriptions/abcdef01-2345-6789-0abc-def012345678/resourceGroups/sample-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sample-identity

Configuración de failureCriteria

Los criterios de error de prueba permiten definir condiciones para determinar si una ejecución de prueba de carga se realizó correctamente o no. Si se cumplen uno o varios criterios de error, la prueba obtiene un resultado de prueba con error. Obtenga más información sobre el uso de criterios de error de prueba de carga.

Puede definir criterios de error que se aplican a toda la prueba de carga o que se aplican a una solicitud específica. Los criterios de error tienen la siguiente estructura:

• Criterios de prueba en el nivel de prueba de carga: Aggregate_function (client_metric) condition threshold.
• Criterios de prueba aplicados a solicitudes de JMeter específicas: Request: Aggregate_function (client_metric) condition threshold.

Métricas de cliente admitidas

Azure Load Testing admite las siguientes métricas de cliente:

Ejemplo de configuración de criterios de error

El fragmento de código siguiente muestra una configuración de prueba de carga, que tiene tres criterios de error de prueba de carga.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.jmx
testType: JMX
engineInstances: 1
failureCriteria:
  - avg(response_time_ms) > 300
  - percentage(error) > 50
  - GetCustomerDetails: avg(latency) >200

Configuración de autoStop

La funcionalidad de autotop de prueba de carga permite detener automáticamente una prueba de carga cuando el porcentaje de error supera un umbral específico durante un período de tiempo determinado. Obtenga más información sobre la funcionalidad de autotop de pruebas de carga.

Ejemplo de configuración de autotop

El fragmento de código siguiente muestra una configuración de prueba de carga, que tiene tres criterios de error de prueba de carga.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.jmx
testType: JMX
engineInstances: 1
autoStop:
  errorPercentage: 80
  timeWindow: 60

Configuración de properties

Puede especificar un archivo de propiedades de usuario de JMeter para la prueba de carga. El archivo de propiedades de usuario se carga junto con el plan de prueba y otros archivos. Obtenga más información sobre el uso de las propiedades de usuario de JMeter en Azure Load Testing.

Ejemplo de configuración de archivo de propiedad de usuario

El siguiente fragmento de código muestra una configuración de prueba de carga, que especifica un archivo de propiedades de usuario.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.jmx
testType: JMX
engineInstances: 1
properties:
  userPropertyFile: 'user.properties'

El siguiente fragmento de código muestra una configuración de prueba de carga, que especifica un archivo de configuración de Locust.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.py
testType: Locust
engineInstances: 1
properties:
  userPropertyFile: 'locust.conf'

Configuración de secrets

Puede almacenar valores secretos en Azure Key Vault y hacer referencia a ellos en el plan de prueba. Obtenga más información sobre el uso de secretos con Azure Load Testing.

Ejemplo de configuración de secretos

El siguiente fragmento de código muestra una configuración de prueba de carga, que hace referencia a un secreto my-secret en Azure Key Vault.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.jmx
testType: JMX
engineInstances: 1
secrets:
  - name: my-secret
    value: https://akv-contoso.vault.azure.net/secrets/MySecret/abc1234567890def12345

Configuración de env

Puede especificar variables de entorno y hacer referencia a ellas en el plan de prueba. Obtenga más información sobre el uso de variables de entorno con Azure Load Testing.

Ejemplo de configuración de variables de entorno

El fragmento de código siguiente muestra una configuración de prueba de carga, que especifica una variable my-variable de entorno y un valor my-value.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.jmx
testType: JMX
engineInstances: 1
env:
  - name: my-variable
    value: my-value

Configuración de certificates

Puede pasar certificados de cliente a la prueba de carga. El certificado se almacena en Azure Key Vault. Obtenga más información sobre el uso de certificados de cliente con Azure Load Testing.

Ejemplo de configuración de certificado

El siguiente fragmento de código muestra una configuración de prueba de carga, que hace referencia a un certificado de cliente en Azure Key Vault.

version: v0.1
testId: SampleTest
displayName: Sample Test
description: Load test website home page
testPlan: SampleTest.jmx
testType: JMX
engineInstances: 1
certificates:
  - name: my-certificate
    value: https://akv-contoso.vault.azure.net/certificates/MyCertificate/abc1234567890def12345

Solicitudes de archivo JSON

Si usa una prueba basada en direcciones URL, puede especificar las solicitudes HTTP en un archivo JSON en lugar de usar un script de prueba de JMeter. Asegúrese de establecer en testType URL en el archivo YAML de configuración de prueba y haga referencia al archivo JSON de solicitudes.

Solicitudes HTTP

El archivo JSON de solicitudes usa las siguientes propiedades para definir solicitudes en la requests propiedad :

El siguiente fragmento de código JSON contiene un archivo JSON de solicitud de ejemplo:

{
    "version": "1.0",
    "scenarios": {
        "requestGroup1": {
            "requests": [
                {
                    "requestName": "add",
                    "responseVariables": [],
                    "queryParameters": [
                        {
                            "key": "param1",
                            "value": "value1"
                        }
                    ],
                    "requestType": "URL",
                    "endpoint": "https://www.contoso.com/orders",
                    "headers": {
                        "api-token": "my-token"
                    },
                    "body": "{\r\n  \"customer\": \"Contoso\",\r\n  \"items\": {\r\n\t  \"product_id\": 321,\r\n\t  \"count\": 50,\r\n\t  \"amount\": 245.95\r\n  }\r\n}",
                    "method": "POST",
                    "requestBodyFormat": "JSON"
                },
                {
                    "requestName": "get",
                    "responseVariables": [],
                    "requestType": "CURL",
                    "curlCommand": "curl --request GET 'https://www.contoso.com/orders'"
                },
            ],
            "csvDataSetConfigList": []
        }
    },
    "testSetup": [
        {
            "virtualUsersPerEngine": 1,
            "durationInSeconds": 600,
            "loadType": "Linear",
            "scenario": "requestGroup1",
            "rampUpTimeInSeconds": 30
        }
    ]
}

Configuración de carga

El archivo JSON de solicitudes usa las siguientes propiedades para definir la configuración de carga en la testSetup propiedad :

Configuración de pruebas de carga regional

Puede distribuir la carga entre regiones para simular mejor los patrones de tráfico de la vida real. Puede especificar las regiones desde las que desea generar la carga y la cantidad de carga desde la que desea simular desde cada región. Para ello, especifique el nombre de la región y el número de instancias de motor que desee en esa región. Obtenga más información sobre cómo generar la carga desde varias regiones.

Ejemplo de configuración de prueba de carga regional

El siguiente fragmento de código muestra una configuración de prueba de carga, que especifica dos regiones eastus de Azure y eastasia el número de instancias de motor para cada región.

displayName: Sample Test
testPlan: sampleScript.jmx
description: 'Load test website home page'
engineInstances: 4
testId: SampleTest
testType: Locust
splitAllCSVs: False
regionalLoadTestConfig:
- region: eastus
  engineInstances: 2
- region: eastasia
  engineInstances: 2
failureCriteria:
- p90(response_time_ms) > 10000
autoStop:
  errorPercentage: 90
  timeWindow: 60

Contenido relacionado

• Obtenga información sobre cómo crear pruebas de regresión automatizadas en los flujos de trabajo de CI/CD.
• Obtenga información sobre cómo parametrizar pruebas de carga con secretos y variables de entorno.
• Obtenga información sobre cómo realizar una prueba de carga de puntos de conexión protegidos.