Adición de solicitudes a pruebas de carga basadas en direcciones URL en Azure Load Testing

En este artículo, aprenderá a agregar solicitudes HTTP a una prueba de carga basada en direcciones URL en Azure Load Testing. Use una prueba de carga basada en direcciones URL para validar puntos de conexión HTTP, como aplicaciones web o puntos de conexión REST, sin tener conocimiento previo de las herramientas de prueba de carga y el scripting.

Soporte técnico de Azure dos maneras de definir solicitudes HTTP en una prueba de carga basada en direcciones URL. Puede combinar ambos métodos dentro de una prueba de carga.

• Especifique los detalles del punto de conexión HTTP, como la dirección URL del punto de conexión, el método HTTP, los encabezados, los parámetros de consulta o el cuerpo de la solicitud.
• Escriba un comando cURL para la solicitud HTTP.

Si tiene solicitudes dependientes, puede extraer valores de respuesta de una solicitud y pasarlos como entrada a una solicitud posterior. Por ejemplo, puede recuperar primero los detalles del cliente y extraer el identificador de cliente para recuperar los detalles del pedido del cliente.

Si usa una prueba de carga basada en direcciones URL en el flujo de trabajo de CI/CD, puede pasar un archivo JSON que contenga las solicitudes HTTP a la prueba de carga.

Puede agregar hasta cinco solicitudes a una prueba de carga basada en direcciones URL. Para pruebas de carga más complejas, puede crear una prueba de carga mediante la carga de un script de prueba de JMeter. Por ejemplo, si tiene más de cinco solicitudes, si usa protocolos que no son HTTP o si necesita usar complementos de JMeter.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
• Un recurso de prueba de carga de Azure. Para crear un recurso de prueba de carga, consulte Creación y ejecución de una prueba de carga.

Adición de solicitudes con detalles HTTP

Puede especificar una solicitud HTTP para una prueba de carga basada en direcciones URL proporcionando los detalles de la solicitud HTTP. En la tabla siguiente se enumeran los campos que puede configurar para una solicitud HTTP en Azure Load Testing:

Campo	Detalles
URL	Dirección URL del punto de conexión HTTP. Por ejemplo, https://www.contoso.com/products.
Método	Método HTTP. Azure Load Testing admite GET, POST, PUT, DELETE, PATCH, HEAD y OPTIONS.
Parámetros de consulta	(Opcional) Escriba los parámetros de cadena de consulta que se van a anexar a la dirección URL.
Encabezados HTTP	(Opcional) Escriba los encabezados HTTP que se van a incluir en la solicitud HTTP. Puede agregar hasta 20 encabezados para una solicitud.
Cuerpo de solicitud	(Opcional) En función del método HTTP, puede especificar el contenido del cuerpo HTTP. Azure Load Testing admite los siguientes formatos: datos sin procesar, vista JSON, JavaScript, HTML y XML.

Siga estos pasos para agregar una solicitud HTTP a una prueba de carga basada en direcciones URL:

Azure Portal

1. En Azure Portal, vaya al recurso de prueba de carga.

2. En el panel de navegación izquierdo, seleccione Pruebas para ver todas las pruebas.

3. En la lista, seleccione la prueba de carga y, a continuación, seleccione Editar.

   Asegúrese de seleccionar una prueba de carga basada en direcciones URL en la lista y que ha habilitado Habilitar la configuración avanzada en la pestaña Aspectos básicos .

4. Vaya a la pestaña Plan de prueba y seleccione Agregar solicitud.

   

5. Seleccione Agregar entrada en la interfaz de usuario para escribir los detalles de la solicitud HTTP.

6. Escriba los detalles de la solicitud HTTP y, a continuación, seleccione Agregar para agregar la solicitud a la prueba de carga.

   Campo	Descripción
   Formato de solicitud	Seleccione Agregar entrada en la interfaz de usuario para configurar los detalles de la solicitud a través de campos en Azure Portal.
   Nombre de solicitud	Escriba un nombre único para la solicitud. Puede hacer referencia a este nombre de solicitud al definir criterios de error de prueba.
   URL	Dirección URL del punto de conexión de la aplicación.
   Método	Seleccione un método HTTP en la lista. Azure Load Testing admite GET, POST, PUT, DELETE, PATCH, HEAD y OPTIONS.
   Parámetros de consulta	(Opcional) Escriba los parámetros de cadena de consulta que se van a anexar a la dirección URL.
   Encabezados	(Opcional) Escriba los encabezados HTTP que se van a incluir en la solicitud HTTP.
   Cuerpo	(Opcional) En función del método HTTP, también puede especificar el contenido del cuerpo HTTP. Azure Load Testing admite los siguientes formatos: datos sin procesar, vista JSON, JavaScript, HTML y XML.

   

7. Seleccione Aplicar para guardar la prueba de carga.

Acciones de Azure Pipelines/GitHub

Al ejecutar la prueba de carga como parte de un flujo de trabajo de CI/CD, como Acciones de GitHub o Azure Pipelines, se proporciona la lista de solicitudes HTTP en un archivo JSON de solicitudes. En el archivo YAML de configuración de pruebas de carga, se hace referencia al archivo JSON en la testPlan propiedad .

1. Cree un requests.json archivo para almacenar las solicitudes HTTP y pegue el siguiente fragmento de código en el archivo:

   {
       "version": "1.0",
       "scenarios": {
           "requestGroup1": {
               "requests": [
               ],
               "csvDataSetConfigList": []
           }
       },
       "testSetup": [
           {
               "virtualUsersPerEngine": 50,
               "durationInSeconds": 300,
               "loadType": "Linear",
               "scenario": "requestGroup1",
               "rampUpTimeInSeconds": 60
           }
       ]
   }
   

   Opcionalmente, configure los valores de carga en la testSetup propiedad . Obtenga más información sobre cómo configurar parámetros de carga para pruebas de carga basadas en direcciones URL.

2. Agregue los detalles de la solicitud HTTP en la requests propiedad :

   El siguiente fragmento de código muestra un ejemplo de una solicitud HTTP POST. Observe que es requestType URL.

   {
       "requestName": "add",
       "responseVariables": [],
       "queryParameters": [
           {
               "key": "param1",
               "value": "value1"
           }
       ],
       "requestType": "URL",
       "endpoint": "http://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"
   },
   

3. Actualice el archivo YAML de configuración de pruebas de carga y establezca las testType opciones y testPlan :

   Asegúrese de establecer la testType propiedad URL en para indicar que está ejecutando una prueba de carga basada en direcciones URL.

   La testPlan propiedad hace referencia al archivo JSON de solicitudes que creó en el paso anterior.

   El siguiente fragmento de código muestra un fragmento de un archivo de configuración de prueba de carga de ejemplo:

   displayName: my-first-load-test
   testPlan: requests.json
   description: Web application front-end
   engineInstances: 1
   testId: my-first-load-test
   testType: URL
   splitAllCSVs: False
   failureCriteria: []
   autoStop:
     errorPercentage: 90
     timeWindow: 60
   

4. Guarde ambos archivos y confírmelos en el repositorio de control de código fuente.

Adición de solicitudes mediante cURL

En lugar de proporcionar los detalles de la solicitud HTTP, también puede proporcionar comandos cURL para las solicitudes HTTP en la prueba de carga basada en direcciones URL. cURL es una herramienta de línea de comandos y una biblioteca para solicitudes basadas en direcciones URL.

Siga estos pasos para agregar una solicitud HTTP a una prueba de carga mediante un comando cURL.

Azure Portal

1. En la lista de pruebas, seleccione la prueba de carga y, a continuación, seleccione Editar.

   Asegúrese de seleccionar una prueba de carga basada en direcciones URL en la lista y que ha habilitado Habilitar la configuración avanzada en la pestaña Aspectos básicos .

2. Vaya a la pestaña Plan de prueba y seleccione Agregar solicitud.

3. Seleccione Agregar comando cURL para crear una solicitud HTTP mediante cURL.

4. Escriba el comando cURL en el campo comando cURL y, a continuación, seleccione Agregar para agregar la solicitud a la prueba de carga.

   En el ejemplo siguiente se usa cURL para realizar una solicitud HTTP GET, especificando un encabezado HTTP:

   curl --request GET 'http://www.contoso.com/customers?version=1' --header 'api-token: my-token'
   

   

5. Seleccione Aplicar para guardar la prueba de carga.

Acciones de Azure Pipelines/GitHub

Al ejecutar la prueba de carga como parte de un flujo de trabajo de CI/CD, como Acciones de GitHub o Azure Pipelines, se proporciona la lista de solicitudes HTTP en un archivo JSON de solicitudes. En el archivo YAML de configuración de pruebas de carga, se hace referencia al archivo JSON en la testPlan propiedad .

1. Cree un archivo JSON para almacenar las solicitudes HTTP y pegue el siguiente fragmento de código en el archivo:

   {
       "version": "1.0",
       "scenarios": {
           "requestGroup1": {
               "requests": [
               ],
               "csvDataSetConfigList": []
           }
       },
       "testSetup": [
           {
               "virtualUsersPerEngine": 50,
               "durationInSeconds": 300,
               "loadType": "Linear",
               "scenario": "requestGroup1",
               "rampUpTimeInSeconds": 60
           }
       ]
   }
   

   Opcionalmente, configure los valores de carga en la testSetup propiedad . Obtenga más información sobre cómo configurar parámetros de carga para pruebas de carga basadas en direcciones URL.

2. Agregue un comando cURL en la requests propiedad :

   El siguiente fragmento de código muestra un ejemplo de una solicitud HTTP POST. Observe que es requestType CURL.

   {
       "requestName": "get-customers",
       "responseVariables": [],
       "requestType": "CURL",
       "curlCommand": "curl --request GET 'http://www.contoso.com/customers?version=1' --header 'api-token: my-token'"
   },
   

3. Establezca la testType configuración y testPlan en el archivo YAML de configuración de pruebas de carga para hacer referencia al archivo JSON de solicitudes:

   Asegúrese de establecer la testType propiedad URL en para indicar que está ejecutando una prueba de carga basada en direcciones URL.

   La testPlan propiedad hace referencia al archivo JSON de solicitudes que creó en el paso anterior.

   El siguiente fragmento de código muestra un fragmento de un archivo de configuración de prueba de carga de ejemplo:

   displayName: my-first-load-test
   testPlan: requests.json
   description: Web application front-end
   engineInstances: 1
   testId: my-first-load-test
   testType: URL
   splitAllCSVs: False
   failureCriteria: []
   autoStop:
     errorPercentage: 90
     timeWindow: 60
   

4. Guarde ambos archivos y confírmelos en el repositorio de control de código fuente.

Uso de variables en solicitudes HTTP

Puede usar variables en la solicitud HTTP para que las pruebas sean más flexibles o para evitar incluir secretos en el plan de pruebas. Por ejemplo, podría usar una variable de entorno con el nombre de dominio del punto de conexión y, a continuación, usar el nombre de variable en las solicitudes HTTP individuales. El uso de variables hace que el plan de prueba sea más flexible y fácil de mantener.

Con las pruebas de carga basadas en direcciones URL en Azure Load Testing, puede usar variables para hacer referencia a la siguiente información:

• Variables de entorno: puede configurar variables de entorno para la prueba de carga.
• Secretos: configuración de secretos de Azure Key Vault en la prueba de carga
• Valores de un archivo de entrada CSV: use variables para las columnas de un archivo de entrada CSV y ejecute una solicitud para cada fila del archivo.
• Variables de respuesta: extraiga valores de una solicitud HTTP anterior.

La sintaxis para hacer referencia a una variable en una solicitud es: ${variable-name}.

En la captura de pantalla siguiente se muestra cómo hacer referencia a una token variable en un encabezado HTTP mediante ${token}.

Nota:

Si especifica certificados, Azure Load Testing pasa automáticamente los certificados en cada solicitud HTTP.

Uso de variables de respuesta para solicitudes dependientes

Para crear solicitudes HTTP que se abran en una solicitud anterior, puede usar variables de respuesta. Por ejemplo, en la primera solicitud podría recuperar una lista de elementos de una API, extraer el identificador del primer resultado y, a continuación, realizar un paso posterior y pasar este identificador como parámetro de cadena de consulta.

Azure Load Testing admite las siguientes opciones para extraer valores de una solicitud HTTP y almacenarlos en una variable:

• JSONPath
• XPath
• Expresión regular

Por ejemplo, en el ejemplo siguiente se muestra cómo usar un XPathExtractor para almacenar el cuerpo de una solicitud en la variable de token respuesta. A continuación, puede usar ${token} en otras solicitudes HTTP para hacer referencia a este valor.

"responseVariables": [
    {
        "extractorType": "XPathExtractor",
        "expression": "/note/body",
        "variableName": "token"
    }
]

Contenido relacionado

• Configuración de una prueba de carga con variables de entorno y secretos
• Leer datos de un archivo CSV de entrada
• Referencia de YAML de configuración de pruebas de carga