When WebLogic Server message catalogs and the NonCatalogLogger generate messages, they distribute their messages to a java.util.logging.Logger object. The Logger object publishes the messages to any message handler that has subscribed to the Logger.

WebLogic Server instantiates Logger and Handler objects in three distinct contexts. See Figure 3-1 for more details:

• In client JVMs that use WebLogic logging services. This client Logger object publishes messages that are sent from client applications running in the client JVM.

  The following handlers subscribe to the Logger object in a client JVM:

  • ConsoleHandler, which prints messages from the client JVM to the client's standard out.

    If you use the -Dweblogic.log.StdoutSeverityLevel Java startup option for the client JVM, WebLogic logging services create a filter for this handler that limits the messages that the handler writes to standard out. See Writing Messages from a Client Application in Adding WebLogic Logging Services to Applications Deployed on Oracle WebLogic Server.

  • FileStreamHandler, which writes messages from the client JVM to the client's log file.

• In each instance of WebLogic Server. This server Logger object publishes messages that are sent from subsystems and applications that run on a server instance.

  The following handlers subscribe to the server Logger object:

  • ConsoleHandler, which makes messages available to the server's standard out.

  • FileStreamHandler, which writes messages to the server log file.

  • An internal handler, which broadcasts messages to the domain log and JMX clients, and publishes messages to the Administration Server.

• The Administration Server maintains a domain Logger object in addition to a server Logger object. The domain Logger object receives messages from each Managed Server's Logger object.

  The following handler subscribes to the domain Logger object:

  • FileStreamHandler, which writes messages to the domain log file.

Figure 3-1 WebLogic Logging Services Contexts

Description of "Figure 3-1 WebLogic Logging Services Contexts"

Trace, Debug, Info, Notice, Warning, Error, Critical, Alert, Emergency

By default, a Logger object publishes messages of all levels. To set the lowest-level message that a Logger object publishes, you use a simple Logger.setLevel API. When a Logger object receives an incoming message, it checks the message level with the level set by the setLevel API. If the message level is below the Logger level, it returns immediately. If the message level is above the Logger level, the Logger allocates a WLLogRecord object to describe the message.

For example, if you set a Logger object level to Warning, the Logger object publishes only Warning, Error, Critical, Alert, or Emergency messages.

To provide more control over the messages that a Logger object publishes, you can also create and set a filter. A filter is a class that compares data in the WLLogRecord object with a set of criteria. The Logger object publishes only the WLLogRecord objects that satisfy the filter criteria. For example, a filter can configure a Logger to publish only messages from the JDBC subsystem. To create a filter, you instantiate a java.util.logging.Filter object and use the Logger.setFilter API to set it for a Logger object.

Instead of (or in addition to) setting the level and a filter for the messages that a Logger object publishes, you can set the level and filters on individual message handlers.

For example, you can specify that a Logger publishes messages that are of the Warning level or higher. Then you can do the following for each handler:

• For the ConsoleHandler, set a level and filter that selects only Alert messages from the JDBC, JMS, and EJB subsystems. This causes standard out to display only Alert messages from the JDBC, JMS, and EJB subsystems.

• For the FileStreamHandler, set no additional level or filter criteria. Because the Logger object has been configured to publish only messages of the Warning level or higher, the log file will contain all messages from all subsystems that are of Warning severity level or higher.

• Publish all messages of Warning severity level or higher to the domain-wide message log on the Administration Server.

To filter the messages by severity level, you can set the severity level for a Handler and Logger object using the WLST commands.

The WLST commands provide a way to set the severity level for a Handler object through standard MBean commands. To set the Severity level for a Logger object, you can use the Logger API. You can also set the Severity level for a Logger via the WLST or the command line; see Specifying Severity Level for Loggers. To configure Logger and Handler severity level for WLS clients (such as EJB and Web Service clients), you must use the Java Logging API.

• Setting the Level for Loggers
  
• Setting the Level for Handlers
  

When you set a filter on the Logger object, the filter specifies which messages the object publishes; therefore, the filter affects all handlers that are registered with the Logger object as well. When you set a filter on Handler, the filter affects only the behavior of the specific handler.

import java.util.logging.Logger;
import java.util.logging.Filter;
import java.util.logging.LogRecord;
import weblogic.logging.WLLogRecord;
import weblogic.logging.WLLevel;
public class MyFilter implements Filter {
    public boolean isLoggable(LogRecord record) {
        if (record instanceof WLLogRecord) {
            WLLogRecord rec = (WLLogRecord)record;
            if (rec.getLoggerName().equals("Deployer")) {
              return false;
            } else {
              return true;
            }
        } else {
          return false;
        }
    }
}

• Filtering Domain Log Messages