bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Administration Console Online Help

Domain Log Filters

WebLogic Servers transmit log messages (or notifications) to the Administration Server by means of Java Management Extension (JMX) facilities. A subset of messages generated by all running WebLogic servers is stored in a central domain log maintained by the Administration Server. (The full set of these messages is also stored in local log files.)

By default, the Administration Server writes only the most important log messages (as determined by Message Severity) to the domain log. To change the default, you must create a domain log filter.

If you want to modify the filter to write a different subset of messages from a local server, you can do so dynamically using the Administration Console. You do not need to restart the local server for your changes to take effect.

For more information about domain log filters, refer to the following tasks:

- Viewing the Domain Log

- Specifying Criteria for Rotating Domain Log Files

Tasks

Creating a New Domain Log Filter

1. Click the Domain Log Filters node in the left pane. The Domain Log Filters table displays in the right pane showing all the log filters in the domain.

2. Click the Create a New Domain Log Filter text link. A dialog displays in the right pane showing the tabs associated with configuring a new domain log filter.

3. Enter a value in the Name attribute field.

4. Select a severity level from the Severity Level drop-down list. Only messages of the severity or higher will be forwarded to the domain log. You cannot forward DEBUG messages to the domain log. For information about message severity, refer to Message Severity in the WebLogic Server Administration Guide.

5. Enter the User IDs associated with this log filter, if any. If no User IDs are chosen, then the filter sends messages that were generated by all users.

6. Select the Subsystems for which you want messages forwarded to the domain log. If no subsystems are chosen, then the filter sends messages from all subsystems.

7. Click Create to create a domain log filter instance with the name you specified in the Name field. The new instance is added under the Domain Log Filters node in the left pane.

To use this filter on a server, you must assign it as described in Assigning a Domain Log Filter to One or More Servers.

Cloning a Domain Log Filter

1. Click the Domain Log Filters node in the left pane. The Domain Log Filters table displays in the right pane showing all the log filters in the domain.

2. Click the Clone icon in the row of the domain log filter you want to clone. A dialog displays in the right pane showing the tabs associated with cloning a domain log filter.

3. Change the attribute values for the new domain log filter as necessary, using the instructions in Creating a New Domain Log Filter.

4. Click Clone to save your changes.

To use this filter on a server, you must assign it as described in Assigning a Domain Log Filter to One or More Servers.

Deleting a Domain Log Filter

1. Click the Domain Log Filters node in the left pane. The Domain Log Filters table displays in the right pane showing all the log filters in the domain.

2. Click the Delete icon in the row of the domain log filter you want to delete. A dialog displays in the right pane asking you to confirm your deletion request.

3. Click Yes to delete the domain log filter.

Assigning a Domain Log Filter to One or More Servers

1. Expand the Domain Log Filters node in the left pane. A list of domain log filters appears under the Domain Log Filters node.

2. Select a domain log filter in the left pane.

3. Select the Targets tab.

4. On the Servers tab, select servers from the Available list.

5. Click the right arrow. The selected servers appear under Chosen.

6. Click Apply.

The chosen servers now use this filter. Although you can assign a filter to multiple servers, a server can use only one filter at a time.

Note that clicking Apply sets the value of the Server—>myServer—>Logging—>Domain—>Domain Log Filter list for each server that you placed in the Chosen list. For more information about a server's Domain Log Filter list, refer to Specifying Domain Logging.