NAME
babeltrace2-filter.utils.trimmer - Babeltrace 2's trimmer filter component classDESCRIPTION
A Babeltrace 2 filter.utils.trimmer message iterator discards all the consumed messages with a time less than a given beginning time and greater than a given end time. It effectively “cuts”, or trims trace streams.
+-------------------+
| flt.utils.trimmer |
| |
Messages -->@ in out @--> Less messages
+-------------------+
INITIALIZATION PARAMETERS
begin=TIME [optional string or signed integer]Set the trimming time range’s beginning
time to TIME.
If TIME is a string, see below for its format. If TIME is a signed
integer, the component converts it to a string and treats it as such.
If you don’t specify this parameter, the component discards no events
until the end of the trimming time range.
The format of TIME when it’s a string is one of:
YYYY
If TIME has no date information, then the message iterator uses the first
upstream message’s time to determine the date.
end=TIME [optional string or signed integer]
YYYY-MM-DD HH:II[:SS[.NANO]] HH:II[:SS[.NANO]] [-] SEC[.NANO]
4-digit year.
MM
2-digit month (January is 01).
DD
2-digit day.
HH
2-digit hour (24-hour format).
II
2-digit minute.
SS
2-digit second.
NANO
Nanoseconds (up to nine digits).
SEC
Seconds since origin.
Set the trimming time range’s end time
to TIME.
If TIME is a string, see the begin parameter for its format. If
TIME is a signed integer, the component converts it to a string and
treats it as such.
If you don’t specify this parameter, the component discards no events
from the beginning of the trimming time range.
gmt=yes [optional boolean]
Set the time zone of the begin and
end parameters to GMT instead of the local time zone.
PORTS
+-------------------+ | flt.utils.trimmer | | | @ in out @ +-------------------+
Input
inSingle input port.
Output
outSingle output port.
BUGS
If you encounter any issue or usability problem, please report it on the Babeltrace bug tracker (see <https://bugs.lttng.org/projects/babeltrace>).RESOURCES
The Babeltrace project shares some communication channels with the LTTng project (see <https://lttng.org/>).•Babeltrace website (see
<https://babeltrace.org/>)
•Mailing list (see
<https://lists.lttng.org>) for support and development:
[email protected]
•IRC channel (see
<irc://irc.oftc.net/lttng>): #lttng on irc.oftc.net
•Bug tracker (see
<https://bugs.lttng.org/projects/babeltrace>)
•Git repository (see
<https://git.efficios.com/?p=babeltrace.git>)
•GitHub project (see
<https://github.com/efficios/babeltrace>)
•Continuous integration (see
<https://ci.lttng.org/view/Babeltrace/>)
•Code review (see
<https://review.lttng.org/q/project:babeltrace>)