Simple load testing with Node.js
Simple load testing with Node.js
A load testing server - v0.5.0
connections
duration
runs
headers
baseUrls
, randomly choosing a baseUrl
to test againstforms
, randomly choosing a form
to POST withJob
objectRequest
object$ npm install -g load-tester
$ load-tester <port>
Listening on <port>
Now, you'll find a basic webui at http://localhost:<port>
or you can try the live demo:
http://node-load-tester.herokuapp.com
Note: free heroku instances have bandwidth caps
We'll target http://echo.jpillora.com
, run the following sequence:
/
(home) and expect a 200
/api/login
with creds and expect a 200
/test/user
and check it's 200
)/test/user
and check it's 404
)<showFile("example/basic.json")>
{
"baseUrl": "http://echo.jpillora.com",
"duration": 5000,
"connections": 1,
"sequence": [
{ "method": "GET", "path": "/" },
{ "method": "POST", "path": "/api/login", "form":{"username":"foo","password":"bar"} },
{ "method": "GET", "path": "/test/user" },
{ "method": "GET", "path": "/logout" },
{ "method": "GET", "path": "/test/user", "expect": { "code": 404 } }
]
}
Since http://echo.jpillora.com
is just an echo server, it didn't actually login,
so the second /test/user
still responded with 200, which is seen as a failure:
{
"paths": {
"GET /": {
"pass": 2,
"fail": 0,
"total": 2,
"avgResponseTime": 877
},
"POST /api/login": {
"pass": 2,
"fail": 0,
"total": 2,
"avgResponseTime": 936
},
"GET /test/user": {
"pass": 2,
"fail": 2,
"total": 4,
"avgResponseTime": 692
},
"GET /logout": {
"pass": 2,
"fail": 0,
"total": 2,
"avgResponseTime": 660
}
},
"errors": {
"expected code: 404 got: 200 (for GET /test/user)": 2
},
"pass": 8,
"fail": 2,
"total": 10,
"totalTime": 7719,
"avgResponseTime": 791
}
POST /job
Create a load test Job
Job
Object PropertiesbaseUrl
(String) - Target URLbaseUrls
(Array[String]) - Target URLsheaders
(Object) - Header/Value pairs to apply to all Request
sruns
(Number) - Number of times to run through the sequence
duration
(Number) - Keep running through the sequence
for duration
msconnections
(Number) - Number of HTTP clients (each will run through the sequence
)sequence
(Array[Request
]) - The sequence of Request
s to execute (a new cookie jar is created per sequence)Request
Object Propertiesmethod
(String) - HTTP Method to use (default:"GET"
)path
(String) - URL Path to be appended to baseUrl
headers
(Object) - Header/Value pairs to apply to this Request
(overrides Job
headers
)form
(Object) - Object to application/form encodeforms
(Array[Object]) - Round-robin through objects to application/form encodeexpect
(Object) - Expectation definition object
code
(Number) - Expect a particular HTTP status code (default:200)
contains
(String) - Expect the HTTP body to containmatch
(String) - Expect the HTTP body to match new RegExp(match)
Note: There must be one expect
ation
Note: Failed expections are accumulated in the results, e.g:
"errors": {
"expected code: 404 got: 200 (for GET /test/user)": 2
}
<showFile("example/random-forms.json")>
{
"baseUrl": "http://echo.jpillora.com",
"duration": 5000,
"connections": 1,
"sequence": [
{ "method": "POST", "path": "/api/login", "forms":[
{"username":"foo","password":"bar"},
{"username":"ping","password":"pong"},
{"username":"zap","password":"zoop"}
]
}
]
}
<showFile("example/expectations.json")>
{
"baseUrl": "http://echo.jpillora.com",
"runs": 3,
"connections": 1,
"sequence": [
{ "method": "GET", "path": "/api/code-test", "expect": { "code": 408 } },
{ "method": "GET", "path": "/api/string-test", "expect": { "contains": "abc" } },
{ "method": "GET", "path": "/api/regex-test", "expect": { "match": "^a[Bb]c$" } }
]
}
runs
is how many times to run the sequence. Can be used with or instead of duration
.
Every request will round-robin through the baseUrls
Requests may also specify a header
object which will override the job's header
object
<showFile("example/load-balancer.json")>
{
"baseUrls": [
"http://74.125.237.114",
"http://74.125.237.115",
"http://74.125.237.116"
],
"headers": {
"host": "www.google.com.au"
},
"duration": 5000,
"connections": 1,
"sequence": [
{ "path": "/" }
]
}
<license()>
Copyright © 2013 Jaime Pillora <[email protected]>
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.