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