How to Use and Configure the JavaPOS Logging Feature

🧾 Description 

This article explains how to use and modify the logging feature in the JavaPOS installation

🛠️  Resolution Steps 

JavaPOS Log File Locations

Custom Logging Configuration

If the log files cannot be found using the default location and naming convention for the specified version, the logging configuration file will need to be checked for exact location and name:

1. Open the logging configuration file: <JavaPOS install location>/SupportJars/log4j2.xml (see default install locations)

2. Determine the log location and name from the following line:
   <RollingFile name=“RollingFile” filename=“<log_location>/<log_name>.log”

Default Logging Configuration

JavaPOS versions previous - 1.14.011

• Name: jpostrace.log

• Location: /tmp/

JavaPOS versions 1.14.012 - present

• Name: jposTraceR.log (multiple files also introduced: jposTraceR-[n].log where [n] represents a number between 1-5)

• Location

  • Windows: %temp% (type into a Windows Explorer address bar or run utility generated by Win + R shortcut)

  • Linux: /tmp/

Change Logging Level

This page contains information related to changing the logging level configuration, which controls the amount of detail generated in the log files.

* Only available for JavaPOS versions 1.14.012 - present

Instructions

1. Open the configuration file for editing: <JavaPOS install location>/SupportJars/log4j2.xml (see default install locations)

2. Replace the current level in the following line with one options in the section below:
   <Root level=“<current_level>”>

3. Save file and restart application

Logging Levels

Available logging levels are listed below (ordered from greatest to least amount of detail):

1. trace

2. debug (default value)

3. info

4. warn

5. error