Welcome! 

This looks to be your first time creating a test on the Flood platform using Selenium. 

Selenium is a very powerful open-source testing tool mainly used for automated functional testing via interacting with browser level objects. It can be very useful even for load testing as it allows users to re-use existing functional tests and run them with virtual concurrent users. 

One of the main attractions in choosing Selenium over a protocol level load testing tool such as Jmeter or Gatling - is the ability to create your scripts in a user based functional flows rather than looking at how to simulate users on a protocol level. Protocol Level User's are often much harder for complex applications.

This guide has easy to follow steps that will ensure you are able to launch a test using Selenium with multiple concurrent users as well as getting to know Flood's intuitive user interface.

Step 1

Download and unzip our Ready to Run Selenium java-based script here. You will need to upload the .java file in Step 6.

Step 2

When first creating a test scenario or as Flood calls it a "Stream" - it's a good idea to seperate Streams and Floods by projects. 

Please Note: If this is your first ever Flood then you will need to create the stream under the Default project initially. Once this Flood has been setup you will then be able to create new projects. Please continue to Step 3 if this is the case.

Create a new project called MySeleniumProject by pressing the following button on the projects page:

Type in the Name field: MySeleniumProject
Click CREATE PROJECT

Step 3

Click on the MySeleniumProject newly created project.

You will see the following screen:

Click Create Flood

Step 4

Instead of using the Test Builder this time we will choose to upload an existing Selenium script that we've prepared.

For Test Type - select the Upload existing script, and Click CONTINUE >

Step 5

For Test Name - enter SimpleSeleniumTest1

This is where you can name your test. If you end your test name with a number, Flood will automatically increment it if you run more than one test using this Stream.

Click CONTINUE

Step 6

For Test Scripts - click Choose Files and choose the sample file you downloaded and saved locally in Step 1.

Please wait until it is fully uploaded and the status of it has been marked as completed and the Uploaded At value is greater than 1 second.

Click CONTINUE

Step 7

For Test Parameters - Ensure the Selenium logo is highlighted and selected as this is a Selenium script. 

Also, with Selenium it is possible to simulated either Google Chrome or Firefox - for this example please select Google Chrome.

For the purposes of this test please use the following settings:

  • Threads: 5 - This is the number of concurrent users that will be run on each node.
  • Duration: 5 - This the number (in minutes) you would like run the test for.
  • Ramp Up: 0.5 - This is the amount of time (in minutes) that you would like the concurrent users to be injected. This is the overall time taken to get from 0 to 250 users.

Step 8

For Advanced Parameters - we don't need to specify any in this guide however this can be useful if you would like to pass in command line arguments for more advanced scenarios.

Click SKIP

Step 9

OK, so now we are pretty much ready to go but first we need some cool cloud-based load injection infrastructure or as we like to call them - Grids.

For Choose Grid and Launch - click the Launch Grid button.

This is where you are able to create and launch the infrastructure to run the test. 

For Launch New Grid - select the following:

  • Infrastructure: On Demand
  • Size / Number of Nodes: 1
  • Location / AWS Region: Australia (Sydney)

Click CONTINUE >

Step 10

For Lifecycle - this is where we select how long the Grid will be up for. For the purposes of this short test we'll use teh following paramters:

  • Start at: Start Now 
  • Stop after: 0.25 hours (15 minutes)

Click CONTINUE

Step 11

For Launch -  this where we confirm the Grid launch parameters.

Confirm the settings and click LAUNCH GRID

Step 12

Once you have your intricately researched (ahem or should I say random name generated) Grid name with the number of load injection nodes shown as a number of orange boxes within the Grid - we are just about ready to launch the test.

Click LAUNCH TEST

Step 13

You will be automatically taken to the initial setup loading screen that shows you the status for creating the Grid, setting up the nodes, uploading all the Flood settings and test artefacts and then waiting for the first data points to be returned right after the test starts.

Step 14

The following user interface for test execution will be presented to you indicating that the test is running and key metrics are being collated by the Flood platform.

The main components of the execution dashboard are explained below:

  1. Performance Metrics - For every test we focus on 3 main test metrics; (i) Concurrent Users, (ii) Response Time, and (iii) Transaction Rate. These are considered the most important metrics when performing a load test and can help determine if your target system is healthy or struggling.
  2. Logs - Full diagnostics logs are available and often yield helpful information on the state of the scenario. Here errors are aggregated from a load test tool perspective which can aid in diagnosis if the test encounters problems.
  3. Transactions - These transaction labels are the transaction steps that are setup in the Selenium script itself. Selecting each one will change the execution graph to display metrics specifically for the selected transaction. This is helpful if you would like to isolate a badly performing transaction during a test.
  4. Transaction Metrics - Response Time and Requests per Minute are displayed here for each transaction. These are both mean averages for the currently viewable timeframe of results.
  5. Error Rate - This area shows the percentage of passed / failed transactions as well as an arrow allowing you to drill-down to a sub page to see what error responses are being observed during the test.

Step 15

Congratulations! 

You have just run your first Selenium-based load test using the Flood platform. We hope these steps were easy to follow and you are able to go on and do more advanced load testing scenarios.

As always, we are here to help you every step of the way so please don't hesitate to reach out to one of our knowledgable Customer Success Engineers or visit our Help area for some great guides to running your tests using Flood.

Happy Testing from Team Flood!

Did this answer your question?