dachad/tcpgoon
Tool to test concurrent connections towards a server listening to a TCP port
Image
1
10K+
dachad/tcpgoon repository overview
Description
- Given a hostname, port, the number of connections (100 by default), a delay between connections (10ms by default) and an interval between stats updates to the standard output...
- It will use goroutines to open TCP connections and try to read from them
- The tool will exit once all connections have been dialed (successfully or not)
- Exit status different from 0 represent executions where all connections were not established successfully, facilitating the integration in test suites.
Usage
% docker run -ti dachad/tcpgoon --help
tcpgoon tests concurrent connections towards a server listening on a TCP port
Usage:
tcpgoon [command]
Available Commands:
help Help about any command
run Run tcpgoon test
version Show tcpgoon version
Flags:
-h, --help help for tcpgoon
Use "tcpgoon [command] --help" for more information about a command.
% docker run -ti dachad/tcpgoon run --help
Run tcpgoon test
Usage:
tcpgoon run [flags] <host> <port>
Flags:
-y, --assume-yes Force execution without asking for confirmation
-c, --connections int Number of connections you want to open (default 100)
-d, --debug Print debugging information to the standard error
-t, --dial-timeout int Connection dialing timeout, in ms (default 5000)
-h, --help help for run
-i, --interval int Interval, in seconds, between stats updates (default 1)
-s, --sleep int Time you want to sleep between connections, in ms (default 10)
Examples
Note: depending on the number of connections you want to open, you may need to increase the number of file descriptors your user/docker installation supports
Successful execution (connections were opened as expected):
% docker run -ti dachad/tcpgoon run myhttpsamplehost.com 80 --connections 10 --sleep 999 -y
Total: 10, Dialing: 0, Established: 0, Closed: 0, Error: 0, NotInitiated: 10
Total: 10, Dialing: 1, Established: 1, Closed: 0, Error: 0, NotInitiated: 8
Total: 10, Dialing: 1, Established: 2, Closed: 0, Error: 0, NotInitiated: 7
Total: 10, Dialing: 1, Established: 3, Closed: 0, Error: 0, NotInitiated: 6
Total: 10, Dialing: 1, Established: 4, Closed: 0, Error: 0, NotInitiated: 5
Total: 10, Dialing: 1, Established: 5, Closed: 0, Error: 0, NotInitiated: 4
Total: 10, Dialing: 1, Established: 6, Closed: 0, Error: 0, NotInitiated: 3
Total: 10, Dialing: 1, Established: 7, Closed: 0, Error: 0, NotInitiated: 2
Total: 10, Dialing: 1, Established: 8, Closed: 0, Error: 0, NotInitiated: 1
Total: 10, Dialing: 1, Established: 9, Closed: 0, Error: 0, NotInitiated: 0
Total: 10, Dialing: 0, Established: 10, Closed: 0, Error: 0, NotInitiated: 0
--- myhttpsamplehost.com(216.58.201.131):80 tcp test statistics ---
Total: 10, Dialing: 0, Established: 10, Closed: 0, Error: 0, NotInitiated: 0
--- tcpgoon execution statistics ---
Total established connections: 10
Max concurrent established connections: 10
Number of established connections on closure: 10
Response time stats for 10 established connections min/avg/max/dev = 17.929ms/19.814ms/29.811ms/3.353ms
% echo $?
0
Using with whalebrew
% WHALEBREW_INSTALL_PATH=$HOME/bin whalebrew install dachad/tcpgoon
🐳 Installed dachad/tcpgoon to /home/caba/bin/tcpgoon
% tcpgoon run myhttpsamplehost.com 80 -c 2 -y
Total: 2, Dialing: 0, Established: 0, Closed: 0, Error: 0, NotInitiated: 2
Total: 2, Dialing: 0, Established: 2, Closed: 0, Error: 0, NotInitiated: 0
--- myhttpsamplehost.com(216.58.201.131):80 tcp test statistics ---
Total: 2, Dialing: 0, Established: 2, Closed: 0, Error: 0, NotInitiated: 0
--- tcpgoon execution statistics ---
Total established connections: 2
Max concurrent established connections: 2
Number of established connections on closure: 2
Response time stats for 2 established connections min/avg/max/dev = 57.606ms/63.499ms/69.391ms/5.892ms
% echo $?
0
Where can I find more info?
Tag summary
Content type
Image
Digest
Size
1.7 MB
Last updated
over 6 years ago
docker pull dachad/tcpgoon