# 记录

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 服务）

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

```

                    <maxSizeRollBackups value="3" />
                    <maximumFileSize value="10MB" />
                
```

例如：如果在 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

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

## 更改日志详细信息级别

警告注释您应当始终备份自己的 Qlik NPrinting 储存库，然后再编辑 .config 文件。有关更多信息，请参阅[备份 Qlik NPrinting](https://help.qlik.com/zh-CN/nprinting/February2025/Content/NPrinting/DeployingQVNprinting/Backing-up-Qlik-NPrinting.htm) （仅提供英文版本）。

日志级别默认设置为 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 级别信息。