README
¶
Baton
Baton is a load testing tool written in Go. It currently supports GET, POST, PUT, and DELETE requests.
Install Baton
Installation of Baton with Go is as easy as running go get.
$ go get -u github.com/americanexpress/baton
Binary releases are available.
Using Baton
Baton currently supports the following options:
-b string
Body (use instead of -f)
-c int
Number of concurrent requests (default 1)
-f string
File path to file to be used as the body (use instead of -b)
-i Ignore TLS/SSL certificate validation
-m string
HTTP Method (GET,POST,PUT,DELETE) (default "GET")
-o Supress output, no results will be printed to stdout
-r int
Number of requests (use instead of -t) (default 1)
-t int
Duration of testing in seconds (use instead of -r)
-u string
URL to run against
-w int
Number of seconds to wait before running test
-z string
Read requests from a file
Below is A basic example which will use 10 workers to send 200,000 requests is as follows:
$ baton -u http://localhost:8080/test -c 10 -r 200000
Instead of the number of requests, you can specify the time (in seconds) during which the requests should be sent. Baton will wait for all the responses to be received before reporting the results.
Requests file
When specifying a file to load requests from (-z filename), the file should be of CSV format (RFC-4180)
<method>,<url>,[<body>],[<header-key>:<header-value>, ...]
...
You can have one or more headers at the end separated by ,
For example:
POST,http://localhost:8888,body,Accept: application/xml,Content-type: Secret
GET,http://localhost:8888,,,
Example Output:
====================== Results ======================
Total requests: 1254155
Time taken to complete requests: 10.046739294s
Requests per second: 124832
Max response time (ms): 440
Min response time (ms): 55
Avg response time (ms): 156.70
===================== Breakdown =====================
Number of connection errors: 0
Number of 1xx responses: 0
Number of 2xx responses: 1254155
Number of 3xx responses: 0
Number of 4xx responses: 0
Number of 5xx responses: 0
=====================================================
Features which are on the horizon...
- Dynamic generation of data based on a template
- Testing REST endpoints with dynamically generated keys
Caveats
- Statistics are only provided when a fixed number of requests is provided (instead of providing a duration).
Dependency Management
Dep is currently being utilized as the dependency manager for Baton. Details of how to use dep can be found on https://golang.github.io/dep/.
Before updating any dependencies, ensure you have fully tested all functionality.
Contributing
We welcome Your interest in the American Express Open Source Community on Github. Any Contributor to any Open Source Project managed by the American Express Open Source Community must accept and sign an Agreement indicating agreement to the terms below. Except for the rights granted in this Agreement to American Express and to recipients of software distributed by American Express, You reserve all right, title, and interest, if any, in and to Your Contributions. Please fill out the Agreement.
Please feel free to open pull requests and see CONTRIBUTING.md for commit formatting details.
License
Any contributions made under this project will be governed by the Apache License 2.0.
Code of Conduct
This project adheres to the American Express Community Guidelines. By participating, you are expected to honor these guidelines.
Documentation
¶
There is no documentation for this package.
Source Files