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 toksl.log
with default level DEBUG.DatabaseIfc
captures database interaction, written tokslDbLog.log
with default level INFO.ExcelUtil
captures Excel file interactions, written tokslExcelLog.log
with default level INFO.KSLFileUtil
captures file interactions, written toksl_io.log
with default level INFO.Model
captures key model actions as the model is processed, written tokslSim.log
with default level of INFO.ModelElement
captures detailed actions related to model element processing, written tokslModelElement.log
with default level INFO.ProcessModel
captures detailed actions related to entity processing, written tokslEntity.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 tokslStreams.log
with default level INFO.Controls
captures simulation control assignment, written tocontrolsFile.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.