Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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

Awesome Lists containing this project

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 update

helm 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)