BABELTRACE-SINK.U(7)          Babeltrace manual         BABELTRACE-SINK.U(7)

NAME         top

       babeltrace-sink.utils.counter - Babeltrace's notification counter
       sink component class

DESCRIPTION         top

       The Babeltrace sink.utils.counter component class, provided by the
       babeltrace-plugin-utils(7) plugin, once instantiated, prints to the
       standard output the number of notifications it receives on its input
       port, with a count for each type.

       The component’s output looks like this:

                    664891 events
                        12 stream beginnings
                         0 stream ends
                        93 packet beginnings
                        81 packet ends
                         0 inactivities
                         6 discarded events notifications
                    375378   known discarded events
                         2 discarded packets notifications
                         5   known discarded packets
                   1040455 notifications (TOTAL)

       By default, a sink.utils.counter component prints a new block of
       statistics every 1000 received notifications, whatever their types.
       You can use the step parameter to override this default period.

       The component always prints a block of statistics when there’s no
       more notifications to receive from its input port and the last block
       was different.

       By default, a sink.utils.counter component prints the count of
       notifications for each type, even if this count is 0. You can make it
       hide the zero counts with the hide-zero parameter.


       The following parameters are optional.

       hide-zero=yes (boolean)
           Do not print the statistics lines where the count is zero.

       step=STEP (integer)
           Print a new block of statistics every STEP received notifications
           instead of 1000. If STEP is 0, then the component only prints
           statistics when there’s no more notifications to receive.

PORTS         top

           Single input port from which the component receives the
           notifications to count.

QUERY OBJECTS         top

       This component class has no objects to query.


           Common functions’s log level. The available values are the same
           as for the --log-level option of babeltrace(1).

           Compatibility functions’s log level. The available values are the
           same as for the --log-level option of babeltrace(1).

           Force the terminal color support. The available values are:

               Only emit terminal color codes when the standard output and
               error streams are connected to a color-capable terminal.

               Never emit terminal color codes.

               Always emit terminal color codes.

BUGS         top

       If you encounter any issue or usability problem, please report it on
       the Babeltrace bug tracker (see

RESOURCES         top

       The Babeltrace project shares some communication channels with the
       LTTng project (see <>).

       ·   Babeltrace website (see <>)

       ·   Git repository (see

       ·   EfficiOS GitHub organization (see <>)

       ·   Continuous integration (see

       ·   Mailing list (see <>) for support and

       ·   IRC channel (see <irc://>): #lttng on

AUTHORS         top

       The Babeltrace project is the result of efforts by many regular
       developers and occasional contributors.

       The current project maintainer is Jérémie Galarneau

COPYRIGHT         top

       This component class is part of the Babeltrace project.

       Babeltrace is distributed under the MIT license (see

SEE ALSO         top

       babeltrace-plugin-utils(7), babeltrace-intro(7)

COLOPHON         top

       This page is part of the babeltrace (trace read and write libraries
       and a trace converter) project.  Information about the project can be
       found at ⟨⟩.  If you have a bug
       report for this manual page, send it to
       This page was obtained from the project's upstream Git repository
       ⟨git://⟩ on 2018-02-02.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2018-01-30.)  If you discover any rendering problems in
       this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to

Babeltrace 2.0.0-pre4          5 October 2017           BABELTRACE-SINK.U(7)

Pages that refer to this page: babeltrace(1)babeltrace-plugin-utils(7)