记录

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

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

概览

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

  • nprinting_scheduler.log(包含 Qlik NPrinting scheduler service 的日志)
  • 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

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

更改日志详细信息级别

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