24.2 Logging Enhancements

Oracle Reports 11g Release 1 (11.1.1) provides Logging enhancements in the following areas:

  • Security

  • Job Administration

  • Upgradea

  • High Availability

  • Fonts

Table 24-2 provides a list of enhanced log messages:

Table 24-2 Example enhanced logging messages.

Enhancement Sample Output

Security

Start

SecurityHelper:start

JAZNSecurity

RWJAZNSecurity:jobCommandCheck Authorization check started

ReportsActionHandler

ReportsActionHandler:run Checking job command permission

JAZNSecurity

JAZNSecurity:jobCommandCheck Authorization check passed for job 1

JAZNSecurity

RWJAZNSecurity:authenticate Authenticated User weblogic successfully

Job Administration

ConnectionImpl

ConnectionImpl:runJob Calling findDuplicatedJob for jobid = 1

JobManager

JobManager:findDuplicatedJob Found no duplicated job for job 1

ConnectionImpl

ConnectionImpl:runJob No Duplicate jobs for jobid = 1

Upgrade

Upgrade Framework

reports app is deployed to managed server WLS_REPORTS

Upgrade Framework

ReportsServerComponent component is configured in destination instance

Upgrade.Reports

Creating reports specific upgrade items

Upgrade.Reports

Creating reports specific upgrade items complete.

High Availability

JOC Caching

ReportsCacheHandler: putFile File <fileName> pushed to JOC

Font

For more information on font related log enhancements, see Section 12.2.3, "Font Diagnosis and Tracing"

24.2.1 Diagnosing Engine Crashes

This section discusses recommended settings in logging configuration to diagnose engine crashes.

Sometimes it is difficult to diagnose an engine crash as you do not find all log messages in the log file, especially when the log messages are generated just prior to an engine crash.

Due to performance reasons, the logging framework buffers the logs in memory and then flushes the logs periodically to log files. If an engine crashes suddenly, the logging framework may not get a chance to flush the logs from buffer to the file before the engine process exits. As a result, the logging information which had to be logged before an engine crash may not be available in the log file.

To diagnose an engine crash and to see all the log entries, perform the following steps:

For rwserver

  • Navigate to the Reports Server logging.xml file located at:

    ORACLE_INSTANCE/config/ReportsServerComponent/<server name>/logging.xml( For Standalone Servers)

    $DOMAIN_HOME/config/fmwconfig/servers/WLS_REPORTS/logging.xml ( For In-process Servers)

  • Set the value of autoFlushLevel for engine log handler to TRACE:32.

    For example,

    <log_handler name='rwengine_trace_handler' ....>
   <property name='autoFlushLevel' value='TRACE:32'/>
    ...

For rwrun

  • Navigate to the logging.xml file located at ORACLE_INSTANCE/config/ReportsToolsComponent/ReportsTools/logging.xml

  • Set the value of autoFlushLevel for engine log handler to TRACE : 32.

    For example,

     <log_handler name='runtime_trace_handler' ...>
   <property name='autoFlushLevel' value='TRACE:32'/>
    ...

By default, NOTIFICATION :1 messages are flushed immediately. If you set the value of the autoFlushLevel parameter to TRACE : 32 for any message, the log messages are flushed to the file immediately. As continuous flushing affects performance, it is recommended that you set the autoFlushLevel for diagnostic purposes only.