класс компонента триммерного фильтра Babeltrace 2 (Babeltrace 2's trimmer filter component class)
Имя (Name)
babeltrace2-filter.utils.trimmer - Babeltrace 2's trimmer filter
component class
Описание (Description)
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
+-------------------+
See babeltrace2-intro(7) to learn more about the Babeltrace 2
project and its core concepts.
A filter.utils.trimmer
message iterator makes its upstream
message iterator seek the configured beginning time (see the
begin
parameter) before it starts to consume messages. This
seeking operation can have an effect on the times of stream
beginning, packet beginning, discarded events, and discarded
packets messages so that they fall within the configured trimming
time range.
As such, when a filter.utils.trimmer
message iterator consumes a
message of which the time is greater than the configured end time
(see the end
parameter), it can alter the time of stream end,
packet end, discarded events, and discarded packets messages so
that they fall within the configured trimming time range.
A filter.utils.trimmer
message iterator requires that all the
upstream messages it consumes have times, except for stream
beginning and end messages, returning an error status otherwise.
Параметры инициализации (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-MM-DD HH:II[:SS[.NANO]]
HH:II[:SS[.NANO]]
[-]SEC[.NANO]
YYYY
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.
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]
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
in
Single input port.
Output
out
Single 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: lttng-dev@lists.lttng.org
• 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>)