projects / mirror_ubuntu-jammy-kernel.git / blame
| Commit | Line | Data |
|---|---|---|
| f9ed693e AA |
1 | perf-iostat(1) |
| 2 | =============== | |
| 3 | ||
| 4 | NAME | |
| 5 | ---- | |
| 6 | perf-iostat - Show I/O performance metrics | |
| 7 | ||
| 8 | SYNOPSIS | |
| 9 | -------- | |
| 10 | [verse] | |
| 11 | 'perf iostat' list | |
| f2c24eba | 12 | 'perf iostat' <ports> \-- <command> [<options>] |
| f9ed693e AA |
13 | |
| 14 | DESCRIPTION | |
| 15 | ----------- | |
| 16 | Mode 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 | ||
| 26 | OPTIONS | |
| 27 | ------- | |
| 28 | <command>...:: | |
| 29 | Any command you can specify in a shell. | |
| 30 | ||
| 31 | list:: | |
| 32 | List all PCIe root ports. | |
| 33 | ||
| 34 | <ports>:: | |
| 35 | Select the root ports for monitoring. Comma-separated list is supported. | |
| 36 | ||
| 37 | EXAMPLES | |
| 38 | -------- | |
| 39 | ||
| 40 | 1. 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 | ||
| 52 | 2. 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 | ||
| 71 | 3. 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 | ||
| 86 | SEE ALSO | |
| 87 | -------- | |
| f2c24eba | 88 | linkperf:perf-stat[1] |