This is a tool that makes it easy to test API servers. It is supported for Unix systems that include the Apache Portable Runtime and OpenSSL. That includes implementations of Linux, Windows under Cygwin, and Apple OS X.
Running apib can be as simple as:
apib -c 100 -d 60 http://test.example.com
The command above will hammer "test.example.com" as fast as it can for up to 60 seconds using 100 concurrent network connections.
See additional documentation for more:
- Running: How to run apib
- Building: How to build it from source
- Remote Montitoring: How to remotely monitor servers under test
apib is intended to have many of the features of Apache Bench (ab), but is also intended as a more modern replacement. In particular, it will support:
- Proper HTTP 1.1 support including keep-alives
- Ability to spawn multiple I/O threads to take advantage of multiple CPU cores
- Support for POST and PUT of large objects
- Support for templates so that requests may vary
- Support for OAuth 1.0 and 2.0 signatures
- Ability to output results to a file so they may be automated
- Possibily a "graphical mode" using curses so it's sexy
However, like "ab," it will also support:
- A very simple command-line interface
- Very few dependencies, so it may be easily built and deployed
- Non-blocking I/O for high concurrency
- apr -- makes it more portable to Linux, Solaris, Macintosh I think
- openssl -- because we need SSL
Any reasonable platform will have both of these.
- Spawn one I/O thread per CPU (configured by user)
- Allocate a subset of connections to each, and in each:
- Start event loop
- If total number of connections < C, spawn a connection
- Execute HTTP state machine -- connecting, sending, receiving, sending
- When connections close, replace them to maintain C connections open
- Record results in a shared area
- Back in main thread, report on shared results periodically
- Time in main thread and signal workers to stop eventually
- Report to screen and to file