About

tcpkali is a high performance TCP and WebSocket load generator and sink.

tcpkali mascot

Features

Opens millions of connections from a single host by using available interface aliases.
Efficient multi-core operation (--workers); utilizes all available cores by default.
Allows opening massive number of connections (--connections)
Allows limiting an upstream and downstream of a single connection throughput (--channel-bandwidth-downstream, --channel-bandwidth-upstream or --message-rate)
Allows specifying the first and subsequent messages (--message, --first-message).
Measures response latency percentiles using HdrHistogram (--latency-marker)
Sends stats to StatsD/DataDog (--statsd)

Quick example: testing a web server

tcpkali -em "GET / HTTP/1.1\r\nHost: google.com\r\n\r\n" -r 10 \
        --latency-marker "HTTP/1.1" google.com:80

Install

From packages

OS	Package manager	Command
Mac OS X	Homebrew	`brew install tcpkali`
Mac OS X	MacPorts	`port install tcpkali`
FreeBSD	pkgng	`pkg install tcpkali`
Linux	nix	`nix-env -i tcpkali`

From sources

Install the following packages first:

autoconf
automake
libtool
bison
flex
gcc-c++
ncurses-devel or equivalent ncurses package, optional.

Build and install:

test -f configure || autoreconf -iv
./configure
make
sudo make install

Usage (Short version)

Usage: tcpkali [OPTIONS] [-l <port>] [<host:port>...]
Where some OPTIONS are:
  -h                   Print this help screen, then exit
  --help               Print long help screen, then exit
  -d                   Dump i/o data for a single connection

  -c <N>               Connections to keep open to the destinations
  -l <port>            Listen on the specified port
  --ws, --websocket    Use RFC6455 WebSocket transport
  -T <Time=10s>        Exit after the specified amount of time

  -e                   Unescape backslash-escaping in a message string
  -1 <string>          Message to send to the remote host once
  -m <string>          Message to repeatedly send to the remote
  -r <Rate>            Messages per second to send in a connection

Variable units and recognized multipliers:
  <N>, <Rate>:  k (1000, as in "5k" is 5000), m (1000000)
  <Time>:       ms, s, m, h, d (milliseconds, seconds, minutes, hours, days)
  <Rate> and <Time> can be fractional values, such as 0.25.

You can get the full list of options using tcpkali --help, from man tcpkali, and by consulting the tcpkali man page source.

Usage Examples

A few command line examples

## TCP Examples Connect to a local web server and do nothing: tcpkali 127.0.0.1:80 Connect to a local echo server and hammer it with stream of dollars: tcpkali --message '$' localhost:echo tcpkali -m '$' localhost:echo Open 10000 connections to two remote servers: tcpkali --connections 10000 yahoo.com:80 google.com:80 tcpkali -c 10k yahoo.com:80 google.com:80 Open 100 connections to itself and do nothing: tcpkali --connections 100 --listen-port 12345 127.0.0.1:12345 tcpkali -c100 -l12345 127.1:12345 Open a connection to itself and send lots of cookies: tcpkali --listen-port 12345 --message "cookies" 127.0.0.1:12345 tcpkali -l 12345 -m "cookies" 127.1:12345 Listen for incoming connections and throw away data for 3 hours: tcpkali --listen-port 12345 --duration 3h tcpkali -l12345 -T3h ## WebSocket examples Open connection to the local WebSocket server, send hello, and wait: tcpkali --websocket --first-message "hello" 127.0.0.1:80 Open connection to the local server and send tons of empty JSON frames: tcpkali --websocket --message "\{ws.text}" 127.1:80 Send a binary frame with a picture every second (angle brackets are literal): tcpkali --ws -m "\{ws.binary }" -r1 127.1:80

satori-com / tcpkali

readme