Submit performance test requests to WebPageTest, and consume the results
This package is auto-updated.
Last update: 2022-01-14 23:03:30 UTC
The goal of this module is to give you a way to queue and view WebPageTest performance tests. This is still early days though - we have some basic functionality, but this definitely isn't replacing a paid for testing service (at least not yet).
- Using the dev/tasks
- Viewing your submissions and results
- Supported request configuration
- Using the Services
- Provides Request and Service classes that you can use to queue and consume WebPageTest performance test results.
- Provides dev/tasks that can be used to queue and consume WebPageTest performance test results on a schedule.
- Basic ModelAdmin to view your submissions and WebPageTest performance test results.
- Consume more of the performance test result data
$ composer require chrispenny/silverstripe-webpagetest
If you would like to use this module with the public API, then you will need to request an API key. There are no requirements for getting one, it's just to make sure that folks are not abusing the API.
There are different ways that you can use this module, but, assuming you just want to go ahead and use the provided
/dev/tasks, you'll need to add two configuration settings before you can go any further.
key(the API key that you requested above)
url(the URL that you would like WebPageTest to run the test against)
So, out of the box, we're only running performance tests against the same, single, URL.
In these early stages of the module, you'll need to implement your own
/dev/task if you wish you support testing
multiple different URLs. See Using the Services for details.
By default, in
_config/submission.yml, we have set a couple of default configs:
base_url: http://www.webpagetest.org/runtest.php format: json
base_url is the standard request URL for WebPageTest.
format that this module supports is
location(if you don't provide a location, then it will be random, this makes your ongoing tests a bit random, as you'll likely get different results from different locations)
Available locations can be found here: https://webpagetest.org/getLocations.php?f=html
Out of the box, the module supports you sending any/all of the currently supported GET params in WebPageTest's RESTful API.
There are two
dev/tasks available for you to use.
Cron support is not adding as part of this module, but you could set up a cron to (say) run the
Submission\Task once a
day (resulting in one new WebPageTest being requested per day), and you might want to set up
TestResult\Task to run
every hour or so.
A full description of what each task does is below.
When run, this task will send a single GET request to WebPageTest requesting that they queue a test matching what you have specified in your configuration.
The documentation for the RESTful API on WebPageTest will show you what the default values are if one is not supplied: https://sites.google.com/a/webpagetest.org/docs/advanced-features/webpagetest-restful-apis
It's important to note that tests through WebPageTest do not necessarily get processed straight away. If you are using the free service, then your request will go into a queue, and it will be processed when you're at the front of that queue. The tests then also (of course) take a while to complete. This is why we have a separate Task for retrieving the data for the tests.
Once we receive the "OK" (or otherwise) from WebPageTest, we create a Test Submission record, which you can see in the
There are three possible statuses for these Submission records. These indicate the status of the test itself.
- Pending (WebPageTest is still processing our request - they haven't tested our URL yet)
- Success (The test has been completed by WebPageTest, and we should have the results)
- Failure (Something went wrong ...)
If you want one new performance test run each day, then you would want to set up a cron triggering this task to run once each day.
When run, this task looks at what Submissions are current set with a status of
Pending. It then requests an update
from WebPageTest on what the status of that test is.
There is (generally) three possibility:
- You are still in the queue, and your test has not begun yet
- Your test is currently running
- Your test has completed
In the case of the first two, we will create (or update) a Test Result record, and set its data to indicate to you where in the queue you are, or that the test is underway.
In the case where the test has completed, we will populate the Test Result record with the result data that we (currently) care about.
There is so... SO, much data in these test results. So for now, we just have the basics being stored. I welcome any and all to add support for us to store for of the data from the result data.
If you are running a cron once a day to trigger a test submission, you may want to queue the retrieval of the result,
either for some time after the submission takes place, or, you could just trigger this task to run (say) every 20
minutes. The task does not do anything if there are no
The ModelAdmin can be found under:
This will list out all of the Submissions that you have made.
If you click on one of your Submissions, you'll see the current status, and once there is a result, a
Result tab will
show up, where you can see the Result and any of its "Runs" (you may have requested that WebPageTest performs multiple
runs, and by default, it also performs a "first view" and "repeat view" test).