1perf-iostat(1)
2===============
3
4NAME
5----
6perf-iostat - Show I/O performance metrics
7
8SYNOPSIS
9--------
10[verse]
11'perf iostat' list
12'perf iostat' <ports> -- <command> [<options>]
13
14DESCRIPTION
15-----------
16Mode is intended to provide four I/O performance metrics per each PCIe root port:
17
18- Inbound Read   - I/O devices below root port read from the host memory, in MB
19
20- Inbound Write  - I/O devices below root port write to the host memory, in MB
21
22- Outbound Read  - CPU reads from I/O devices below root port, in MB
23
24- Outbound Write - CPU writes to I/O devices below root port, in MB
25
26OPTIONS
27-------
28<command>...::
29	Any command you can specify in a shell.
30
31list::
32	List all PCIe root ports.
33
34<ports>::
35	Select the root ports for monitoring. Comma-separated list is supported.
36
37EXAMPLES
38--------
39
401. List all PCIe root ports (example for 2-S platform):
41
42   $ perf iostat list
43   S0-uncore_iio_0<0000:00>
44   S1-uncore_iio_0<0000:80>
45   S0-uncore_iio_1<0000:17>
46   S1-uncore_iio_1<0000:85>
47   S0-uncore_iio_2<0000:3a>
48   S1-uncore_iio_2<0000:ae>
49   S0-uncore_iio_3<0000:5d>
50   S1-uncore_iio_3<0000:d7>
51
522. Collect metrics for all PCIe root ports:
53
54   $ perf iostat -- dd if=/dev/zero of=/dev/nvme0n1 bs=1M oflag=direct
55   357708+0 records in
56   357707+0 records out
57   375083606016 bytes (375 GB, 349 GiB) copied, 215.974 s, 1.7 GB/s
58
59    Performance counter stats for 'system wide':
60
61      port             Inbound Read(MB)    Inbound Write(MB)    Outbound Read(MB)   Outbound Write(MB)
62   0000:00                    1                    0                    2                    3
63   0000:80                    0                    0                    0                    0
64   0000:17               352552                   43                    0                   21
65   0000:85                    0                    0                    0                    0
66   0000:3a                    3                    0                    0                    0
67   0000:ae                    0                    0                    0                    0
68   0000:5d                    0                    0                    0                    0
69   0000:d7                    0                    0                    0                    0
70
713. Collect metrics for comma-separated list of PCIe root ports:
72
73   $ perf iostat 0000:17,0:3a -- dd if=/dev/zero of=/dev/nvme0n1 bs=1M oflag=direct
74   357708+0 records in
75   357707+0 records out
76   375083606016 bytes (375 GB, 349 GiB) copied, 197.08 s, 1.9 GB/s
77
78    Performance counter stats for 'system wide':
79
80      port             Inbound Read(MB)    Inbound Write(MB)    Outbound Read(MB)   Outbound Write(MB)
81   0000:17               358559                   44                    0                   22
82   0000:3a                    3                    2                    0                    0
83
84        197.081983474 seconds time elapsed
85
86SEE ALSO
87--------
88linkperf:perf-stat[1]