Jump to: navigation, search

Debug Logging Segmentation

Starting with Release 8.1.300.52, ORS supports Debug Logging Segmentation, which provides more precise control of the logging when the log-trace-segments option is configured. The debug segment header {<segment_name>:<log_level>} is now added right after the timestamp. For example: 10:31:02.249 {ScxmlMetric:3} METRIC <event_queued sid='MLO6K6519D5UPAGSHNE41VJBSS00000M' name='interaction.added' type='external' thread='15800' />

Use this option to specify the debug messages that will be printed into the log files. When set to all or All (the default), all debug messages are printed with the log level defined by the log/x-server-trace-level option. To control the log levels for each segment, use syntax: <segment_name>:<log_level>. If <log_level> is not specified or invalid, ORS applies the default value (defined in x-server-trace-level). If an unknown segment is specified, ORS ignores it without generating an error.

Example:

Setting Description
all, ORSInternal:0, ORSURS:0 Everything is enabled except ORSInternal and ORSURS
ScxmlIO,ThreadSync Only ScxmlIO and ThreadSync are enabled
all,ORSURS Everything is enabled (the same as all)
ORSURS:0 Everything is disabled (the same as empty)
CallMonitor,all:0 Everything is disabled (the same as empty)
all,ORSURS:1 Everything is enabled with the default trace level, but the trace level for the ORSURS segment will be changed to 1
(empty) Everything is disabled (the same as all:0, or x-server-trace-level=0)
all:3 The same as all with x-server-trace-level=3

Note: Starting with ORS 8.1.400.31, a new Debug Log Segment header ScxmlMetricEvalExpr is added for METRIC:eval_expr. In a log file, it will appear as follows:

14:47:11.414 [T:8436] {ScxmlMetricEvalExpr:3} METRIC <eval_expr sid='ors2521' expression='global._data = 
new Object();' result='[object Object]' thread='8436' /> 

As a result, the log-trace-segments option adds ScxmlMetricEvalExpr as a new value.

Also see filter-eval-expr.

This page was last edited on November 2, 2016, at 18:19.
Comments or questions about this documentation? Contact us for support!