Contents

Title and Copyright Information

Preface

• Documentation Accessibility
• Conventions

1 Introduction and Roadmap

• Document Scope and Audience
• Guide to This Document
• Related Documentation
• Logging Samples and Tutorials
  • Avitek Medical Records Application (MedRec) and Tutorials
  • Log4j Integration in MedRec
  • Logging Examples in the WebLogic Server Distribution
• New and Changed Logging Features in This Release

2 Understanding WebLogic Logging Services

• What You Can Do With WebLogic Logging Services
• How WebLogic Logging Services Work
  • Components and Environment
  • Terminology
  • Overview of the Logging Process
  • Best Practices: Integrating Java Logging or Log4j with WebLogic Logging Services
  • Server Log Files and Domain Log Files
  • How a Server Instance Forwards Messages to the Domain Log
• Server and Subsystem Logs
  • Server Log
  • Subsystem Logs
• Log Message Format
  • Format of Output to Standard Out and Standard Error
• Message Attributes
• Message Severity
• Viewing WebLogic Server Logs
• Server Logging Bridge
  • Java Logging
  • Log4J Logging
  • Propagating Log Messages to the Root Logger
  • Best Practice: Use Generic Overrides to Insert Logging Properties File

3 Configuring WebLogic Logging Services

• Configuration Scenarios
• Overview of Logging Services Configuration
  • Using Log Severity Levels
  • Using Log Filters
• Logging Configuration Tasks: Main Steps
• Log4j and the Commons Logging API
  • About Log4j
    • Loggers
    • Appenders
    • Layouts
• How to Use Log4j with WebLogic Logging Services
  • Using WLST to Configure and Enable Log4j for WebLogic Server Logging
• How to Use the Commons API with WebLogic Logging Services
  • Specifying Severity Level for Loggers
    • Specifying Severity Level for WebLogic Server Subsystem Loggers
    • Specifying the Severity Level for Commons Logging API Loggers
• Rotating Log Files
  • Specifying the Location of Archived Log Files
  • Notification of Rotation
• Redirecting JVM Output

4 Filtering WebLogic Server Log Messages

• The Role of Logger and Handler Objects
• Filtering Messages by Severity Level or Other Criteria
• Setting the Severity Level for Loggers and Handlers
  • Setting the Level for Loggers
  • Setting the Level for Handlers
• Setting a Filter for Loggers and Handlers
  • Filtering Domain Log Messages
• Setting a Severity Level and Filter on a Log4j Appender

5 Subscribing to Messages

• Overview of Message Handlers
• Creating and Subscribing a Handler: Main Steps
• Example: Subscribing to Messages in a Server JVM
  • Example: Implementing a Handler Class
  • Example: Subscribing to a Logger Class
• Example: Implementing a Log4j Appender Class
• Comparison of Java Logging Handlers with JMX Listeners