1PERF-IOSTAT(1)                    perf Manual                   PERF-IOSTAT(1)
2
3
4

NAME

6       perf-iostat - Show I/O performance metrics
7

SYNOPSIS

9       perf iostat list
10       perf iostat <ports> -- <command> [<options>]
11

DESCRIPTION

13       Mode is intended to provide four I/O performance metrics per each PCIe
14       root port:
15
16       •   Inbound Read - I/O devices below root port read from the host
17           memory, in MB
18
19       •   Inbound Write - I/O devices below root port write to the host
20           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

OPTIONS

27       <command>...
28           Any command you can specify in a shell.
29
30       list
31           List all PCIe root ports.
32
33       <ports>
34           Select the root ports for monitoring. Comma-separated list is
35           supported.
36

EXAMPLES

38        1. List all PCIe root ports (example for 2-S platform):
39
40               $ perf iostat list
41               S0-uncore_iio_0<0000:00>
42               S1-uncore_iio_0<0000:80>
43               S0-uncore_iio_1<0000:17>
44               S1-uncore_iio_1<0000:85>
45               S0-uncore_iio_2<0000:3a>
46               S1-uncore_iio_2<0000:ae>
47               S0-uncore_iio_3<0000:5d>
48               S1-uncore_iio_3<0000:d7>
49
50        2. Collect metrics for all PCIe root ports:
51
52               $ perf iostat -- dd if=/dev/zero of=/dev/nvme0n1 bs=1M oflag=direct
53               357708+0 records in
54               357707+0 records out
55               375083606016 bytes (375 GB, 349 GiB) copied, 215.974 s, 1.7 GB/s
56
57               Performance counter stats for 'system wide':
58
59                  port             Inbound Read(MB)    Inbound Write(MB)    Outbound Read(MB)   Outbound Write(MB)
60               0000:00                    1                    0                    2                    3
61               0000:80                    0                    0                    0                    0
62               0000:17               352552                   43                    0                   21
63               0000:85                    0                    0                    0                    0
64               0000:3a                    3                    0                    0                    0
65               0000:ae                    0                    0                    0                    0
66               0000:5d                    0                    0                    0                    0
67               0000:d7                    0                    0                    0                    0
68
69        3. Collect metrics for comma-separated list of PCIe root ports:
70
71               $ perf iostat 0000:17,0:3a -- dd if=/dev/zero of=/dev/nvme0n1 bs=1M oflag=direct
72               357708+0 records in
73               357707+0 records out
74               375083606016 bytes (375 GB, 349 GiB) copied, 197.08 s, 1.9 GB/s
75
76               Performance counter stats for 'system wide':
77
78                  port             Inbound Read(MB)    Inbound Write(MB)    Outbound Read(MB)   Outbound Write(MB)
79               0000:17               358559                   44                    0                   22
80               0000:3a                    3                    2                    0                    0
81
82               197.081983474 seconds time elapsed
83

SEE ALSO

85       perf-stat(1)
86
87
88
89perf                              11/28/2023                    PERF-IOSTAT(1)
Impressum