Skip to main content
Version: 9.0.2

logger

Plugin Name: logger (-ologger,...) / Shared Library: libgre-plugin-logger

Caution

In the Storyboard 7.0 release, performance analysis and metrics reporting were moved into their own plugins, libgre-plugin-trace and libgre-plugin-metrics. These plugins accept their own options, described below, and also accept options specified to the logger plugin, for example -ologger,perf=1.

This functionality is considered deprecated and the options specified to the logger plugin will not be picked up by the trace and metrics plugins in a future release. It is strongly recommended to update any launching of the engine that passes trace and metrics options to the logger plugin to use the -otrace and -ometrics specifiers instead.

buffer=[bytes]

This option will buffer all logging output to an allocated in-memory buffer and only flush the output when the buffer content is full. The number of bytes allocated for the buffer are provided by the option to the argument. If the buffer size is 0 or invalid, then 4K will be allocated for the buffer.

data

This option enables the logging of data change events as they occur. The data key that has been changed is displayed to standard output.

event=[event_name]

This option will enable the generation of a custom Storyboard event any time that an ERROR message is detected by the Storyboard Engine logging system. When the error is detected, an event "event_name" will be sent to the application and it will contain a payload of "1s0 msg" where the "msg" is the diagnostic string that would have been logged.

filter=[keyword]

This option enables filtering of events based on the keyword provided. Multiple keywords can be specified. Filtered events are delimited by a ':'. sbengine -ologger,io,filter=gre.press:gre.release Each keyword can also be negated by the '^' symbol. Therefore we could ignore all motion events by passing in the following command: -ologger,io,filter=^gre.motion Filtering applies to the 'io' and 'data' options. If neither 'io' or 'data' options are specified, then this option does nothing.

io=[level]

This option enables the logging of IO events in variable levels of verbosity. If no option is specified then the level will default to 1 and the event name and its size in bytes will be displayed. If 2 is specified then the format is displayed. If 3 is specified then the data payload will be dumped to the standard output in both hexadecimal and character formats.

logger_event_prefix=[prefix]

This option specifies the prefix to use in the logger event names. This defaults to "logger".

output=[filename]

This option specifies a path in the file system to direct the Storyboard standard output to. The directory path to the file must already exist.

+ At the beginning of the file name will append to the log file, otherwise the file will be overridden on each invocation of sbengine.

%D in the filename will be replaced by a date stamp with YYYY-MM-DD format.

%T in the filename will be replaced by a 24h time stamp with HHMMSS format.

Both %D and %T may be used on the same filename.

A valid command would be: -ologger,output=/logs/log-%D-%T.txt, provided the /logs/ directory existed prior to runtime.

slogger=[opcode]

This option specifies that sbengine should use the QNX system logging infrastructure. if no opcode is given, sbengine will provide an appropriate opcode.

The opcode is a combination of a major and minor code. Create the opcode using the _SLOG_SETCODE(major, minor) macro that's defined in sys/slog.h.

This option is only available for systems running QNX.