ModMaster Manual v3.15 - 6. Logging

Download manual: PDF HTML

6. Logging

The Logging page is used to configure the logging of error and information messages.

The messages generated by ModMaster are categorized into levels:

  • Fatal: Messages about errors that are so serious that ModMaster cannot continue running.

  • Error: Messages about errors that may be recoverable, i.e. ModMaster will attempt to continue running.

  • Warn: Messages about potential problems.

  • Info: Messages about the normal operation of ModMaster.

  • Trace: Tracing of Modbus messages.

ModMaster can log messages to two different destinations: Terminal and File. You may log messages to more than one destination, with a different level for each destination.

For each destination, you should select the level of messages to be logged to that destination. When you select a particular level, messages of that level and higher levels will be logged. For example, if you select Warn then messages from the levels Warn, Error and Fatal will be logged. Select None if no messages are to be logged to that destination.

The destinations are:

  • Terminal: This is a window, which can be displayed using the ViewLog menu option.

  • File: This is a text file. You will have to enter the name of the file in the File Name field, or use the Browse button to open a dialog to browse for the file.

    ModMaster will append messages to the file, so output from previous runs of the program will not get lost.

    You may limit the size of the log file by entering a non-zero value in the Maximum file size (MB) field. Enter 0 if you do not want to limit the file size. If the log file grows bigger than the size limit, ModMaster will rename the log file by adding the suffix ".bak", and start a new log file with the specified name.

Messages of level Info and above are also displayed in ModMaster's status bar.