Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/imjacobclark/Herd
An experimental HTTP load testing application written in Rust.
https://github.com/imjacobclark/Herd
Last synced: 7 days ago
JSON representation
An experimental HTTP load testing application written in Rust.
- Host: GitHub
- URL: https://github.com/imjacobclark/Herd
- Owner: imjacobclark
- License: gpl-2.0
- Created: 2015-05-31T16:28:38.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-02-23T16:00:40.000Z (over 1 year ago)
- Last Synced: 2024-08-01T03:18:48.805Z (3 months ago)
- Language: Rust
- Homepage:
- Size: 47.9 KB
- Stars: 109
- Watchers: 10
- Forks: 11
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-rust-cn - Herd
- awesome-rust - Herd
- awesome-rust - Herd
- awesome-rust-cn - Herd
- awesome-rust-zh - Herd - 实验性 HTTP 负载测试应用程序 (应用 / 贡献)
- awesome-rust - Herd - an experimental HTTP load testing application (Applications)
- awesome-rust - Herd
- fucking-awesome-rust - Herd - an experimental HTTP load testing application (Applications)
README
# Herd
Herd was a small side project in building a HTTP load testing application in Rust with a main focus on being easy to use and low on OS level dependencies such as the JVM.
Herd was developed on a pre-1.0 version of Rust, it is not unit tested and unlikley to compile on later versions of Rust, I intend to revisit this project as the Rust ecosystem matures.
Herd can spawn thousands of concurrent requests to HTTP endpoints by making use of unix process forking and multithreadding.
Herd is hardware intensive. Per each 1000 virtual users, Herd will fork itself in order to overcome hard limits set by the OS on how many active threads a process can have at any one time. Due to this, it is recomended you run Herd from a disposable machine in the cloud, high levels of virtual users can crash machines if they run out of memory or CPU resources, __do not run Herd on a production machine__.
##### Download and run
As Herd is unlikley to compile out the box, it is recomended you clone this repository and fully build from source, some alterations to the source code may be needed over time as the Rust language changes, I do not intend on continuously maintaining this project.
###### Dependencies:
`gcc clang libssl rust cargo`
###### Compile from source and run:
```shell
$ git clone [email protected]:imjacobclark/Herd.git && cd Herd
$ cargo build --release
```
You can define several hosts to test with a configuration file. See [example-config.yaml](example-config.yaml).
```shell
$ .cargo run -- --config example-config.yaml
```