Goku

Goku is a high-performance, scalable HTTP load testing tool designed for benchmarking and performance analysis of web services. It supports structured real-time metrics and detailed performance analysis, making it suitable for engineers to efficiently simulate and analyze traffic.

Developer tools Monitoring #Load testing #Performance analysis #HTTP tool #Benchmarking .Rust

rating : 2 points

downloads : 5.7K

update time : 2025-04-29

Open Site

What is Goku?

Goku is a modern HTTP load testing tool inspired by Drill and Vegeta, aiming to help engineers efficiently simulate and analyze network traffic. It provides fast and scalable testing capabilities and supports structured real-time metrics and detailed performance analysis.

How to use Goku?

Goku can be used through a simple command-line interface and supports multiple installation methods, including automatic download, installation via Cargo, or manual download. Basic usage includes specifying the target URL, the number of concurrent clients, the number of iterations, or the test duration.

Use cases

Goku is most suitable for performance testing, load testing, and stress testing of web services, helping developers evaluate the system's performance under high concurrency.

Main features

High-performance load testing

Capable of quickly initiating a large number of HTTP requests to simulate high-concurrency scenarios.

Real-time metrics

Provides structured real-time performance metrics, including request time, throughput, etc.

Detailed analysis

Generates detailed performance analysis reports, including percentiles, maximum/minimum request times, etc.

Scenario testing

Supports defining complex test scenarios through YAML files, including custom headers and request bodies.

Advantages

High performance, capable of handling high-concurrency test scenarios

Simple and easy-to-use command-line interface

Supports multiple installation methods

Provides detailed performance metrics and analysis

Supports custom request headers and request bodies

Limitations

Currently only supports the HTTP protocol

Limited graphical interface, mainly relying on the command line

Advanced features require writing YAML scenario files

How to use

Install Goku

Choose an installation method suitable for your system: automatic download, installation via Cargo, or manual download.

Basic test

Run a simple load test, specifying the target URL and basic parameters.

Advanced test

Conduct advanced tests with more parameters, such as the number of concurrent clients, the number of iterations, or the duration.

Custom test

Perform more complex tests using custom request headers, request bodies, or scenario files.

Usage examples

Basic GET request test

Conduct 1000 request tests on a local service using 50 concurrent clients

POST request with custom headers

Send a POST request in JSON format with custom headers

Long-running test

Run a continuous test for 60 seconds to simulate long-term load

Frequently Asked Questions

How to install Goku?

Which HTTP methods does Goku support?

How to add custom HTTP headers?

What do the percentiles in the test results mean?

How to define complex test scenarios?

Related resources

GitHub repository

Source code and the latest version of Goku

Crates.io page

Cargo package information for Goku

CI build status

Latest build status and test results

License

License information for Goku

🚀 Goku

Goku is a high-performance, scalable HTTP load testing tool designed for benchmarking and performance analysis of web services. Inspired by tools like Drill and Vegeta, Goku offers modern features and simplicity, enabling engineers to efficiently simulate and analyze traffic.

🚀 Quick Start

Goku is a high - performance and scalable HTTP load testing tool. It's mainly used for benchmarking and performance analysis of web services.

✨ Features

Fast and scalable HTTP load testing
Support for structured real - time metrics
Detailed performance analysis

📦 Installation

Automatic Download (Linux, macOS, WSL)

You can directly download the latest version of Goku to the current directory using the following command:

curl -sSL https://raw.githubusercontent.com/jcaromiq/goku/v2.0.0/scripts/install.sh | sh

Installation via Cargo

cargo add goku-bench --features goku_bench/feature_name

Manual Download and Source Compilation

Clone the repository:

git clone https://github.com/jcaromiq/goku.git
cd goku

Compile the project:

cargo build --release

Run the tests:

cargo test --release

📚 Documentation

Version Information

Goku follows the SemVer 2.0.0 specification.

Contribution Guidelines

For contribution guidelines, please refer to the CONTRIBUTING.md file.

Command - line Options

Goku provides the following command - line options:

Option	Description
`-v, --verbose`	Enable verbose mode
`-h, --help`	Display help information and exit
`--version`	Display the program version information

Usage Examples

Basic Usage

goku-bench -c 50 -t 4 http://example.com/

Using a Custom Request Body

goku-bench -c 50 -t 4 --request-body file.json http://example.com/

Setting HTTP Method and Headers

goku-bench -c 50 -t 4 --method POST --header "Content-Type: application/json" --header "Authorization: Bearer token" http://example.com/api

Output Example

Concurrency: 50
Duration: 4 seconds
Total requests: 2000
Average response time: 169.90099999999998 ms
Max response time: 415 ms
Min response time: 5 ms
95th percentile: 319 ms
99.9th percentile: 367 ms