Debian Codegraph @

testsuite/systemtap.examples/lwtools/fsslower-nd.8

raw
1 .TH fsslower-nd 8 "2015-01-30" "USER COMMANDS"
2 .SH NAME
3 fsslower-nd \- Trace slow file system sync reads and writes. Uses Linux SystemTap (non-debuginfo).
4 .SH SYNOPSIS
5 .B fsslower-nd.stp
6 [min_ms]
7 .SH DESCRIPTION
8 fsslower-nd.stp dynamically traces two common file system functions:
9 do_sync_read() and do_sync_write(), and shows details of each call that is
10 slower than a threshold. Many, but not all, file systems and
11 workloads use these functions. Tracing their time provides one view of
12 suffered file system latency.
13
14 Other file system requests not covered by these functions and this tool include:
15 asynchronous I/O, directory operations, and file handle operations.
16 .SH REQUIREMENTS
17 SystemTap.
18 .SH OPTIONS
19 .TP
20 min_ms
21 Minimum millisecond threshold.
22 .SH EXAMPLES
23 .TP
24 Measure (most) file system synchronous read and write requests with latency slower than or equal to 5 ms:
25 #
26 .B fsslower-nd.stp 5
27 .SH FIELDS
28 .TP
29 TIME
30 Time of the event completion.
31 .TP
32 PID
33 Process ID.
34 .TP
35 COMM
36 Process name.
37 .TP
38 FUNC
39 Kernel function traced.
40 .TP
41 SIZE
42 Size of FS request, in bytes.
43 .TP
44 LAT(ms)
45 Latency of function, in milliseconds.
46 .SH OVERHEAD
47 The overheads are measurable, as file system requests can be very frequent, and
48 the small overhead of tracing each (eg, 4 microseconds per call) can begin to
49 add up. Best case, it won't be noticeable. Worst case, the application may run
50 2x slower.
51 .SH SOURCE
52 This is from the SystemTap lwtools collection.
53 .IP
54 https://github.com/brendangregg/systemtap-lwtools
55 .PP
56 Also look under the examples directory for a text file containing example
57 usage, output, and commentary for this tool.
58 .SH OS
59 Linux
60 .SH STABILITY
61 Unstable - in development.
62 .SH AUTHOR
63 Brendan Gregg
64 .SH SEE ALSO
65 iostat(1), fslatency-nd.stp(8), biolatency-nd.stp(8)