table of contents
| LTTNG-PERIODFREQ(1) | User Commands | LTTNG-PERIODFREQ(1) |
NAME¶
lttng-periodfreq - LTTng analyses period frequency
DESCRIPTION¶
usage: lttng-periodfreq [-h] [-r REFRESH] [--gmt] [--skip-validation]
- [--begin BEGIN] [--end END] [--period PERIOD]
- [--period-captures PERIOD_CAPTURES] [--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] [--progress-use-size] [--no-intersection] [-V] [--debug] [--no-color] [--no-progress] [--min MIN] [--max MAX] [--freq] [--freq-resolution FREQ_RESOLUTION] [--freq-uniform] [--freq-series] [--limit LIMIT] [--top] [--log] [--stats] [--min-duration MIN_DURATION] [--max-duration MAX_DURATION] [--aggregate-by AGGREGATE_BY] [--select SELECT] [--group-by GROUP_BY] [--order-by ORDER_BY] <path/to/trace>
The periods 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 PERIOD
- Period definition
- --period-captures PERIOD_CAPTURES
- Period captures definition
- --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]
- --progress-use-size
- use trace size to approximate progress
- --no-intersection
- disable stream intersection mode
- -V, --version
- show program's version number and exit
- --debug
- Enable debug mode (or set LTTNG_ANALYSES_DEBUG environment variable)
- --no-color
- Disable colored output
- --no-progress
- Don't display the progress bar
- --min MIN
- Filter out durations shorter than min usec
- --max MAX
- Filter out durations longer than max usec
- --freq
- Output statistics about periods durations
- --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
- --limit LIMIT
- Limit to top X (default = 10)
- --top
- Output the top sched switch durations
- --log
- Output the sched switches in chronological order
- --stats
- Output sched switch statistics
- --min-duration MIN_DURATION
- Filter out, periods shorter that duration (usec)
- --max-duration MAX_DURATION
- Filter out, periods longer than duration (usec)
- --aggregate-by AGGREGATE_BY
- FIXME
- --select SELECT
- FIXME
- --group-by GROUP_BY
- Present the results grouped by a list of fields(period.captured_field[, period.captured_field2])
- --order-by ORDER_BY
- hierarchy, time
| January 2017 | LTTng Analyses v0.6.0 |