日志记录子系统
日志记录子系统用于管理各种日志，如应用程序、脚本和通信。
配置
|
日志保留设置
|
数据类型
|
默认
|
注解
|
||
|---|---|---|---|---|---|
|
文件大小上限 (KB)
|
INTEGER
|
100000
|
当文件大小达到或超过定义的大小时，下一个日志事件会触发文件滚动更新，目标文件夹是 ThingworxStorage > logs > archives。
您可以在运行时更改默认设置以立即保存更改。
最大大小为 1000000 KB。
|
||
|
存档最大天数
|
INTEGER
|
7
|
每日累积与时间无关，而取决于是否发生日志事件。每天午夜文件会更新一次 (仅在发生日志事件时) 并移动至 archives 文件夹。
默认情况下，如果日志在归档中超过七天，则会被删除。您可以将默认值更改为 1 或最多 90 天。
|
||
|
启用堆栈追踪
|
BOOLEAN
|
false
|
启用后，当 Java API 中的 com.thingworx.logging.LogUtilities.logInstanceExceptionDetails 服务调用发生错误时，相关的堆栈追踪会记录到 ThingworxStorage > logs 文件夹中的 ErrorLog.log 文件中。有助于在平台上调试错误。
|
||
|
启用脚本堆栈追踪
|
BOOLEAN
|
True
|
如果脚本中出现错误，相关的堆栈追踪会记录到 ThingworxStorage>logs 文件夹中的 ScriptErrorLog.log 文件中。有助于调试平台用户创建的脚本。
|
在 ThingWorx Platform 中，如果出现任何错误且错误持续发生，则会在相应的日志文件中生成和打印日志，例如应用程序、脚本和数据库。此外还可发现，错误持续较长时间会导致日志文件充斥大量类似日志。
为杜绝这种情况，引入了以下配置：
先决条件
将以下筛选器添加至 logback.xml 文件。
<turboFilter class="com.thingworx.logging.RepetitiveLogFilterTest">
</turboFilter>
</turboFilter>
|
重复日志筛选器设置
|
数据类型
|
默认值
|
注解
|
|---|---|---|---|
|
启用日志筛选
|
BOOLEAN
|
false
|
启用或禁用日志筛选。
|
|
缓存大小
|
INTEGER
|
2000
|
每次存储唯一条目时所占用的缓存大小。
|
|
允许重复次数
|
INTEGER
|
10
|
可记录重复日志的次数 (第一次记录不计入重复次数)。
|
|
写入后多久到期
|
INTEGER
|
300
|
可记录重复日志的持续时间 (秒)。
|
|
包括要筛选的包
|
STRING
|
欲包括的要筛选的包列表，以逗号分隔。
|
 |
• 日志筛选仅适用于“包括要筛选的包”下已配置包的错误或警告日志。
• 将“启用日志筛选”的值更改为 true 并将包名称添加至“包括要筛选的包”参数可跟踪重复错误或警告日志。
• 上述任何配置参数更改均会重置缓存条目，并重新启动与已配置包相关的错误或警告日志跟踪。
• 通过“允许重复次数”配置参数跟踪重复的错误或警告日志。仅为已配置值打印错误或警告日志。
• 错误或警告日志打印在超出所配置的重复计数后暂停，直至“写入后多久到期”配置参数中提及的时间结束为止。
• 跳过的计数和重复日志记录计数的详细信息会随 DEBUG 级别的日志一同记录。
• 用户可通过以逗号分隔的列表来配置包。系统将跟踪上述包中的错误或警告日志。
• “重复日志筛选器设置”要求在“包括要筛选的包”中提及完整的包名称。例如，可以是 com.thingworx.system.subsystems.filetransfer，但不能是 com.thingworx.system.subsystems 或 com.thingworx.system。
|
如果将日志级别设置为 DEBUG 或 TRACE，则各个日志的日志量将呈指数增长。LoggingSubsystem 中引入了以下配置，用于在上述间隔后重置日志级别：
|
日志级别自动重置设置
|
数据类型
|
默认值 (秒)
|
注解
|
|---|---|---|---|
|
全局追踪重置间隔 (秒)
|
整数
|
600
|
如果任意日志 (例如 ApplicationLog 和 ScriptLog) 的默认日志级别更改为 TRACE，则所述时间间隔将用作计时器。计时器响起后，日志级别将重置回先前设置的级别。
|
|
全局调试重置间隔 (秒)
|
整数
|
600
|
如果任意日志 (例如 ApplicationLog 和 ScriptLog) 的默认日志级别更改为 DEBUG，则所述时间间隔将用作计时器。计时器响起后，日志级别将重置回先前设置的级别。
|
|
子记录器调试重置间隔 (秒)
|
整数
|
3600
|
如果将任意子记录器包设置为 TRACE 级别，则上述时间间隔将用作计时器。计时器响起后，相应子记录器的日志级别将重置回默认日志级别。
此配置有助于抑制日志量呈指数增长。
|
|
子记录器追踪重置间隔 (秒)
|
整数
|
3600
|
如果将任意子记录器包设置为 DEBUG 级别，则上述时间间隔将用作计时器。计时器响起后，相应子记录器的日志级别将重置回默认日志级别。
此配置有助于抑制日志量呈指数增长。
|
|
|
• 如果重新启动 ThingWorx Platform 服务器或所有节点，则上述全局和子记录器的重置间隔操作也将重新启动。
• 就重置功能而言，所有日志级别均与 TRACE 日志级别具有相同的效果。此级别不具有单独的计时器，且遵循全局和子记录器 TRACE 级别的间隔。
|