tcpprobe

TCPProbe

TCPProbe is a tool for network path and service monitoring. It exposes information about socket’s underlying TCP session, TLS and HTTP.

Features

• Expose TCP socket statistics
• Support TCP/TLS/HTTP
• Prometheus exporter
• Probing multiple hosts

Options

usage: tcpprobe options target(s)

options:
   --ipv6, -6                           connect only to IPv6 address (default: false)
   --ipv4, -4                           connect only to IPv4 address (default: false)
   --http2                              force to use HTTP version 2 (default: false)
   --json                               print in json format (default: false)
   --prom-disabled                      disable prometheus (default: false)
   --quiet, -q                          turn off tcpprobe output (default: false)
   --insecure, -i                       don't validate the server's certificate (default: false)
   --server-name value, -n value        server name is used to verify the hostname (TLS)
   --source-addr value, -S value        source address in outgoing request
   --prom-addr value, -p value          specify prometheus exporter IP and port (default: ":8081")
   --filter value, -f value             given metric(s) with semicolon delimited
   --count value, -c value              stop after sending count requests (default: 1)
   --timeout value, -t value            specify a timeout for dialing to targets (default: 1s)
   --wait value, -w value               time to wait after each request (default: 1s)
   --metrics                            show metric's descriptions (default: false)
   --help, -h                           show help (default: false)

Command line

tcpprobe https://www.google.com
Target:https://www.google.com IP:172.217.5.68 Timestamp:1604289587
State:1 CaState:0 Retransmits:0 Probes:0 Backoff:0 Options:4 Rto:202000 Ato:40000 SndMss:1460 RcvMss:1460 Unacked:0 Sacked:0 Lost:0 Retrans:0 Fackets:0 LastDataSent:70 LastAckSent:0 LastDataRecv:1 LastAckRecv:1 Pmtu:1500 RcvSsthresh:52560 Rtt:1856 Rttvar:1413 SndSsthresh:2147483647 SndCwnd:10 Advmss:1460 Reordering:3 RcvRtt:0 RcvSpace:29200 TotalRetrans:0 HTTPStatusCode:200 HTTPRcvdBytes:14682 HTTPRequest:105725 HTTPResponse:1092 DNSResolve:7222 TCPConnect:2856 TLSHandshake:36717 TCPConnectError:0 DNSResolveError:0 

Docker

docker run --rm mehrdadrad/tcpprobe https://www.google.com

Docker Compose

Run TCPProbe and Prometheus

docker-compose up -d

Open your browser and try http://localhost:9090 You can edit the docker-compose.yml to customize the options and target(s).

License

This project is licensed under MIT license. Please read the LICENSE file.

Contribute

Welcomes any kind of contribution, please follow the next steps:

• Fork the project on github.com.
• Create a new branch.
• Commit changes to the new branch.
• Send a pull request.