D.2 Logging Options

Logging is controlled by a logback XML file for configuring the loggers. The logback.xml file can be found in the resources folder within the source code repository. The more interesting classes that have default loggers written to the logs directory include:

  • KSL useful for general purpose logging and written to ksl.log with default level DEBUG.
  • DatabaseIfc captures database interaction, written to kslDbLog.log with default level INFO.
  • ExcelUtil captures Excel file interactions, written to kslExcelLog.log with default level INFO.
  • KSLFileUtil captures file interactions, written to ksl_io.log with default level INFO.
  • Model captures key model actions as the model is processed, written to kslSim.log with default level of INFO.
  • ModelElement captures detailed actions related to model element processing, written to kslModelElement.log with default level INFO.
  • ProcessModel captures detailed actions related to entity processing, written to kslEntity.log with default level INFO. Very detailed entity tracing can be achieved by setting the log level to TRACE.
  • RNStreamProvider captures random number stream assignments, written to kslStreams.log with default level INFO.
  • Controls captures simulation control assignment, written to controlsFile.log with default level INFO.

For diagnosing issues related to these classes, you can change the debug level within the logback.xml file. Be careful with setting the ProcessModel logger to trace because the generated files will be large and the execution time of the model will be longer because of the extra IO.