Running the Log Viewer Utility

Diagnosing and Resolving Issues in Oracle Business Intelligence 8-17 Writer implementation The following implementations are defined: ■ FileLogWriter. Writes to a disk file. ■ CoutWriter. Writes to standard output. ■ EventLogWriter. Writes to a Windows event log or UNIX syslog. ■ CrashWriter. A Windows only facility that writes to a crash dump file when Presentation Services attempts to log from a specific source file and line number. Used in a production environment for information of some loggable but irrecoverable error for example, failed NQTEST. Note: Use this implementation with care as it might leave the server in an unstable state. Use this implementation in very rare diagnostic-only scenarios on a test system. On Windows, CrashWriter requires the appropriate version of dbghelp.dll at least 6.0.17.0. The correct dbghelp.dll can be found in supportwindowssystem32. Put this DLL in the WINNTsystem32 or in the mainbin directory. No registration is required. Writer name Unique name for the writer. Writer writerClassId Specifies an integer number in the range 1 through 10. This number is used by filters to allow or prohibit logging. Each distinct writer must have a unique value, which is used later for filter configuration. Different writers might have the same class ID, but if they do, those writers cannot be distinguished by filters. Writer fmtName Optional Specifies the format of logged messages. Valid values are: ■ default - 10g style . Formats messages with identifying headings. ■ ODL-TEXT . Formats messages in Oracle Diagnostic Text format. ■ ODL-XML . Formats messages in Oracle Diagnostic XML format. If you do not set this attribute, then logged messages are displayed in the default format which for file log writers is 10g style and for console is ODL-TEXT. See Section 8.5.3, Examples of the Formats of Logged Messages for examples. Writer FileLogWriter specific attribute dir Specifies the directory where log files are created. Table 8–3 Cont. Oracle BI Presentation Services Log Configuration File Elements Element Attribute Description 8-18 System Administrators Guide for Oracle Business Intelligence Enterprise Edition Writer FileLogWriter specific attribute ODLLogFilePath Specifies the file that Fusion Middleware Control displays in the Log Viewer. Writer FileLogWriter specific attribute maxFileSizeKb Specifies the maximum size of the logging file in kilobytes. When the file size limit is reached, the file is closed and a new logging file is created. Writer FileLogWriter specific attribute filePrefix Specifies the prefix for log files. Writer FileLogWriter specific attribute filesN Specifies the maximum number of logging files. When this number is exceeded, the first file is deleted and re-created again. Then the logger starts to write to the beginning of the first file. Writer EventLogWriter specific attribute winSource Specifies the event log source for logged events. Writer CrashWriter specific attribute file Specifies the dump file path. On Windows, a dump file is created in bincoredumps and Presentation Services continues to run. Writer CrashWriter specific attribute line Dump file line number. WriterClassGroups None Contains the definition for writer classes. A writer class is a group of writer class IDs. WriterClassGroup Contains [as child text] a comma-delimited list of class IDs. name Specifies the name of the WriterClassGroup. Filters None Contains filter configuration. FilterRecord writerClassGroup Specifies the group of writers to which this record is applied. WriterClassGroup should be defined previously in the WriterClassGroups section. FilterRecord disableCentralContro l Optional Determines that this entry is not updated by Fusion Middleware Control. Default value is true. FilterRecord path Specifies the log source path. To enable the logging of SOAP information, enter the following value: saw.httpserver.request.soaprequest The current filter record is applied to the software component that is identified by that path and all its subcomponents. FilterRecord information Contains an integer that specifies the severity of the corresponding message type. Only messages with a severity index less than the provided number are logged. Table 8–3 Cont. Oracle BI Presentation Services Log Configuration File Elements Element Attribute Description