Logging

Qlik NPrinting has a complete set of detailed log files created with the same standard of Qlik Sense. This will allow log analysts to understand events logged by different services. For example it is possible to follow a request spread into different tasks and rejoined back to create a response.

Log files are saved in %ProgramData%\NPrinting\Logs, and are divided into three families:

• nprinting_scheduler.log contains the log of Qlik NPrinting Scheduler
• nprinting_webengine.log
• nprinting_engine.log

When a file becomes too big to be easily managed, Qlik NPrinting creates a new file and adds a progressive integer suffix to the old file. So the file without suffix is the current file, and the files with suffixes are the previous files. Bigger suffix indicates older files. The files are not rotated on a daily basis; you have to manually delete old files to save disk space.

When you need to troubleshoot a problem, start by checking rows with errors in the log files. You will usually find useful error messages to help you understand the origin of the issue. Include the log files in your support requests.

Log files structure

All log files have the same, columnar, structure composed by the following fields:

• Product Assembly Name
• Product Version
• Class Name
• Timestamp
• Severity
• Hostname
• User name
• User ID
• WebEngine Request ID
• Connection ID
• Task ID
• Execution ID
• Report ID
• Request ID
• Transformation ID
• Message
• Exception
• Stacktrace

Log files are tab-separated values files, so they can be imported as tables to be analyzed.

Changing log details level

The log level is set to INFO by default. To change the log level to DEBUG of a Windows service, do the following:

1. Open the appropriate configuration file with a text editor:
   • C:\Program Files\NPrintingServer\NPrinting\Engine\Qlik.NPrinting.Engine.exe.config
   • C:\Program Files\NPrintingServer\NPrinting\Scheduler\Qlik.NPrinting.Scheduler.exe.config
   • C:\Program Files\NPrintingServer\NPrinting\WebEngine\Qlik.NPrinting.WebEngine.exe.config

   Where C:\Program Files\NPrintingServer is the Qlik NPrinting Server installation path. Adapt it to your installation if necessary.

2. Search for the string <appender name="LogFileAppender".
3. Remove the previous line, that is an html open comment tag <!--.
4. Remove the also related html comment close tag --> that is after the string </appender>.
5. Search for the string <appender-ref ref="LogFileAppender" />.
6. Remove previous line that is an html open comment tag <!--.
7. Remove the also related html comment close tag -->.
8. Save the edited file.
9. Restart the corresponding Windows service.

These settings will create a new log file for each service that you applied them to. The new log file has the same name of the log file with INFO details level followed by _dev. So they will be:

• nprinting_scheduler_dev.log
• nprinting_webengine_dev.log
• nprinting_engine_dev.log

The default log files will still be present and will continue to have only INFO level information.