Difference between revisions of "Config:Logging"
m (New page: == Logging == === Custom Options === Available options: <source lang="xml"> <Option key="handlers" value="java.util.logging.ConsoleHandler,java.util.logging.FileHandler"/> <Option key=".le...) |
|||
(6 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
+ | By default, the SUMO Toolbox displays messages about the progress the modeling process to the Matlab console and also writes them to a log file which can be found in the output folder. A general log file is also generated and saved in the ''output'' folder in the SUMO Root directory. The logging configuration lets you control the granularity of the messages and the source of the messages. The possible granularity levels are "OFF, SEVERE, WARNING, INFO, FINE, FINER, FINEST, ALL". | ||
+ | |||
+ | The ConsoleHandler configuration lets you control the granularity of the console messages and the FileHandler lets you control the granularity of the messages written to the log file. You can also control the granularity of the messages generated by the Matlab code in the toolbox and that of the messages generated by the Java code in the Toolbox. | ||
+ | |||
+ | '''Generated for SUMO toolbox version 7.0'''. | ||
+ | ''We are well aware that documentation is not always complete and possibly even out of date in some cases. We try to document everything as best we can but much is limited by available time and manpower. We are an university research group after all. The most up to date documentation can always be found (if not here) in the default.xml configuration file and, of course, in the source files. If something is unclear please dont hesitate to [[Reporting problems|ask]].'' | ||
== Logging == | == Logging == | ||
+ | === RootLogger === | ||
+ | Root logger | ||
+ | <source xmlns:saxon="http://icl.com/saxon" lang="xml"> | ||
+ | |||
+ | <!--Root logger--> | ||
+ | <[[Config:RootLogger|RootLogger]]> | ||
+ | |||
+ | <!-- log all run-specific information in the main log as well --> | ||
+ | <Option key="runsInMainLog" value="true"/> | ||
+ | |||
+ | <!-- Set the default logging level for the root logger --> | ||
+ | <Option key="Level" value="INFO"/> | ||
+ | |||
+ | <!-- Specify the handlers to create in the root logger | ||
+ | (all loggers are children of the root logger). The handlers determine | ||
+ | where logging output is sent to. | ||
+ | |||
+ | Possible levels are: OFF, SEVERE, WARNING, INFO, FINE, FINER, FINEST, ALL | ||
+ | --> | ||
+ | <[[Config:Handlers|Handlers]]> | ||
+ | <!-- Configure ConsoleHandler (= output to the screen) --> | ||
+ | <[[Config:ConsoleHandler|ConsoleHandler]]> | ||
+ | <Option key="Level" value="INFO"/> | ||
+ | </[[Config:ConsoleHandler|ConsoleHandler]]> | ||
+ | |||
+ | <!-- Configure FileHandler (= output to file)--> | ||
+ | <[[Config:FileHandler|FileHandler]]> | ||
+ | <Option key="Level" value="ALL"/> | ||
+ | </[[Config:FileHandler|FileHandler]]> | ||
+ | </[[Config:Handlers|Handlers]]> | ||
+ | </[[Config:RootLogger|RootLogger]]></source> | ||
=== Custom Options === | === Custom Options === | ||
Available options: | Available options: | ||
− | <source | + | <source xmlns:saxon="http://icl.com/saxon" lang="xml"> |
− | + | ||
− | + | <!--<Option key="loggername" value="level" />--> | |
− | < | + | <Option key="ibbt.sumo" value="FINEST"/> |
− | <Option key=" | + | <!--<Option key="loggername" value="level" />--> |
− | + | <Option key="Matlab" value="FINEST"/></source> | |
− | <Option key | ||
− | |||
− | < | ||
− | <Option key=" | ||
− | |||
− | |||
− | <Option key="Matlab | ||
− | </source> |
Latest revision as of 17:43, 31 January 2012
By default, the SUMO Toolbox displays messages about the progress the modeling process to the Matlab console and also writes them to a log file which can be found in the output folder. A general log file is also generated and saved in the output folder in the SUMO Root directory. The logging configuration lets you control the granularity of the messages and the source of the messages. The possible granularity levels are "OFF, SEVERE, WARNING, INFO, FINE, FINER, FINEST, ALL".
The ConsoleHandler configuration lets you control the granularity of the console messages and the FileHandler lets you control the granularity of the messages written to the log file. You can also control the granularity of the messages generated by the Matlab code in the toolbox and that of the messages generated by the Java code in the Toolbox.
Generated for SUMO toolbox version 7.0. We are well aware that documentation is not always complete and possibly even out of date in some cases. We try to document everything as best we can but much is limited by available time and manpower. We are an university research group after all. The most up to date documentation can always be found (if not here) in the default.xml configuration file and, of course, in the source files. If something is unclear please dont hesitate to ask.
Logging
RootLogger
Root logger
<!--Root logger-->
<[[Config:RootLogger|RootLogger]]>
<!-- log all run-specific information in the main log as well -->
<Option key="runsInMainLog" value="true"/>
<!-- Set the default logging level for the root logger -->
<Option key="Level" value="INFO"/>
<!-- Specify the handlers to create in the root logger
(all loggers are children of the root logger). The handlers determine
where logging output is sent to.
Possible levels are: OFF, SEVERE, WARNING, INFO, FINE, FINER, FINEST, ALL
-->
<[[Config:Handlers|Handlers]]>
<!-- Configure ConsoleHandler (= output to the screen) -->
<[[Config:ConsoleHandler|ConsoleHandler]]>
<Option key="Level" value="INFO"/>
</[[Config:ConsoleHandler|ConsoleHandler]]>
<!-- Configure FileHandler (= output to file)-->
<[[Config:FileHandler|FileHandler]]>
<Option key="Level" value="ALL"/>
</[[Config:FileHandler|FileHandler]]>
</[[Config:Handlers|Handlers]]>
</[[Config:RootLogger|RootLogger]]>
Custom Options
Available options:
<!--<Option key="loggername" value="level" />-->
<Option key="ibbt.sumo" value="FINEST"/>
<!--<Option key="loggername" value="level" />-->
<Option key="Matlab" value="FINEST"/>