Using MBeans to Work with Log Files
Logging functions are handled within JMX through the Logging MBean. By accessing the Logging MBean, you can perform a number of operations, including:
• Set the log level for a specific logger.
• Register the loggers.
• View the configuration file for logging.
The Windchill system generates several system log files and any user-customized log files defined in Windchill. The Windchill system log files are enabled when the wt.logs.enabled variable in the wt.properties file is set to true. Additionally, there is a log file variable associated with each system log file. The individual log files are generated when the log-specific variable and the wt.logs.enabled variable are set to true.
|
Logging changes made using JMX are immediate, but are not saved as part of the configuration and will not be applied on the next restart of the Java Virtual Machine (JVM).
|
Making logging changes through the Logging MBean works well when making temporary changes for troubleshooting; however, it does not allow you to make permanent changes. To make a change to the log4j configuration that will be performed on the next restart of the process, you must make the change in the corresponding properties file. For more information, see
Managing Windchill Logging.
The changes will be made within a few minutes. You can execute the reconfigure operation on the Logging MBean to make this change immediately.
From JConsole, complete the following steps to access the Logging MBean:
1. Determine which log files you want access to and selection the appropriate connection.
2. Select com.ptc from the tree.
3. Select the Logging MBean from the tree.
4. Select the Operations node for the Logging MBean to view the available actions that can be performed.
From the Operations node, you can execute a number of operations related to logging. Click registerLoggers to create an MBean that will represent each log4j logger and will register it within a Logger folder underneath the Logging MBean in the MBean tree. By default all loggers are registered in a single list by their full names.
To get a hierarchical display of the loggers, change the Logging MBean HierarchicalLoggerDisplay attribute value to true. This attribute is located on the Attributes node for the Logging MBean.
To manage the out-of-box summary lines that are added to the method server log, use the wt.summary.general MBean, which is described in the section Summaries in
Windchill MBeans.