管理 Windchill 日志记录
Windchill 日志消息包含异常追踪和其他可用于排除应用程序行为故障的信息。
可以从安装了 Windchill Directory Server的服务器上使用命令行实用程序来管理 Windchill Directory Server日志文件。有关详细信息,请参阅。
从 Windchill 9.0 开始,Apache log4j 已被用作管理和发布日志消息的主要机制。已对一些旧的日志记录进行了修改以使用 log4j,但是之前存在的大量 Windchill 日志记录功能依然存在,就像在先前的版本中一样,而且仍由 Windchill 特性文件配置设置进行管理。
在 10.0 版本中,其他原有的 Windchill 日志记录功能已迁移到 log4j。
要管理日志记录,应熟悉以下内容:
• 关于 log4j 软件包的常规信息。
访问下面的 URL 可获得关于 log4j 的简介:
• 用于 Windchill 日志记录的 log4j 记录器。
关于出厂设置的 Windchill 记录器的描述以及有关哪个 Java 软件包或类被用作在日志文件中生成条目的接口的其他详细信息,请参阅以下文件:
<Windchill>/codebase/loggers.html
可以使用与记录器关联的 MBean 对所记录内容进行临时更改。有关记录器和 MBean 关联的详细信息,请参阅 logger.html 文件。
• 影响 log4j 日志记录的特性设置。这些特性设置在位于 <Windchill>/codebase/WEB-INF 中的特性文件中:
◦ log4jMethodServer.properties - 控制方法服务器 log4j 日志记录,以及运行于方法服务器上嵌入的 Tomcat servlet 引擎中的 Windchill web 应用程序日志记录。
◦ log4jServerManager.properties - 控制服务器管理器 log4j 日志记录。
此外,如果未指定其他配置文件,<Windchill>/codebase/log4j.properties 文件将用作 log4j 使用的默认配置文件。log4j.properties 文件控制多数 applet、PSE 和多数命令行应用程序的日志记录选项。
要对先前列出的 log4j 特性文件进行更改,必须对其进行编辑而不是使用 xconfmanager 实用程序。如果手动更改了这些文件,请确保备份
管理自定义中所述的文件。
• 如何查看或发送 log4j 日志文件。
有多种方法可用于查看或发送 log4j 日志文件。例如:
◦ 可以使用 LogsDirViewers MBean 节点来查看日志并通过电子邮件发送日志。
◦ 可以使用 > 中提供的“系统配置收集器”收集日志文件。
◦ 可以访问 Log File Viewer 页面以搜索、列出和查看服务器日志文件。此页面的链接可从“系统健康监控工具”页面获取。在“服务器状况”页面上单击“监控工具”链接可以打开此页面。
有关“服务器状况”
页面及其链接的详细信息,请参阅服务器状况。有关“服务器状况”页面的详细信息,可从 > 访问该页面,然后从该页面打开联机帮助。
• 如何使用 xconfmanager 实用程序永久更改旧日志记录和详细级别特性的日志设置。有关使用 xconfmanager 实用程序的信息,请参阅。
• 如何显示或设置日志级别。
有多种方法可用于设置日志级别:
◦ wt.util.jmx.SetLogLevel 命令行实用程序允许您在指定的服务器进程中为指定记录器设置或重置记录器详细级别。如下所示指定该实用程序:
java wt.util.jmx.SetLogLevel [-ms|-sm|-se|-all]* [-resetAll]
[<logger_name> [<log_level>]]
其中 <logger_name> 是记录器的名称,<log_level> 是指定的详细级别。日志级别的有效值包括:ALL、TRACE、DEBUG、INFO、WARN、ERROR、FATAL 和 OFF。
服务器进程可以通过以下内容的任意组合指定:
▪ -sm -- 以集群中的所有服务器管理器为目标。
▪ -ms -- 以群集中的所有方法服务器为目标,包括带/不带嵌入式 servlet 引擎的方法服务器。
▪ -se -- 以集群中的所有 servlet 引擎为目标。
▪ -all -- 以上述所有进程为目标。若未指定任何内容,则假定指定了此项
-resetAll 选项会将目标进程中的所有 log4j 详细级别重置为 log4j 配置文件所指定的级别。如果 -resetAll 和“记录器名称”均已指定,则将在设置指定的记录器详细级别之前执行重置。必须指定 -resetAll 或“记录器名称”。
◦ 单击“系统健康监控工具”页面上的“日志级别”链接会显示一个页面,您可通过该页面显示或设置当前服务器进程的服务器管理器、方法服务器或 servlet 引擎记录器的日志级别。可从 > > 获取“日志级别”链接。在“服务器状况”页面上,单击“监控工具”。
以下各节提供了有关 wt.properties 日志文件设置和日志事件配置设置的其他信息。