Skip to content

Latest commit

 

History

History
117 lines (85 loc) · 5.75 KB

README.md

File metadata and controls

117 lines (85 loc) · 5.75 KB
Raw

Selenium JMeter DSL demo

This is a demo project that contains a Selenium test for Retail Store demo app and generates and run performance tests using JMeter DSL.

Requirements

  • Docker + Docker compose
  • Maven 3.5+
  • Java 19+

Project Structure

Path Description
retailstore-test Selenium Test project
retailstore-test/docker-compose.yml Provisioning of Retail Store demo app
RetailStoreTest Selenium Test for Retail Store app
.env Configuration file for Selenium Test
selenium-jmeter-dsl Module contains main logic for recording and executing performance test. Including integration with Jmeter DSL
JmeterDslSeleniumRecorder JUnit extension which generates JMeter DSL test plan from a Selenium Test.
docker-compose.yml Provisioning for Grafana & InfluxDB

Usage

Selenium test execution

To start Retail Store demo app, go to retailstore-test folder and run:

docker-compose up

Set local hosts file so retailstore.test points to localhost:

echo '127.0.0.1 retailstore.test' >> /private/etc/hosts

You can run RetailStoreTest either using an IDE or using:

mvn clean test

To see the actual flow running you can remove "--headless=new" chrome option and set THINK_TIME_MILLIS to a value like 1000 in .env file.

Remember resetting THINK_TIME_MILLIS to 0, and re-adding "--headless=new" chrome option before running performance test.

Performance test recording & tuning

  1. Add selenium-jmeter-dsl dependency to retailstore-test/pom.xml:

    <dependency>
  <groupId>us.abstracta</groupId>
  <artifactId>selenium-jmeter-dsl</artifactId>
  <version>${project.version}</version>
</dependency>

  2. Register JmeterDslSeleniumRecorder JUnit extension in RetailStoreTest.

    @RegisterExtension
public final JmeterDslSeleniumRecorder recorder = new JmeterDslSeleniumRecorder()
    .basePageObject(BasePage.class);

  3. Add JmeterDslSeleniumRecorder as proxy in WebDriver options.

    options.setProxy(recorder.getProxy());

  4. Run RetailStoreTest & review generated PerformanceTest.java.

  5. Add InfluxDB listener config to .env:

    INFLUX_URI=http://localhost:8086
INFLUX_ORG=abstracta
INFLUX_BUCKET=selenium
INFLUX_TOKEN=token

  6. Add correlation rule to JmeterDslSeleniumRecorder. For fixed values in test plan, productId for instance, look into target/recordings generated XML files for responses containing the ID and define extraction and replacement regexes.

    @RegisterExtension
private final JmeterDslSeleniumRecorder recorder = new JmeterDslSeleniumRecorder()
    .correlationRule("productId",
        "name=\"productId\" value=\"([^\"]+)\"",
        "productId=(.*)")
    .basePageObject(BasePage.class);

  7. Re-run RetailStoreTest and review PerformanceTest.java.

  8. Run PerformanceTest test method and review calls (replacing just for this run influxDbListener with resultsTreeVisualizer, and then restoring influxDbListener).

  9. Tune thread group configuration in PerformanceTest.java

    threadGroup()
  .rampToAndHold(10, Duration.ZERO, Duration.ofMinutes(1))
  .rampToAndHold(20, Duration.ZERO, Duration.ofMinutes(1))
  .rampToAndHold(50, Duration.ZERO, Duration.ofMinutes(3))
  .children(...)

  10. Remove JUnit extension & proxy from RetailStoreTest.java.

  11. Start InfluxDB & Grafana running at root location of this project:

    docker-compose up

  12. Start PerformanceTest main method.

  13. Review results in Grafana at http://localhost:3000 with admin & 1234.