Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/melroy89/rambam
Stress-test/benchmarking tool for HTTP with thousands of concurrent connections. Written in C++. Mirror of: https://gitlab.melroy.org/melroy/rambam
https://github.com/melroy89/rambam
api benchmarking benchmarking-utility cpp20 rambam stress stress-test stress-testing testing webapp
Last synced: 22 days ago
JSON representation
Stress-test/benchmarking tool for HTTP with thousands of concurrent connections. Written in C++. Mirror of: https://gitlab.melroy.org/melroy/rambam
- Host: GitHub
- URL: https://github.com/melroy89/rambam
- Owner: melroy89
- License: mit
- Created: 2023-12-29T23:28:54.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-29T20:21:38.000Z (6 months ago)
- Last Synced: 2024-10-04T13:34:59.922Z (3 months ago)
- Topics: api, benchmarking, benchmarking-utility, cpp20, rambam, stress, stress-test, stress-testing, testing, webapp
- Language: C++
- Homepage: https://gitlab.melroy.org/melroy/rambam
- Size: 1.07 MB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# RamBam
RamBam is a stress-test/benchmarking tool for HTTP, using massive parallel HTTP requests.
RamBam is written in C++ and using a [Asio](https://think-async.com/Asio/) (also written in C++).
## Demo
## Download
[Download the latest release](https://gitlab.melroy.org/melroy/rambam/-/releases).
## Usage
Help: `rambam -h`
Usage (_default:_ Number of Requests GET Test of "_just_" 100 requests):
```bash
rambam domain.tld
```
Increase the default **request count** from 100 to 10.000 requests (`-r` for requests):
```bash
rambam -r 10000 https://domain.tld
```
Using the **duration test** for 10 seconds (`-d` for duration):
```bash
rambam -d 10 https://domain.tld
```
Example using **Post requests** (`-p` for **JSON** Post data):
```bash
rambam -p '{"username": "melroy"}' https://domain.tld/api/v1/user/create
```
More advanced parameters (`-v` for verbose output, `--debug` for additional TLS debug information):
```bash
rambam -v --debug https://domain.tld
```
You can use multiple parameters together, except the `-d` for duration test (in seconds) and `-r` for request test (total requests). Just pick one of the two different tests.
## Additional options
- Enable debug output via: `--debug` flag.
- If you have a self-signed certificate try to use `-o` flag to override verifcation or disable peer certificate verification using: `--disable-peer-verify` flag.
- Silent all output via : `-s` flag.
_Note:_ We don't support `transfer-encoding: chunked` (HTTP 1.1), hence we use only HTTP 1.0 requests.
---
## Developers
### Requirements
- C++ Compiler (`sudo apt install build-essential` for GNU compiler, _Clang is **also** supported_)
- CMake (`sudo apt install cmake`)
- OpenSSL (`sudo apt install libssl-dev openssl`)
- Ninja build system (optional, but **recommended**: `sudo apt install ninja-build`)
- Ccache (optional, but much **recommended**: `sudo apt install ccache`)
### Build
Building the RamBam binary is very easy:
```bash
# Configure build folder (prepare)
cmake -B build
# Build it! Using make
cmake --build ./build -j 8 --config Release --target rambam
```
Binary is now located at: `build/rambam`.