sourCEntral - mobile manpages

pdf

LTTNG−PERIODSTATS

NAME

lttng−periodstats − LTTng analyses period statistics

DESCRIPTION

usage: lttng−periodstats [−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

pdf