oha

The oha (おはよう) project is a lightweight HTTP load generator inspired by rakyll/hey. Built in Rust and leveraging the power of tokio, this tool presents an engaging TUI (Text User Interface) that visualizes real-time load tests.

Key Features

• Real-time Monitoring: Observe the performance of web applications as oha sends HTTP requests, with a stylish and informative TUI interface.
• Flexible Request Options: Control the number of requests, connections, and request method easily. For example, run a basic load test using:

  oha -n 200 -c 50 https://example.com
  

• Advanced Load Testing: Utilize options like duration, query per second limits, and burst request handling to simulate real-world traffic patterns.
• Support for Multiple Protocols: oha supports both HTTP/1 and HTTP/2, allowing users to test modern web applications under various conditions.
• Output Formatting: By default, results are displayed as a text summary, but users can also obtain outputs in JSON or CSV formats for detailed analysis.

Usage

To run oha, simply use the following syntax:

Usage: oha [OPTIONS] <URL>

Users can specify several options, such as:

• -n <N_REQUESTS> for the number of requests.
• -c <N_CONNECTIONS> to define concurrent connections.
• -z <DURATION> to set the testing duration while options like --latency-correction help to avoid issues stemming from coordinate omission.

Performance

For increased performance, the tool can operate without the TUI by using the --no-tui flag, minimizing overhead and optimizing load generation.

Dynamic Features

Enhance testing realism by generating random URLs or reading multiple target URLs from a file:

aha --urls-from-file urls.txt

This allows for comprehensive testing across different endpoints, reflecting a true usage scenario.

Contribution

Contributions are welcome in various areas such as improving the TUI design or writing additional tests. Join the community in enhancing this tool for everyone’s benefit.