Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/andylibrian/terjang
Scalable HTTP load testing tool built on Vegeta
https://github.com/andylibrian/terjang
benchmarking go http load-test load-testing
Last synced: about 1 month ago
JSON representation
Scalable HTTP load testing tool built on Vegeta
- Host: GitHub
- URL: https://github.com/andylibrian/terjang
- Owner: andylibrian
- License: mit
- Created: 2020-11-30T12:10:56.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2021-10-23T10:10:47.000Z (about 3 years ago)
- Last Synced: 2024-08-01T21:46:22.347Z (4 months ago)
- Topics: benchmarking, go, http, load-test, load-testing
- Language: Go
- Homepage:
- Size: 5.14 MB
- Stars: 18
- Watchers: 5
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-made-by-indonesian - Terjang - `Scalable HTTP load testing tool built on Vegeta` *by [Andy Librian](https://github.com/andylibrian)* (T)
- made-in-indonesia - Terjang - `Scalable HTTP load testing tool built on Vegeta` *by [Andy Librian](https://github.com/andylibrian)* (T)
README
# Terjang
Scalable HTTP load testing tool built on [Vegeta](https://github.com/tsenart/vegeta).[![Build status](https://img.shields.io/github/workflow/status/andylibrian/terjang/CI?style=flat)](https://github.com/andylibrian/terjang/actions)
[![Go Report Card](https://goreportcard.com/badge/github.com/andylibrian/terjang)](https://goreportcard.com/report/github.com/andylibrian/terjang)## Features
- Scalable: support multiple node of workers
- Web UI with detailed report
- Extensible:
- Start and stop load test via HTTP API
- Get status and load test result via HTTP API
- Receive progress / real time results via websocket![Demo](docs/demo.gif?raw=true "Demo")
## Install
### Pre-compiled
Download the pre-compiled executables from the [releases page](https://github.com/andylibrian/terjang/releases) and copy to the desired location.
### From source
```bash
git clone [email protected]:andylibrian/terjang.git
cd terjang
make
```## Usage
### Quick start on your local machine
Open a terminal, and run:
```bash
terjang server
```Open another terminal, and run:
```bash
terjang worker
```Then open [http://localhost:9009](http://localhost:9009)
### See more options
```bash
terjang -h
```### Docker compose
```bash
git clone [email protected]:andylibrian/terjang.git
cd terjang
docker-compose up -d
```Then open [http://localhost:9009](http://localhost:9009)
## Deploying on Kubernetes via Helm
```bash
helm repo add andylibrian https://andylibrian.github.io/helm-charts
helm repo updatehelm install terjang andylibrian/terjang
```Configuration: see [values.yaml](https://github.com/andylibrian/helm-charts/blob/main/charts/terjang/values.yaml)
To access the UI: `kubectl port-forward svc/server 9009:80`, then open [http://localhost:9009](http://localhost:9009)
## Contributing
See [Contributing](CONTRIBUTING.md)