Domain Log Filters

WebLogic Server instances 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.

 

---

Tasks

Specifying the Messages that a Server Forwards to the Domain Log

1. In the left pane of the Administration Console, click on the name of the Domain Log Filters folder. (See Figure 7-1.)

   Figure 7-1 Click on the Domain Log Filters Node

   
    

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

2. In the right pane, click the Configure a New Domain Log Filter text link.
3. On the Create a new DomainLogFilter page, in the Name field, enter an alpha-numeric value to identify the filter.
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.

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.
8. To assign the filter to one or more servers, select the Targets tab.
9. On the Servers tab, more one or more servers from the Available list to the Chosen list.
10. Click Apply.

    Figure 7-2 Assign the Domain Log Filter

    
     

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—>Logging—>Domain—>Domain Log Filter list for each server that you placed in the Chosen list.

Cloning a Domain Log Filter

1. In the left pane of the Administration Console, click on the name of the Domain Log Filters folder. (See Figure 7-1.)

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

2. In the Domain Log Filters table, click the Clone icon in the row of the domain log filter you want to clone.
3. On the Clone page, change the attribute values for the new domain log filter as necessary, using the instructions in Specifying the Messages that a Server Forwards to the Domain Log.
4. Click Clone to save your changes.

To use this filter, you must assign it to one or more servers as describe in step 8. in Specifying the Messages that a Server Forwards to the Domain Log.

Deleting a Domain Log Filter

1. In the left pane of the Administration Console, click on the name of the Domain Log Filters folder. (See Figure 7-1.)

   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.
3. Click Yes to delete the domain log filter.