› › ›
 

Collecting program log

MiaRec supports writing detailed trace information into text file. Such trace information may be useful during problem investigation.

Configuration of trace is location inside MiaRec.ini file:

[Trace]

Enable = 1

Level = 5

File = C:\Program Files\MiaRec Business\Data\log\trace\trace.log

OverwriteIfExists = 0

TraceBlock=0
TraceDataTime=1
TraceTimestamp=0
TraceThreads=1
TraceThreadAddresss=0
TraceLevel=1
TraceFileAndLineNo=1

Rotate=daily
RotateTime=4:00

Where:

  • Enable is a flag for enabling of trace. 0 - trace is disabled (default), 1 - trace is enabled.
  • File specifies a location of trace file.
  • Level specifies a depth of trace information (from 0 to 10). 0 - write only critical trace information, 10 - write all information. Default is 5.
  • OverwriteIfExists specifies if the file should be overwritten when application is restarted. 1 - overwrite, 0 - append new trace information to existing file.
  • TraceBlock, TraceDataTime, TraceTimestamp, TraceThreads, TraceThreadAddress, TraceLevel and TraceFileAndLineNo specify which information is written to file. Possible values: 1 - write that info, 0 - skip that info.
  • Rotate specifies how trace file is rotated (new file is created on periodic basis). Possible values: hourly - rotate once per hour, daily - once per day, weekly - once per week, monthly - once per month. An exact rotation moment is determined by a combination of RotateDay and RotateTime options. During rotation, an existing file is renamed to CURRENT_FILENAME.YYYYMMDD-HHMMSS.EXT, where YYYYMMDD-HHMMSS is replaced with the date/time of rotation.
  • RotateDay specifies a day of rotation.
    • For weekly rotation this option sets a day of week for rotation. It can be one of:
      • Mon, Tue, Wed, Thu, Fri, Sat, Sun
      • Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday
      • 1, 2, 3, 4, 5, 6, 0
    • For monthly rotation this option is a day of month (from 1 to 31).
  • RotateTime specifies a time of rotation.
    • For daily, weekly and monthly rotation this is a time of day, when the rotation is performed, for example at 4:00.
    • For hourly rotation it is a minute of hour for rotation, for example, 59 means to rotate at 0:59, 1:59, ...