记录

Qlik NPrinting 具有详细的日志文件，其可让日志分析者查看通过不同的服务记录的事件。例如，可追随传播到不同任务中的请求并结合来创建响应。

如果您需要进行故障排除，可以从检查日志文件中有错误的行开始。您通常会找到有用的错误信息，帮助您了解问题的根源。您应在自己的支持请求中附上日志文件。

概览

日志文件保存在 %ProgramData%\NPrinting\Logs 中。它们分为三个系列：

• nprinting_scheduler.log（包含 Qlik NPrinting 调度服务 的日志）
• nprinting_webengine.log
• nprinting_engine.log

如果文件变得过大而不易管理，Qlik NPrinting 会创建新文件，并向旧文件添加渐进整数后缀。因此没有后缀的文件为当前文件，而有后缀的文件为较旧文件。后缀越大表示文件越旧。例如：

• \NPrinting\Logs（最新的文件）
• \NPrinting\Logs.1
• \NPrinting\Logs.2（最旧的文件）

这些文件不会每日轮换。您必须手动删除旧文件以节省磁盘空间。所保留的文件数目取决于以下配置文件中的设置：

• C:\Program files\NPrintingServer\NPrinting\Engine\Qlik.NPrinting.Engine.config（引擎服务）
• C:\Program files\NPrintingServer\NPrinting\Scheduler\Qlik.NPrinting.Scheduler.config（调度程序服务）
• C:\Program files\NPrintingServer\NPrinting\Webengine\Qlik.NPrinting.Webengine.config（WebEngine 服务）

您可通过编辑这些字符串更改这些设置：

例如：如果在 Qlik.NPrinting.Engine.config 中将 maxSizeRollBackups 的值更改为 10，Qlik NPrinting 将保留 11 个文件（当前文件 + 10 个存档的文件）。如果您将 maximumFileSize 的值更改为 20MB，在触发新文件的创建之前，日志文件将达到其默认最大大小的两倍。

请注意存在两个部分：一个用于普通日志文件，一个用于 _dev 文件（当启用了调试级别时）。您必须自定义适当的部分，或同时定义两个部分。

日志文件结构

所有日志文件具有以下字段：

• 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

日志文件为制表符分隔值文件，因此可以表格的形式导入。

更改日志详细信息级别

日志级别默认设置为 INFO。您可将日志级别更改为 Windows 服务的 DEBUG。

进行以下操作：

1. 使用文本编辑器打开相应的配置文件:
   • 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

   其中 C:\Program Files\NPrintingServer 是 Qlik NPrinting Server 安装路径。如果必要，可根据您的安装对其进行修改。

   如果您希望查看 Qlik NPrinting On-Demand 日志，则需要将 Qlik.NPrinting.Engine.exe.config 设置为 DEBUG。

2. 搜索：

   <root>

   <level value="INFO" />

   <appender-ref ref="LogFileAppender" />

   <!--Uncomment the row below and set the level value above to obtain the logs in the file nprinting_engine_dev.log-->

   <!--<appender-ref ref="LogFileAppenderDev" />-->

   <appender-ref ref="LogFileAppender" />

   </root>

3. 将 level value 更改为 "DEBUG"：

   <root>

   <level value="DEBUG" />

   <appender-ref ref="LogFileAppender" />

   <!--Uncomment the row below and set the level value above to obtain the logs in the file nprinting_engine_dev.log-->

   <!--<appender-ref ref="LogFileAppenderDev" />-->

   <appender-ref ref="LogFileAppender" />

   </root>

4. 取消注释：<!--<appender-ref ref="LogFileAppenderDev" />-->

5. 保存编辑后的文件。
6. 重启相应的 Windows 服务。

当您将日志层级更改为 DEBUG 时，会创建新的日志文件。新的日志文件与 INFO 详细信息级别的日志文件具有相同名称，后接 _dev。例如：

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

默认日志文件仍会显示，仅将继续具备 INFO 级别信息。