1 Application Logging and WebLogic Logging Services
About WebLogic Logging Services
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
-
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 injavax.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: