Announcing the LoadForge CLI helper

We are proud to announce the availability of lf-cli - our command line tool for easily interacting with LoadForge!

lf-cli provides an interface to the following functions:

  • hosts:list - List all the hosts on your account
  • results:list - list all the recent test results on your account
  • results:get {id} - get the detailed results (requests per second, errors, latency, etc) for a result
  • tests:list - list all the tests on your account
  • tests:run {id} {duration in minutes} - run a test from tests:list

You can easily launch tests and monitor their results, as shown in this preview below:

❯ lf-cli tests:list
Listing tests on your active team

+-----+-----------------+-------+------+---------+--------+
| ID  | Name            | Users | Rate | Servers | Region |
+-----+-----------------+-------+------+---------+--------+
| 682 | LoadForge Login | 10    | 2    | 1       | nyc3   |
| 332 | Advent Strapi   | 30    | 1    | 10      | sfo3   |
| 318 | LoadForge Blog  | 50    | 10   | 1       | nyc3   |
+-----+-----------------+-------+------+---------+--------+


❯ lf-cli tests:run 318 5
Running test 318 for 5 minutes.

Run launched with ID: 3635
You may run the following command to monitor it:
lf-cli results:get 3635


❯ lf-cli results:get 3635
Fetching results for run 3635

Created At  : 2021-09-15 06:40:39
Finished At : 2021-09-15 06:42:48
Status      : Testing
Test Id     : 318

Requests per second : 7.75
Errors per second   : 0.00
Total requests      : 45
Total errors        : 0(0.00%)

Response Median  : 170ms
Response Average : 669ms
Response Minimum : 127ms
Response Maximum : 4159ms

You can learn more about lf-cli and install it from our GitHub page.

Ready to run that test?
Start your first test within minutes.