Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/huttotw/zoom
A load testing utility that can generate different requests according to some predefined template.
https://github.com/huttotw/zoom
concurrent configuration http load random template test
Last synced: 24 days ago
JSON representation
A load testing utility that can generate different requests according to some predefined template.
- Host: GitHub
- URL: https://github.com/huttotw/zoom
- Owner: huttotw
- License: apache-2.0
- Created: 2019-01-02T14:19:16.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2019-01-04T21:58:08.000Z (about 6 years ago)
- Last Synced: 2024-11-17T20:37:01.825Z (3 months ago)
- Topics: concurrent, configuration, http, load, random, template, test
- Language: Go
- Size: 28.3 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# zoom
Zoom is a load testing utility capable of generating different requests according to some template. This should be used to simulate lots of users on a system, or a bunch of random requests at some endpoint.
## Running
To run a load test and send a new KSUID and random number each time:
```
docker run huttotw/zoom:latest zoom -n 10000 -concurrency 10 -url http://localhost:8080 -template '{"id":"{{ ksuid }}","num":{{ intn 100 }}}' -method POST
```
This will send 10,000 `POST` requests, 10 at a time, to `http://localhost:8080` with a payload formatted like:
```json
{"id":"1FDJSGnlAp4C9XTHZQ2XM0u8vFx","num":15}
```
## Flags
| flag | definition | required |
|-----------------|------------------------------------------------------------------|----------|
| n | the number of requests you want to send, omit for infinite | no |
| concurrent | the number of requests to make at one time | yes |
| method | the HTTP method used to send the request | yes |
| url | the URL to send the request to | yes |
| h | a header to send with each request, multiple allowed | no |
| template | the Go template string that you want to use to form each request | one of template or template-file |
| template-file | the file that contains your template to form each reqeust | one of template or template-file |
## Available Functions
| function | description |
|------------|-------------------------------------------------------------------------------|
| `email` | a random email address |
| `enum` | randomly selects one of the arguments given |
| `intn` | choose a random number between 0 and the given argument |
| `ip` | a random ip address |
| `ksuid` | a ksuid from [github.com/segmentio/ksuid](https://github.com/segmentio/ksuid) |
| `string` | a random string |
| `url` | a random url |
| `time` | the current time |
## Adding new template functions
Since we use `text/template` to form each request, adding new functions to be available at execution time is as simple as adding to the function map in `cmd/zoom/templates.go`. Please see the official documentation for more detail: https://golang.org/pkg/text/template/#FuncMap.
## License
Copyright © 2019 Trevor Hutto
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.