7 Monitoring Content Server and Inbound Refinery Using Fusion Middleware Control

This chapter describes how to monitor Oracle WebCenter Content Server and Inbound Refinery logs, performance information, and MBean information by using Oracle Enterprise Manager Fusion Middleware Control.

This chapter includes the following topics:

Managing Log Information Using Fusion Middleware Control

You can view log messages and manage the log configuration for the Content Server or InBound Refinery instance using the Fusion Middleware Control interface.

Viewing Log Information Using Fusion Middleware Control

  1. Log in to Fusion Middleware Control.
  2. In the navigation tree, expand the appropriate domain name (for example, Farm_base_domain), then WebCenter, then Content.
    • For the Content Server instance, expand Content Server, then select the Content Server instance name (for example, Oracle WebCenter Content - Content Server (UCM_server1)).

    • For the Inbound Refinery instance, expand Oracle Inbound Refinery, then select the Inbound Refinery instance name (for example, IBR (IBR_server1)).

  3. On the home page for the instance, from the Content Server or IBR menu choose Logs, then View Log Messages.

    The Log Messages page contains information about the contents of all available log files. You can use this page to:

    • Search for log messages logged during the past "n" hours.

    • Search for log messages that were logged between two time intervals.

    • Filter log messages based on message type.

Modifying Log Information Using Fusion Middleware Control

  1. Log in to Fusion Middleware Control.
  2. In the navigation tree, expand the appropriate domain name (for example, Farm_base_domain), then WebCenter, then Content.
    • For the Content Server instance, expand Content Server, then select the Content Server instance name (for example, Oracle WebCenter Content - Content Server (UCM_server1)).

    • For the Inbound Refinery instance, expand Oracle Inbound Refinery, then select the Inbound Refinery instance name (for example, IBR (IBR_server1)).

  3. On the home page for the instance, from the Content Server or IBR menu choose Logs, then Log Configuration.
  4. Use the Log Configuration page to configure basic and advanced log configuration settings for log levels and log files. You can:
    • Change log levels of persistent loggers (loggers defined in the logging configuration file).

    • Change log levels of run-time loggers.

    • Specify loggers that are currently neither persistent nor run time.

    • Specify the log file configuration parameters such as the log file path and log rotation policies.

    • Create a new log file configuration.

    • Create a new log file configuration using an existing log file configuration.

    • View the log file configuration parameters.

    • Associate one or more loggers with a log file configuration.

Viewing Performance Information Using Fusion Middleware Control

You can monitor performance information for the Content Server or Inbound Refinery instance to quickly assess the performance of the system. Information includes a graph of key metrics and values, and a listing of recent service requests.

To view performance information:

  1. Log in to Fusion Middleware Control.
  2. In the navigation tree, expand the appropriate domain name (for example, Farm_base_domain), then WebCenter, then Content.
    • For the Content Server instance, expand Content Server, then select the Content Server instance name (for example, Oracle WebCenter Content - Content Server (UCM_server1)).

    • For the Inbound Refinery instance, expand Oracle Inbound Refinery, then select the Inbound Refinery instance name (for example, IBR (IBR_server1)).

  3. On the home page for the instance, from the Content Server or IBR menu choose Monitoring, then Performance Summary. The Performance Summary page appears.

    By default, the Performance Summary page shows the performance metrics for the past 15 minutes. You can use the Slider or the Enter Time icon to change the time period for metrics to appear.

    The Performance Summary page displays information in a graph format. To view metrics in a table format, select Table View.

    The key Inbound Refinery metric displayed by default is the rate of conversion, measured in documents per minute. Key Content Server metrics are described in Table 7-1.

    Table 7-1 Key Content Server Metrics

    Element Description

    Active Threads

    The number of active threads in the Content Server instance.

    Active Database Connections

    The number of active database connections made by the Content Server instance.

    Audit Messages

    The total number of audit messages.

    Read Actions

    The number of Read service requests processed, and whether the system is handling the requests successfully.

    Write Actions

    The number of Write service requests processed, and whether the system is handling the requests successfully.

    Search Queries Cached

    The number of search queries cached (rows).

    Hit to Miss Ratio

    The hit to miss ratio for the number of search queries performed.

    Documents in GenWWW State

    The number of documents in a GenWWW state waiting for Inbound Refinery.

    Documents Waiting to be Indexed in Done State

    The number of documents in a Done state waiting to be indexed.

    Documents in Workflow

    The number of documents currently in workflows.

    Average Requests Per Sec

    The average number of Services requested per second.

  4. Click Show Metric Palette to see all the metrics that can be viewed in the chart. The Metric Palette lists available options for metrics to display in graphs.

    Click Hide Metric Palette to collapse the Metric Palette and provide more space to view the metric chart.

  5. With the Metric Palette expanded, select the check box for each metric you want to appear.

    Metric Palette Content Server metrics are described in Table 7-2.

    Metric Palette IBR metrics are described in Table 7-3.

    Table 7-2 Content Server Metric Palette

    Element Description

    Cache Information

    • Items Temporarily Loaded: Indicates whether any temporary items are loaded.

    • Pages Permanently Loaded: The number of permanently loaded pages.

    • Resource Files Permanently Loaded: The number of permanently loaded resource files.

    • Temporary Cache capped at: The number at which cache is temporarily capped.

    • Temporary Items Consuming: The total number of items in cache.

    Connections

    • Active Database Connections: The total number of active database connections made by the WebCenter Content Server instance.

    • Active Threads: The total number of active threads.

    • Audit Messages: The total number of audit messages.

    • Read Actions: The number of Read service requests processed, and whether the system is handling the requests successfully.

    • Write Actions: The number of Write service requests processed, and whether the system is handling the requests successfully.

    Inbound Refinery Queue

    • Documents in GenWWW State: The number of documents waiting for Inbound Refinery in a GenWWW state.

    • Documents Waiting to be Indexed in Done State: The number of documents waiting to be indexed in a Done state.

    Localization Information

    • Localization test lookups per second: The number of localization test lookups per second.

    • String Key Count: The number for the string key count.

    Memory Details

    The number of Write service requests processed, and whether the system is handling the requests successfully.

    • Available Processors: The number of processors available to the WebCenter Content Server instance.

    • Free Memory (bytes): The total free memory available in JVM on the WebCenter Content Server instance.

    • Maximum Memory (bytes): The maximum JVM memory capacity for the WebCenter Content Server instance.

    • Total Memory (bytes): The total JVM memory for the WebCenter Content Server instance.

    Response

    Status: Whether the WebCenter Content Server instance is up or down. It takes on values 1 or 0: 1 indicates up and 0 indicates down.

    Schema Cache Details

    Number of Items Stored: The total number of items in cache.

    SearchCache

    • Hit to Miss Ratio: The hit to miss ratio for the number of search queries performed.

    • Search Queries Cached: The number of search queries cached (rows).

    Server State

    State: The current state of the WebCenter Content Server.

    Service Requests

    Average Requests Per Sec: The average number of Services requested per second

    Workflow

    Documents in Workflow: The number of documents currently in workflows.

    Table 7-3 Inbound Refinery Metric Palette

    Element Description

    Jobs By Size

    Number of jobs per file size.

    Jobs By Type

    Number of jobs per conversion type.

    Job Summary

    • Active Jobs: Number of jobs currently being converted.

    • Conversion Rate: The rate since startup at which documents are converted, measured in documents per minute.

    • Failed Jobs: The number of documents that were not converted successfully.

    • Succeeded Jobs: The number of documents that were converted successfully

    • Total Jobs: All documents processed by Inbound Refinery, including those that succeeded and those that failed.

    PreconversionQueueMetrics

    Number of jobs currently waiting to be converted.

    PostconversionQueueMetrics

    Number of jobs that have been converted and are waiting to be picked up by Content Server.

    Response

    Status: Whether the Inbound Refinery instance is up or down. It takes on values 1 or 0: 1 indicates up and 0 indicates down.

Viewing MBean Information Using Fusion Middleware Control

You can use the MBean browser to view MBean attribute information about the Content Server or Inbound Refinery instance.

To view MBean information:

  1. Log in to Fusion Middleware Control.
  2. In the navigation tree, expand the appropriate domain name (for example, Farm_base_domain), then WebCenter, then Content.
    • For the Content Server instance, expand Content Server, then select the Content Server instance name (for example, Oracle WebCenter Content - Content Server (UCM_server1)).

    • For the Inbound Refinery instance, expand Oracle Inbound Refinery, then select the Inbound Refinery instance name (for example, IBR (IBR_server1)).

  3. On the home page for the instance, from the Content Server or IBR menu choose System MBean Browser.

    The System MBean Browser page displays the navigation pane with the instance name highlighted and the configuration MBean application deployment information for the instance.

  4. On the Attributes tab, you can view individual attribute names, descriptions, type of access, and values. If you change an attribute value, click Apply.
  5. On the Operations tab, you can view and invoke individual MBean operations.
    • To view details, select an MBean.

    • To apply an MBean operation, select Invoke.

    • To reset an operation to its previous setting, click Revert.

    • To go back to the Operations tab, click Return.

See Understanding WebLogic Server MBeans in Developing Custom Management Utilities Using JMX for Oracle WebLogic Server.