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] [-i INTERVAL] [-d DURATION] [-b] [-B] [-e]
10

DESCRIPTION

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

REQUIREMENTS

20       CONFIG_BPF and bcc.
21

OPTIONS

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

EXAMPLES

56       Trace TCP RTT and print 1 second summaries, 10 times:
57              # tcprtt -i 1 -d 10
58
59       Summarize in millisecond, and timestamps:
60              # tcprtt -m -T
61
62       Only trace TCP RTT for remote address 192.168.1.100 and remote port 80:
63              # tcprtt -i 1 -d 10 -A 192.168.1.100 -P 80
64
65       Trace local port and show a breakdown of remote hosts RTT:
66              # tcprtt -i 3 --lport 80 --byraddr
67

OVERHEAD

69       This traces the kernel tcp_rcv_established function  and  collects  TCP
70       RTT.  The  rate  of this depends on your server application. If it is a
71       web or proxy server accepting many tens of thousands of connections per
72       second.
73

SOURCE

75       This is from bcc.
76
77              https://github.com/iovisor/bcc
78
79       Also  look  in  the bcc distribution for a companion _examples.txt file
80       containing example usage, output, and commentary for this tool.
81

OS

83       Linux
84

STABILITY

86       Unstable - in development.
87

AUTHOR

89       zhenwei pi
90