Skip Headers
Oracle® Fusion Middleware Configuration Guide for Oracle Business Intelligence Discoverer
11g Release 1 (11.1.1)

Part Number B40107-08
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

11 Diagnostics and Logging Facilities in Discoverer

This chapter describes the server diagnostic and logging facilities that are available in Discoverer, and contains the following topics:

11.1 What Discoverer diagnostics and logging capabilities are available?

Discoverer provides the following diagnostics capabilities to help you trace and diagnose problems. For example, if performance is slow, you might want to check whether the Discoverer middle tier components are configured correctly.

Notes

11.2 What is the checkdiscoverer utility?

The checkdiscoverer utility is a script that checks the configuration of the Discoverer middle tier and middle-tier components, and reports any failures or anomalies.

For more information about the checkdiscoverer utility, see Section A.1, "Discoverer file locations".

Note: Discoverer Plus OLAP has its own diagnostics utility. For more information, see Section 5.6, "Configuration diagnostic utility for Discoverer Plus OLAP").

11.3 How to view Discoverer log files using Fusion Middleware Control

The Enterprise Manager Fusion Middleware Control enables you to search for and view log files for Oracle Fusion Middleware applications. For example, you might want to examine a list of all Discoverer sessions running on a particular Discoverer middle-tier machine.

To view log files by using Fusion Middleware Control:

  1. Start Enterprise Manager Fusion Middleware Control.

    For more information, see Section 4.1.2, "How to start Fusion Middleware Control and display the Farm Home page."

  2. Navigate to the Discoverer home page.

    For more information, see Section 4.1.3, "How to display the Fusion Middleware Control Discoverer Home page and Discoverer component Home pages."

  3. From the Discoverer menu, select Monitoring, and then select Logs.

    The Log Messages page is displayed.

  4. (optional) To search for a specific log file, enter the search criteria and click Search.

  5. To view a list of the log files, click the Log Files... button.

    The Log Files page is displayed.

  6. Select the row corresponding to the log file that you want to view, and click View Log File.

    The View Log File page is displayed. It shows the entries in the selected log file.

  7. To view details of specific log entries, select the entries.

    The details of the selected log entry are displayed below the list of entries.

For more information, see Enterprise Manager Fusion Middleware Control Help.

11.4 How to set the log level for Discoverer component loggers

Oracle Fusion Middleware provides the following loggers for Discoverer components:

For each of these loggers, you can configure the Oracle Diagnostic Logging (ODL) level. You set the log level for individual Discoverer components when you want to monitor Discoverer component session activity at a specific level of detail.

To configure the log level for Discoverer component log files:

  1. Start Fusion Middleware Control. For more information, see Section 4.1.2, "How to start Fusion Middleware Control and display the Farm Home page."

  2. Navigate to the Fusion Middleware Control Discoverer home page. For more information, see Section 4.1.3, "How to display the Fusion Middleware Control Discoverer Home page and Discoverer component Home pages."

  3. From the Discoverer menu, select Logs, and then select Log Configuration.

    The Log Configuration page is displayed.

  4. From the View list, select Runtime Loggers.

  5. Select a logging level for each Discoverer component from the Oracle Diagnostic Logging Level (Java Level) list.

  6. Click Apply.

    You can now monitor the Discoverer session log file at the level of detail that you specified. For more information, see Section 11.3, "How to view Discoverer log files using Fusion Middleware Control."

    For more information, see "Managing Log Files and Diagnostic Data" in the Oracle Fusion Middleware Administration Guide.

11.5 How to copy Discoverer log files

You might want to copy all Discoverer logs into a single location (for example, to provide a snap shot of a Discoverer middle-tier machine, or to provide an archive of Discoverer log files).

You use the collectlogs utility to copy Discoverer logs into a single location.

To copy Discoverer log files to a single location, run the following command on the Discoverer middle-tier machine.

collectlogs <logs_target_location>

The target location is either a TAR filename (UNIX) or a folder name (Windows).

The Discoverer log files are copied to the specified location.

For more information about the collectlogs utility, see Section A.1, "Discoverer file locations."

Note:

The collectlogs script collects the following information:

  • Middle-tier Discoverer logs

  • application.log file

  • .reg_key.dc file

  • env information

  • Discoverer server files (that is, all files in <ORACLE_HOME>/discoverer/bin and <ORACLE_HOME>/discoverer/lib)

  • UNIX-specific system parameters (for example, /etc.hosts, ifconfig output, showrev -p output, uname -a output, and ulimit -a output)