Config:Logging

From SUMOwiki
Revision as of 15:48, 31 January 2012 by Mnguyen (talk | contribs)
Jump to navigationJump to search

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. 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"/>