bcc-tcprtt(8)

1tcprtt(8)                   System Manager's Manual                  tcprtt(8)
2
3
4

NAME

6       tcprtt - Trace TCP RTT of established connections. Uses Linux eBPF/bcc.
7

SYNOPSIS

9       tcprtt  [-h] [-T] [-D] [-m] [-p LPORT] [-P RPORT] [-a LADDR] [-A RADDR]
10       [-i INTERVAL] [-d DURATION] [-b] [-B] [-e] [-4 | -6]
11

DESCRIPTION

13       This tool traces established connections RTT(round-trip time)  to  ana‐
14       lyze  the  quality  of  network.  This  can be useful for general trou‐
15       bleshooting to distinguish the network latency is from user process  or
16       physical network.
17
18       Since this uses BPF, only the root user can use this tool.
19

REQUIREMENTS

21       CONFIG_BPF and bcc.
22

OPTIONS

24       -h     Print usage message.
25
26       -T     Include a time column on output (HH:MM:SS).
27
28       -D     Show debug infomation of bpf text.
29
30       -m     Output histogram in milliseconds.
31
32       -i INTERVAL
33              Print output every interval seconds.
34
35       -d DURATION
36              Total duration of trace in seconds.
37
38       -p LPORT
39              Filter for local port.
40
41       -P RPORT
42              Filter for remote port.
43
44       -a LADDR
45              Filter for local address.
46
47       -A RADDR
48              Filter for remote address.
49
50       -b     Show sockets histogram by local address.
51
52       -B     Show sockets histogram by remote address.
53
54       -e     Show extension summary(average).
55
56       -4     Trace IPv4 family only.
57
58       -6     Trace IPv6 family only.
59

EXAMPLES

61       Trace TCP RTT and print 1 second summaries, 10 times:
62              # tcprtt -i 1 -d 10
63
64       Summarize in millisecond, and timestamps:
65              # tcprtt -m -T
66
67       Only trace TCP RTT for remote address 192.168.1.100 and remote port 80:
68              # tcprtt -i 1 -d 10 -A 192.168.1.100 -P 80
69
70       Trace local port and show a breakdown of remote hosts RTT:
71              # tcprtt -i 3 --lport 80 --byraddr
72
73       Trace IPv4 family only:
74              # tcprtt -4
75
76       Trace IPv6 family only:
77              # tcprtt -6
78

OVERHEAD

80       This  traces  the  kernel tcp_rcv_established function and collects TCP
81       RTT. The rate of this depends on your server application. If  it  is  a
82       web or proxy server accepting many tens of thousands of connections per
83       second.
84

SOURCE

86       This is from bcc.
87
88              https://github.com/iovisor/bcc
89
90       Also look in the bcc distribution for a  companion  _examples.txt  file
91       containing example usage, output, and commentary for this tool.
92

OS

94       Linux
95

STABILITY

97       Unstable - in development.
98

AUTHOR

100       zhenwei pi
101