https://github.com/imjacobclark/Herd

An experimental HTTP load testing application written in Rust.
https://github.com/imjacobclark/Herd

Last synced: 24 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 (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2023-02-23T16:00:40.000Z (about 1 year ago)
• Last Synced: 2024-04-08T20:01:53.937Z (about 1 month ago)
• Language: Rust
• Homepage:
• Size: 47.9 KB
• Stars: 109
• Watchers: 10
• Forks: 11
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-rust - Herd
• awesome-rust-zh - Herd - 实验性 HTTP 负载测试应用程序 (应用 / 贡献)
• awesome-rust - Herd
• awesome-rust - imjacobclark/Herd
• awesome-rust - Herd
• awesome-stars - imjacobclark/Herd - An experimental HTTP load testing application written in Rust. (Rust)
• awesome-rust - Herd
• awesome-rust-cn - Herd
• awesome-rust - imjacobclark/Herd
• awesome-rust - Herd
• awesome-rust-cn - Herd

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

```