tcpsynbl(8)

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

NAME

6       tcpsynbl - Show the TCP SYN backlog as a histogram. Uses bpftrace/eBPF.
7

SYNOPSIS

9       tcpsynbl
10

DESCRIPTION

12       This  tool  shows the TCP SYN backlog size during SYN arrival as a his‐
13       togram.  This lets you see how close your applications are  to  hitting
14       the  backlog  limit  and dropping SYNs (causing performance issues with
15       SYN retransmits), and is a measure of  workload  saturation.  The  his‐
16       togram  shown  is  measured at the time of SYN received, and a separate
17       histogram is shown for each backlog limit.
18
19       This    works    by    tracing    the    tcp_v4_syn_recv_sock()     and
20       tcp_v6_syn_recv_sock()  kernel functions using dynamic instrumentation.
21       Since these functions may change in future kernels, this tool may  need
22       maintenance to keep working.
23
24       Since this uses BPF, only the root user can use this tool.
25

REQUIREMENTS

27       CONFIG_BPF and bpftrace.
28

EXAMPLES

30       Show the TCP SYN backlog as a histogram.
31              # tcpsynbl.bt
32

FIELDS

34       backlog
35              The backlog size when a SYN was received.
36
37       count  The number of times this backlog size was encountered.
38
39       distribution
40              An ASCII visualization of the count column.
41

OVERHEAD

43       Inbound  SYNs  should  be  relatively low compared to packets and other
44       events, so the overhead of this tool is expected to be negligible.
45

SOURCE

47       This tool originated from the book "BPF Performance  Tools",  published
48       by Addison Wesley (2019):
49
50              http://www.brendangregg.com/bpf-performance-tools-book.html
51
52       See the book for more documentation on this tool.
53
54       This version is in the bpftrace repository:
55
56              https://github.com/iovisor/bpftrace
57
58       Also  look  in  the bpftrace distribution for a companion _examples.txt
59       file containing example usage, output, and commentary for this tool.
60

OS

62       Linux
63

STABILITY

65       Unstable - in development.
66

AUTHOR

68       Brendan Gregg
69