Configuring Java logging with the administrative console

Java™ logging provides a standard logging API for your applications. Before applications can log diagnostic information, you need to specify how you want the server to handle log output and what level of logging you require.

About this task

Developing, deploying and maintaining applications are complex tasks. When an application encounters an unexpected condition, it might not be able to complete a requested operation. You might want the application to inform the administrator that the operation failed and tell the administrator why the operation failed. This information enables the administrator to take the proper corrective action. Application developers might need to gather detailed information that relates to the path of a running application to determine the root cause of a failure that is due to a code bug. The facilities that are used for these purposes are typically referred to as logging and tracing. For more information read Java logging.

Using the administrative console, you can:
  • Enable or disable a particular log, specify where log files are stored and how many log files are kept.
  • Specify the level of detail in a log, and specify a format for log output.
  • Set a log level for each logger.

You can change the log configuration statically or dynamically. Static configuration changes affect applications when you start or restart the application server. Dynamic or run time configuration changes apply immediately.

When a logger is created, the level value for that logger is set from the configuration data. If no configuration data is available for a particular logger name, the level for that logger is obtained from the parent of the logger. If no configuration data exists for the parent logger, the parent of that logger is checked, and so on up the tree, until a logger with a non-null level value is found. When you change the level of a logger, the change is propagated to the children of the logger, which recursively propagates the change to their children, as necessary.

Procedure

  1. [AIX Solaris HP-UX Linux Windows] Set the output properties for a log:
    1. In the navigation pane, click Troubleshooting > Log and trace.
    2. Click the name of the server that you want to work with.
    3. Click the name of a system log to configure.
    4. To make a static change to the system log configuration, click the Configuration tab. To change the configuration dynamically, click the Runtime tab.
    5. Change the properties for the selected log according to your needs.
    6. Click Apply.
    7. Click OK.
  2. Set the logging levels for your logs:
    1. In the navigation pane, click Servers > Server Types > WebSphere application servers.
    2. Click the name of the server that you want to work with.
    3. Under Troubleshooting, click Logs and Trace.
    4. Click Change Log Detail levels.
    5. To make a static change to the configuration, click the Configuration tab. A list of well-known components, packages, and groups is displayed. To change the configuration dynamically, click the Runtime tab. The list of components, packages, and groups displays all the components that are currently registered on the running server.
    6. Select a component, package, or group to set a logging level.
    7. [High Performance Extensible Logging] Select whether or not you want to disable the logging and tracing of potentially sensitive data.
    8. Click Apply.
    9. Click OK.
  3. To have static configuration changes take effect, stop then restart the application server.