Skip Headers
Oracle® Fusion Middleware Administrator's Guide for Oracle Access Manager
11g Release 1 (11.1.1)

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

Go to previous page
Go to next page
View PDF

15 Monitoring OAM Metrics by Using Oracle Access Manager

Oracle Access Manager uses the Oracle Dynamic Monitoring Service (DMS) to measure application specific performance information for both OAM Servers and Agents. This chapter provides the following topics:


This chapter describes how to use Oracle Access Manager to monitor performance metrics. However, you can also use Oracle Enterprise Manager Fusion Middleware Control to monitor Oracle Access Manager performance metrics, as follows:

Introduction to Monitoring and Metrics by Using OAM

Metric collection is the mechanism by which components collect information in memory for particular events. Based on these events, you can monitor the time spent in a particular area or track particular occurrences or state changes. These metrics are kept only in memory and there are several mechanisms to extract and display them: EM, dmsSpy, dmsDump, for instance.

Administrators can monitor performance for Oracle Access Manager 11g using the Monitoring command from the System Configuration tab, Actions Menu.

About OAM Proxy Metrics

The OAM Proxy provides the same or comparable throughput as the Oracle Access Manager 10g Access Server. Throughput refers to the number of requests processed per second. Latency refers to the time required to process a particular request. There is less than a 20% latency increase with the introduction of a proxy between WebGate and OAM Server.

Performance of the OAM Proxy can be tuned by changing its configuration through the Java EE container Administration Console. Both the Java EE container Administrator and the OAM Administrator can tune performance.

Table 15-1 OAM Proxy Metrics

Metric Description

Number of active threads doing handshake


Average time spent performing initial handshake


Number of times an initial handshake has been executed


Maximum time spent performing initial handshake


Minimum time spent performing initial handshake


Total time spent performing initial handshake


Count of failed handshakes


Count of how many Peer Compatibility Check Failures have happened


Count of how many Open Security Mode handshakes have happened


Count of how many Simple Security mode handshakes have happened


Count of how many SSL Security Mode handshakes have happened

Number of active threads doing security mode negotiation

Monitoring Agents and Servers

To monitor an agent or server instance

  1. From the System Configuration tab, navigation tree, locate and select the name of the instance to monitor:

    • OAM Agent Name

    • OSSO Agent Name

    • OAM Server Name

  2. From the Actions menu, click Monitor and review metrics on the page that opens as described in following steps.

  3. OAM Server: On the instance page that opens, view the results.

    • Server Processes Overview

    • Session Operations

    • Server Operations

    • OAM Agents

  4. OAM Agent:

    • Connectivity

    • Operations Overview

    • Operations Detail

    • Information

  5. OSSO Agent: On the instance page that opens, view the results.

    • Processes Overview

    • Operation Detail

Reviewing Performance Metrics

This section describes how to review metrics for various components and how to determine whether tuning is needed. The following topics are included:

Reviewing OAM Agent Metrics

Figure 15-1 OAM 10g Agent Monitoring Page

Surrounding text describes Figure 15-1 .

Figure 15-2 Detached OAM 10g Agent Connection Table

Surrounding text describes Figure 15-2 .

Figure 15-3 Detached OAM 10g Agent Operations Overview Table

Surrounding text describes Figure 15-3 .

Figure 15-4 Detached OAM 10g Agent Operations Overview Table

Surrounding text describes Figure 15-4 .

Figure 15-5 Detached OAM 10g Agent Information Table

Surrounding text describes Figure 15-5 .

Reviewing OSSO Agent Metrics

Figure 15-6 OSSO 10g Agent Monitoring Page with Operation Details

Surrounding text describes Figure 15-6 .

Figure 15-7 OSSO 10g Agent Monitoring Process Overview Table Detached

Surrounding text describes Figure 15-7 .

Figure 15-8 OSSO 10g Agent Information Table Detached

Surrounding text describes Figure 15-8 .

Performance Tuning Parameters

This section provides the following information:

OAM Proxy Server Tuning Parameters

Table 15-2 provides the tuning parameters for the OAM Proxy.

Table 15-2 OAM Proxy Tuning Parameters

Purpose Parameter Type Value Description



Note: Proxy server can limit (throttle) the quantity of requests within a specified amount of time not to be exceeded by the proxy server to avoid crashes due to unavailability of resources (like memory.

In such cases, a status code is returned indicating that the client should temporarily route requests to other servers



The maximum memory in KB of the message queue across all the connections. If this value is exceeded, OAM proxy will not accept further requests on a connection. If a value of 0 or less than 0 is specified, this parameter will not be used

Denial of Service Attacks




The time interval in seconds for validating the connections periodically for denial of service attacks





Maximum length of backlog queue





The maximum time in milliseconds within which the client should complete the NAP handshake with client. If NAP handshake over a connection is not completed within this time, the connection will be marked as malicious