Usage: dmstats [-h|--help] [-v|--verbose [-v|--verbose ...]] [--areas <nr_areas>] [--areasize <size>] [--userdata <data>] [--clear] [--count <count>] [--interval <seconds>] [-o <fields>] [-O|--sort <sort_fields>] [--programid <id>] [--start <start>] [--length <length>] [--segments] [--units <units>] help clear [--allregions|--regionid id] [--alldevices|<device>...] create [--start <start> [--length <len>] [--areas <nr_areas>] [--areasize <size>] [--programid <id>] [--userdata <data> ] [--bounds histogram_boundaries] [--precise] [--segments] [--alldevices|<device>...] create --filemap [--nogroup] [--nomonitor] [--follow mode] [--programid <id>] [--userdata <data> ] [--bounds histogram_boundaries] [--precise] <file_path> delete [--allprograms|--programid id] [--allregions|--regionid id] [--alldevices|<device>...] group [--alias NAME] --regions <regions> [--allprograms|--programid id] [--alldevices|<device>...] list [--allprograms|--programid id] [--allregions|--regionid id] print [--clear] [--allprograms|--programid id] [--allregions|--regionid id] [--alldevices|<device>...] report [--interval <seconds>] [--count <cnt>] [--units <u>] [--programid <id>] [--regionid <id>] [-o <fields>] [-O|--sort <sort_fields>] [-S|--select <selection>] [--nameprefixes] [--noheadings] [--separator <separator>] [--allprograms|--programid id] [<device>...] ungroup --groupid <id> [--allprograms|--programid id] [--alldevices|<device>...] update_filemap --groupid <id> [--nomonitor] [--follow mode] <file_path> version <device> may be device name or (if only one) -u <uuid> or -j <major> -m <minor> <fields> are comma-separated. Use 'help -c' for list.
Options (27)
| Option | Description | Source |
|---|---|---|
--alias name | Specify an alias name for a group. | man |
--alldevices | If no device arguments are given allow operation on all devices when creating or deleting regions. | man |
--allprograms | Include regions from all program IDs for list and report operations. | man |
--allregions | Include all present regions for commands that normally accept a single region identifier. | man |
--area | When performing a list or report, include objects of type area in the results. | man |
--areas nr_areas | Specify the number of statistics areas to create within a new region. | man |
--clear | When printing statistics counters, also atomically reset them to zero. | man |
--count count | Specify the iteration count for repeating reports. | man |
--group | When performing a list or report, include objects of type group in the results. | man |
--filemap | Instead of creating regions on a device as specified by command line options, open the file found at each file_path argument, and create regions corresponding to the locations of the on-disk extents… | man |
--follow follow_mode | Specify the dmfilemapd(8) file following mode. | man |
--foreground | Specify that the dmfilemapd(8) daemon should run in the foreground. | man |
--groupid id | Specify the group to operate on. | man |
--histogram | When used with the report and list commands select default fields that emphasize latency histogram data. | man |
--interval seconds | Specify the interval in seconds between successive iterations for repeating reports. | man |
--nogroup | When creating regions mapping the extents of a file in the file system, do not create a group or set an alias. | man |
--nomonitor | Disable the dmfilemapd(8) daemon when creating new file mapped groups. | man |
--nosuffix | Suppress the suffix on output sizes. | man |
--notimesuffix | Suppress the suffix on output time values. | man |
--precise | Attempt to use nanosecond precision counters when creating new statistics regions. | man |
--programid id | Specify a program ID string. | man |
--region | When performing a list or report, include objects of type region in the results. | man |
--regionid id | Specify the region to operate on. | man |
--regions region_list | Specify a list of regions to group. | man |
--relative | If displaying the histogram report show relative (percentage) values instead of absolute counts. | man |
--segments | When used with create, create a new statistics region for each target contained in the given device(s). | man |
--userdata user_data | Specify user data (a word) to be stored with a new region. | man |
Examples (10) from the manual page, untested
vg00/lvol1: Created new region with 1 area(s) as region ID 0
Create a whole-device region with one area on vg00/lvol1 # dmstats create vg00/lvol1d0: Created new region with 1 area(s) as region ID 0
Create a 32 MiB region 1 GiB into device d0 # dmstats create --start 1G --length 32M d0vg00-lvol1: Created new region with 8 area(s) as region ID 0
Create a whole-device region with 8 areas on every device # dmstats create --alldevices --areas 8vg00-lvol1: Created new region with 5 area(s) as region ID 1
Create a whole-device region with areas 10 GiB in size on vg00/lvol1 using dmsetup # dmsetup stats create --areasize 10G vg00/lvol1vg00-lvol1: Created new region with 16 area(s) as region ID 0
Create a 1 GiB region with 16 areas at the start of vg00/lvol1 # dmstats create --start 0 --length 1G --areas=16 vg00/lvol1Name RgID RStart RSize #Areas ASize ProgID
List the statistics regions registered on vg00/lvol1 # dmstats list vg00/lvol1Name RgID ArID AStart ASize RRqM/s WRqM/s R/s →
Display five statistics reports for vg00/lvol1 at an interval of one second # dmstats report --interval 1 --count 5 vg00/lvol1 # dmstats reportvg00-lvol1: Created new region with 1 area(s) as region ID 0
Create one region for each target contained in device vg00/lvol1 # dmstats create --segments vg00/lvol1images/vm1.qcow2: Created new group with 87 region(s) as group ID 0.
Create regions mapping each file in the directory images/ and place them into separate groups, each named after the corresponding file.2097152+65536 0 0 0 0 29 0 264 701 0 41 701 0 41
Print raw counters for region 4 on device d0 # dmstats print --regionid 4 d0