lttng-periodlog1
Lttng analyses period log
Overview
usage: lttng-periodlog [-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
Releases
Unchanged in 4 releases since Debian 9 (Stretch).