NAME

       lttng-iolatencystats - LTTng analyses IO latency statistics

DESCRIPTION

       usage: lttng-iolatencystats [-h] [-r REFRESH] [--gmt] [--skip-validation]

       [--begin BEGIN] [--end END]
              [--period-begin   PERIOD_BEGIN]   [--period-end   PERIOD_END]   [--period-begin-key
              PERIOD_BEGIN_KEY]     [--period-end-key     PERIOD_END_KEY]     [--period-key-value
              PERIOD_KEY_VALUE]   [--cpu   CPU]   [--timerange  TIMERANGE]  [-V]  [--no-progress]
              [--procname PROCNAME] [--tid TID] [--min MIN] [--max MAX] [--log]  [--limit  LIMIT]
              [--top]  [--stats]  [--freq]  [--freq-resolution  FREQ_RESOLUTION] [--freq-uniform]
              [--freq-series] [--usage] [--minsize MINSIZE] [--maxsize MAXSIZE] <path/to/trace>

       The I/O command.

   positional arguments:
       <path/to/trace>
              trace path

   optional arguments:
       -h, --help
              show this help message and exit

       -r REFRESH, --refresh REFRESH
              Refresh period, with optional units suffix (default units: s)

       --gmt  Manipulate timestamps based on GMT instead of local time

       --skip-validation
              Skip the trace validation

       --begin BEGIN
              start time: hh:mm:ss[.nnnnnnnnn]

       --end END
              end time: hh:mm:ss[.nnnnnnnnn]

       --period-begin PERIOD_BEGIN
              Analysis period start marker event name

       --period-end PERIOD_END
              Analysis period end marker event name (requires --period-begin)

       --period-begin-key PERIOD_BEGIN_KEY
              Optional, list of event field names used to match period markers (default: cpu_id)

       --period-end-key PERIOD_END_KEY
              Optional, list of event field names used to match period marker. If none specified,
              use the same --period-begin-key

       --period-key-value PERIOD_KEY_VALUE
              Optional,  define  a  fixed  key  value  to  which  a  period must correspond to be
              considered.

       --cpu CPU
              Filter the results only for this list of CPU IDs

       --timerange TIMERANGE
              time range: [begin,end]

       -V, --version
              show program's version number and exit

       --no-progress
              Don't display the progress bar

       --procname PROCNAME
              Filter the results only for this list of process names

       --tid TID
              Filter the results only for this list of TIDs

       --min MIN
              Filter out durations shorter than min usec

       --max MAX
              Filter out durations longer than max usec

       --log  Output the I/O requests in chronological order

       --limit LIMIT
              Limit to top X (default = 10)

       --top  Output the top I/O latencies by category

       --stats
              Output the I/O latency statistics

       --freq Output the I/O latency frequency distribution

       --freq-resolution FREQ_RESOLUTION
              Frequency distribution resolution (default 20)

       --freq-uniform
              Use a uniform resolution across distributions

       --freq-series
              Consolidate frequency distribution histogram as a single one

       --usage
              Output the I/O usage

       --minsize MINSIZE
              Filter out, I/O operations working with less that minsize bytes

       --maxsize MAXSIZE
              Filter out, I/O operations working with more that maxsize bytes