2 Application Logging and WebLogic Logging Services

You can use WebLogic logging services for your application logging. You can keep a record of which user invokes specific application components, to report error conditions, or to help debug your application before releasing it to a production environment.

About WebLogic Logging Services

WebLogic logging services provide information about server and application events. Your application can also use WebLogic logging services to communicate its status and respond to specific events. See Understanding WebLogic Logging Services in Configuring Log Files and Filtering Log Messages for Oracle WebLogic Server.

Two features of WebLogic logging services from which your application can benefit are its extensibility and support for internationalization.

You can create your own catalog of log messages and use WebLogic utilities to generate Java classes that you can use in your application code. The log messages generated from your applications will be integrated with and treated in the same way as log messages generated by the server. See Writing Messages to the WebLogic Server Log.

Log message catalogs you create can be written in any language and can be accompanied by translations for different locales. WebLogic support for internationalization ensures that the log messages are present in the appropriate language for the current locale under which WebLogic Server is running. See Internationalization and Localization for WebLogic Server.

A major advantage of integrating your application logging with WebLogic logging framework is ease of management. The WebLogic Server Administration Console lets you manage all of the log files and related options. See View and configure logs in Oracle WebLogic Server Administration Console Online Help.

Integrating Application Logging with WebLogic Logging Services: Main Steps

To debug your applications, you must first generate the log messages from your applications and integrate them with WebLogic logging services. There are several ways to do this operation:
  • Use WebLogic tools to build custom log message catalogs and their associated Java APIs. Applications can invoke the log methods exposed by these interfaces to generate log messages. The message catalogs can be easily internationalized. See Using Message Catalogs with WebLogic Server.

  • Use the WebLogic non-catalog logger to generate log messages. With NonCatalogLogger, instead of calling messages from a catalog, you place the message text directly in your application code. See Using the NonCatalogLogger APIs.

  • Use a log() method available to servlets and JSPs in javax.servlet.ServletContext. See Using ServletContext.

Application developers who do not use WebLogic message catalogs, NonCatalogLogger, or servlet logging can do the following:

  • Use the Java Logging APIs to produce and distribute messages.

  • Use Log4J to produce messages and configure the server to use Log4j or the default, Java Logging, to distribute messages.

  • Use the Commons API to produce messages.

    See org.apache.commons.logging at http://jakarta.apache.org/commons/logging/api/index.html.

  • Use the Server Logging Bridge handler (for Java Logging), or appender (for Log4j), which redirects application log messages to WebLogic logging services.

Note:

The use of Log4j with the WebLogic logging service, as an alternative to Java logging, is deprecated as of WebLogic Server 12.1.3.

Accessing the WebLogic Server Logger

The WebLogic logging infrastructure supports a logger on each server that collects the log events generated by your own applications and subsystems. WebLogic Server provides direct access to the logger on each server, as well as to the domain logger on the Administration Server.

By default, WebLogic logging services use an implementation based on the Java Logging APIs. The LoggingHelper class provides access to the java.util.logging.Logger object used for server logging. See the LoggingHelper Javadoc.

Alternatively, you can direct WebLogic logging services to use Log4j instead of Java Logging. When Log4j is enabled, you get a reference to the org.apache.log4j.Logger that the server is using from the weblogic.logging.log4j.Log4jLoggingHelper class. With a Log4j Logger reference, you can attach you own custom appender (handler) to receive the log events or you can use the Logger reference to issue log requests to WebLogic logging services. See the Log4jLoggingHelper Javadoc.

Note:

The use of Log4j with the WebLogic logging service, as an alternative to Java logging, is deprecated as of WebLogic Server 12.1.3.

In addition, WebLogic logging services provide an implementation of the Jakarta Commons LogFactory and Log interface, so you can program to the Commons API and direct log messages to the server log file or any of the registered destinations. This API provides you with an abstraction that insulates you from the underlying logging implementation, which could be Log4j or Java Logging.

See Server Logging Bridge in Configuring Log Files and Filtering Log Messages for Oracle WebLogic Server.

For more information, including examples, see the following sections in Configuring Log Files and Filtering Log Messages for Oracle WebLogic Server: