Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/nakabonne/ali

Generate HTTP load and plot the results in real-time
https://github.com/nakabonne/ali

benchmarking go load-testing monitoring testing-tools tui visualization

Last synced: 2 days ago
JSON representation

Generate HTTP load and plot the results in real-time

Host: GitHub
URL: https://github.com/nakabonne/ali
Owner: nakabonne
License: mit
Created: 2020-09-12T00:11:21.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2023-10-21T07:19:22.000Z (about 1 year ago)
Last Synced: 2025-01-02T14:04:43.395Z (9 days ago)
Topics: benchmarking, go, load-testing, monitoring, testing-tools, tui, visualization
Language: Go
Homepage:
Size: 34.9 MB
Stars: 3,786
Watchers: 37
Forks: 143
Open Issues: 26
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

my-awesome - nakabonne/ali - testing,monitoring,testing-tools,tui,visualization pushed_at:2023-10 star:3.8k fork:0.1k Generate HTTP load and plot the results in real-time (Go)
awesome-repositories - nakabonne/ali - Generate HTTP load and plot the results in real-time (Go)
awesome-cli-tui-software - nakabonne/ali - Generate HTTP load and plot the results in real-time (<a name="performance"></a>performance)

README

# ali
[![Release](https://img.shields.io/github/release/nakabonne/ali.svg?color=orange)](https://github.com/nakabonne/ali/releases/latest)
[![Go Reference](https://pkg.go.dev/badge/github.com/nakabonne/ali.svg)](https://pkg.go.dev/github.com/nakabonne/ali)

A load testing tool capable of performing real-time analysis, inspired by [vegeta](https://github.com/tsenart/vegeta) and [jplot](https://github.com/rs/jplot).

![Screenshot](images/demo.gif)

`ali` comes with an embedded terminal-based UI where you can plot the metrics in real-time, so lets you perform real-time analysis on the terminal.

## Installation

Binary releases are available through [here](https://github.com/nakabonne/ali/releases).

**Via Homebrew**

```bash
brew install nakabonne/ali/ali
```

**Via MacPorts**

```bash
sudo port selfupdate
sudo port install ali
```

**Via APT**

```bash
wget https://github.com/nakabonne/ali/releases/download/v0.7.3/ali_0.7.3_linux_amd64.deb
apt install ./ali_0.7.3_linux_amd64.deb
```

**Via RPM**

```bash
rpm -ivh https://github.com/nakabonne/ali/releases/download/v0.7.3/ali_0.7.3_linux_amd64.rpm
```

**Via Pacman**

```bash
pacman -S ali
```

**Via APK**

After [enabling the community repo](https://wiki.alpinelinux.org/wiki/Enable_Community_Repository):

```bash
apk add ali
```

**Via Go**

Note that you may have a problem because it downloads an untagged binary.
```bash
go install github.com/nakabonne/ali@latest
```

**Via Docker**

```bash
docker run --rm -it nakabonne/ali ali
```

## Usage
### Quickstart

```bash
ali http://host.xz
```
Replace `http://host.xz` with the target you want to issue the requests to.
Press Enter when the UI appears, then the attack will be launched with default options (rate=50, duration=10s).

### Options

```
ali -h
Usage:
ali [flags]

Flags:
-b, --body string
-B, --body-file string
--cacert string
--cert string
-c, --connections int
--debug
-d, --duration duration
-H, --header stringArray
--insecure
--key string
--local-addr string
-M, --max-body int
-W, --max-workers uint
-m, --method string
--no-http2
-K, --no-keepalive
--query-range duration
-r, --rate int
--redraw-interval duration
--resolvers string
-t, --timeout duration
-v, --version
-w, --workers uint A request body to be sent. The path to file whose content will be set as the http request body. PEM ca certificate file PEM encoded tls certificate file to use Amount of maximum open idle connections per target host (default 10000) Run in debug mode. The amount of time to issue requests to the targets. Give 0s for an infinite attack. (default 10s) A request header to be sent. Can be used multiple times to send multiple headers. Skip TLS verification PEM encoded tls private key file to use Local IP address. (default "0.0.0.0") Max bytes to capture from response bodies. Give -1 for no limit. (default -1) Amount of maximum workers to spawn. (default 18446744073709551615) An HTTP request method for each request. (default "GET") Don't issue HTTP/2 requests to servers which support it. Don't use HTTP persistent connection. The results within the given time range will be drawn on the charts (default 30s) The request rate per second to issue against the targets. Give 0 then it will send requests as fast as possible. (default 50) The time interval to redraw charts (default 250ms) Custom DNS resolver addresses; comma-separated list. The timeout for each request. 0s means to disable timeouts. (default 30s) Print the current version. Amount of initial workers to spawn. (default 10)

Examples:
ali --duration=10m --rate=100 http://host.xz

Author:
Ryo Nakao
```

Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h".

**Examples**

For basic usage:

```bash
ali --rate=500 --duration=5m http://host.xz
```

For an infinite attack:

```bash
ali --duration=0 http://host.xz
```

For an attack with the POST method:

```bash
ali --body-file=/path/to/foo.json --method=POST http://host.xz
```

### Charts
Press `l` (or `h`) to switch the displayed chart. On all charts, you can click and drag to select a region to zoom into.

**Latency**

![Screenshot](images/latency-chart.png)

The X-axis represents the request counts and the Y-axis represents latencies in milliseconds.

**Percentiles**

![Screenshot](images/percentiles-chart.png)

You can see how the 50th, 90th, 95th, and 99th percentiles are changing.

**Bytes**

>TBA

**Histogram**

>TBA

## Features

### Plot in real-time

![Screenshot](images/real-time.gif)

### Visualize the attack progress
This will help you during long tests.

![Screenshot](images/progress.gif)

### Mouse support
With the help of [mum4k/termdash](https://github.com/mum4k/termdash) can be used intuitively.

![Screenshot](images/mouse-support.gif)

## Acknowledgements
This project would not have been possible without the effort of many individuals and projects but especially [vegeta](https://github.com/tsenart/vegeta) for the inspiration and powerful API.
Besides, `ali` is built with [termdash](https://github.com/mum4k/termdash) (as well as [termbox-go](https://github.com/nsf/termbox-go)) for the rendering of all those fancy graphs on the terminal.
They clearly stimulated an incentive to creation. A big "thank you!" goes out to all those who helped.