How to: Use POS Debug Log

In this article

Setup

Specific setup for Store/Terminal

The debug log

When tracking down problems and bugs in the LS Central POS, it is usually necessary to log the POS Activity to investigate the problem and find its cause. In the past, the Debug Log was written to an external text file. Now it is also possible to log directly to the database using the debugging tool.

Setup

  1. To set up the debug log, click the icon, enter POS Debug Log Setup, and select the relevant link.
  2. In the General FastTab, select the Debug Log Enabled check box.
Field Description
Log Type Select whether you want to log directly into the database or a file.
Log File Insert the location of the log file, if you selected Log Type File (for example C:\pos\Logs) above.
Log Max Days The number of days that the log records are stored in the database. After that the records are automatically purged.
Purge Log At The time when the purge should take place.
Last Purge The time and date when the last records were purged.

Specific setup for Store/Terminal

You can set the debug log up for a specific store or a terminal.

Using a combination of start/end time and date, you can focus on a specific terminal and a specific day and time when the error usually happens without generating too many log records.

The POS Debug Setup Line has the following columns:

Field Description
Log Type Specify the log type that is to be logged, a Store or a Terminal.
Store/Terminal Select a store or terminal name from the drop-down list. Can be blank.
Log Level
  • Trace is most specific and creates lots of records. But might be best to track errors.
  • Debug creates fewer records, but often enough to see what is happening.
  • Warning is not widely used (shows if controls or menus are missing, and so on).
  • Error only logs errors. Very few records would be created. Can be used for extended periods of time.
Log Events
  • Logs all events from the POS (button presses, device inputs, and so on).
  • Is the default setting, and the check box should be selected when you are tracking problems.
Log Dual Display Clear this check box to only log the POS.
Start Time The time of day to start logging.
End Time The time of day to stop logging.
Start Date Specify the day to start logging.
End Date Specify the day to stop logging.

The debug log

You can view and download the debug log from the database in the POS Debug Log page in LS Central. The actions at the top of the page let you refresh, count, and purge the currently selected log. Notice the Download Log action for downloading.

The debug log contains: Terminal - POS/Dual Display – Time – Type – Message.