Administration Guide

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Introduction to Oracle TSAM Plus

This topic contains the following sections:



Oracle Tuxedo System and Applications Monitor Plus (TSAM Plus), is an Oracle Tuxedo add-on product. Tuxedo is widely used by enterprises that develop and use in mission-critical applications. It acts as the infrastructure layer in distributed computing environments. The complexity of Tuxedo and the applications running on top of it makes performance measurement extremely complex.

Oracle TSAM Plus monitors the major performance sensitive areas of a Tuxedo-supported enterprise computing environment. It can be used to monitor real-time performance bottlenecks and business data fluctuations, determine service models, and provide notification when pre-defined thresholds are violated.


Oracle TSAM Plus Components

This section introduces the following Oracle TSAM Plus components:

Oracle TSAM Plus Agent

The Oracle TSAM Plus Agent handles all Tuxedo-side back-end logic. It works in conjunction with the Oracle TSAM Plus Manager, and includes the following sub-components:

For more information, see Oracle TSAM Plus Agent.

Oracle TSAM Plus Manager

The Oracle TSAM Plus Manager is built on J2EE technology. It includes following components:

For more information, see Oracle TSAM Plus Manager.

Enterprise Manager for Oracle Tuxedo

Enterprise Manager for Oracle Tuxedo is an Oracle Enterprise Manager plug-in, by which users are able to monitor and manage Oracle Tuxedo product family in a centralized console with other product such as Weblogic Server and Oracle Database.

For more information, see Enterprise Manager for Oracle Tuxedo.

Oracle TSAM Plus Architecture

Figure 1-1 shows the Oracle TSAM Plus architecture.

Figure 1-1 Oracle TSAM Plus Architecture

Oracle TSAM Plus Architecture


Oracle TSAM Plus High Availability and Scalability

Oracle TSAM Plus High Availability

From TSAM Plus, you can configure two TSAM Plus managers for one TSAM Plus agent. The first one is a master. When the master manager is not available, TSAM Plus agent tries to connect the second one as a backup.

Figure 1-2 Oracle TSAM Plus High Availablility

Oracle TSAM Plus High Availablility

TSAM Plus Manager Scalability

For an enterprise that has a large number of Tuxedo applications and TSAM Plus agents, it is a challenge to let the existing Oracle TSAM Plus manager do following tasks simultaneously:

Oracle TSAM Plus enhances TSAM Plus manager scalability, which enables you to configure multiple TSAM Plus managers in one TSAM Plus system.

As shown in Figure 1-3, there are four Oracle TSAM Plus managers configured in one Oracle TSAM Plus system, in which manager 1 and 2 are configured as data servers, and manager 3 is configured as a TSAM Plus console. Manager 4 is configured for call pattern batch calculation purpose.

Figure 1-3 Oracle TSAM Plus Manager Scalability

Oracle TSAM Plus Manager Scalability


Oracle TSAM Plus Concepts

Call Path Monitoring

Tuxedo is typically used by a client program (not necessarily a Tuxedo client process) that calls a service to perform a business computing logic scenario. The service implementation is completely transparent to the caller. This type of middleware transparency provides many benefits for development, deployment, and system administration. However, from a monitoring perspective, it is difficult for the end user or administrator to figure out what happens “behind the scene”. Oracle TSAM Plus call path monitoring helps to alleviate this problem.

Call Path Tree Definition

A simple Tuxedo application call triggers a set of service invocations. The involved services constitute a tree (“call path tree”). A call path tree strictly defines the following factors:

Monitoring Initiator

A "monitoring initiator" is a process that "initiates" tracking a call path tree. The process can be a Tuxedo client, application server, client proxy server (WSH/JSH), the Tuxedo domain gateway server or web services proxy serve GWWS. A typical scenario is when a tpcall/tpacall is invoked by the monitoring initiator; call path monitoring begins. All the back-end services involved in this call are displayed on the call path tree representation in the Oracle TSAM Plus Console.

Note: Currently only tpcall/tpacall can trigger a call path monitoring. Other communication models are not supported.

A Tuxedo application server performs two functions:

Service Monitoring

Service monitoring focuses on Tuxedo service execution status. It does not care about call correlation, as call path monitoring does. Service monitoring can be used with call path monitoring together or performed independently. Tuxedo CORBA is also based on the service infrastructure, so in this release the CORBA interfaces can also be monitored.

System Server Monitoring

Tuxedo has several important system servers: BRIDGE, GWTDOMAIN and GWWS. BRIDGE connects multiple Tuxedo machines within a Tuxedo domain. GWTDOMAIN connects one Tuxedo domain with others. GWWS is the web services gateway. The system server monitoring tracks message throughput, pending sent messages and awaiting reply messages on each network link for BRIDGE and GWTDOMAIN. For GWWS, the web service requests statistics will be collected.

Transaction Monitoring

A critical use of Tuxedo is transaction monitoring. Tuxedo coordinates activities in a distributed transaction with an XA compliant resource manager, such as a database. Oracle TSAM Plus transaction monitoring tracks each XA call triggered in a transaction allowing you to clearly identify where a global distributed transaction is bottle necked. TSAM Plus supports the transaction monitoring capability propagation. That is if the transaction initiator is monitored, all XA calls on the transaction path will be monitored. The propagation supports transaction across domains.

Oracle Tuxedo Application Runtime for CICS and Batch Monitoring

Oracle TSAM Plus allows you to monitor the following Oracle Tuxedo Application Runtime for CICS and Batch components.

For more information, see Oracle Tuxedo Application Runtime for CICS and Batch documentation.

Policy Monitoring

Oracle TSAM Plus provides a comprehensive policy monitoring mechanism. When the proper policy monitoring settings are created, you can collect the exact metrics needed with minimum application performance impact. You define a policy using the TSAM Plus Web console and apply it to an Oracle Tuxedo application automatically. Oracle TSAM Plus Policy Monitoring has the following characteristics:

Performance Metrics

Oracle TSAM Plus performance metrics are listed as follows:


Listing 1 shows an example of a Correlation ID. The monitored call is started by the program “bankclient” with process ID 8089 and thread ID 1 on machine “SITE1” on Tuxedo domain “TUXDOM1”. The master is “bjsol18” and IPCKEY in TUXCONFIG is “72854”.

Listing 1 Correlation ID Example
TUXDOM1:bjsol18:72854 SITE1 bankclient 8089 1 99 1259309025


Oracle TSAM Plus Use Cases

Oracle TSAM Plus is built on top of Oracle Tuxedo and has unique service, call, and transaction tracking capabilities. Enterprise organization usually have many widely distributed services deployed and one client request that requires complex back-end service coordination to perform the processes.

It can be difficult for an administrator to figure out what exactly is happening during these interactions. Oracle TSAM Plus call path monitoring helps to alleviate this problem.

The followings are FAQs will help you to better understand how Oracle TSAM Plus works with your applications:

Optimizing Application Development

Is the message routing working as expected?

Message routing is an important concept in Tuxedo. It impacts the system's performance, business logic process correctness and application reliability and high availability. Lots of factors can affect Tuxedo message routing, such as:

In development stage, huge of tests needed to verify your settings take effect. Without TSAM Plus, it is hard to tell the exact request going to the correct service desired. TSAM Plus call path can depict each call path clearly and speed your development process.

Understanding Your Applications

What happens behind a simple call?

Enabling call path monitoring for a Tuxedo client or application server allows you to find out all the information behind a simple tpcall/tpacall. The tracking points span multiple machines and multiple domains. You can clearly see the following information in the call path tree:

What about my services?

Service monitoring enables you to measure your service response time, IPC queue length, and execution status. Service monitoring provides the following information:

Is my network busy?

Oracle TSAM Plus allows you to monitor the network connection attached to your local domain gateways. You can easily find which link is busy and its data fluctuation trend. You have more in-depth understanding of the business data flow model between departments and organizations.

Who participates in my transaction?

Oracle TSAM Plus monitors the transaction XA calls. Transaction participants are listed on the transaction monitoring page. For a large distributed transaction, a slow branch can result in the entire transaction being slowly completed. Oracle TSAM Plus lets you know who the transaction participants are, and how much time is used during XA calls. The transaction monitoring can also help find the bottleneck in a two phase commit stage if multiple resource managers involved.

Solving Application Performance Problems

Why is the service response time slow recently?

Turn on the call path monitoring for a particular call to investigate the following:

My back-end services failed, but I don’t know which one.

Turn on call path monitoring. You can find the service execution status for this call.

How many kinds of call paths are in my application?

Turn on call path monitoring using an adequate sampling policy. Oracle TSAM Plus will tell you how many call paths (a “call pattern”) exist in your application.

Why is my global distributed transaction completed slowly?

Turn on Oracle TSAM Plus transaction monitoring. You can see the execution time used by the transaction participants.

I want to correlate local transactions with remote transactions.

Turn on Oracle TSAM Plus transaction monitoring for all involved processes and GWTDOMAIN. The Oracle TSAM Plus Console shows you the transaction mapping between local and remote transactions.

I want to know what is the peak time that my local domain uses resources from the remote domain, and how busy it is.

Use Oracle TSAM Plus system server monitoring on the GWTDOMAIN. Oracle TSAM Plus records the information for you, and shows you the throughput trends.

Can I check program request information?

Turn on call path monitoring with the proper monitoring policy and then use “tpgetcallinfo”. The following information is provided.

The monitoring initiator process, tpgetcallinfo(), can also tell you the total time used.

Improving Application Performance

Are my services too fine grained?

In some cases, too many services supporting a request may add to performance overhead. Use call path tree to investigate. The service number and the tree depth are key analysis factors.

Are my services deployed properly?

Some services are called more frequently than others. Use call path monitoring to gather the information, and re-consider the service deployment. It is best to have the most used services located on the local machine and LAN. Services across domain services should be used carefully.

Do I have too many servers configured?

Oracle TSAM Plus provides a central view of your Tuxedo applications with multiple domain support. Using Oracle TSAM Plus Console allows you to easily see how many domains, machines, servers and services are configured.

I want to be notified when something is wrong with my system

Oracle TSAM Plus provides comprehensive alert configuration based on the metrics collected. The base technology of TSAM Plus alert evaluation is Tuxedo FML Boolean expression, so you can combine complex conditions to compose an alert, such as:

How to drop stale requests?

Some times the service execution is slow and quite some request messages are waiting for a long time in the IPC queue. The client who issues the request might be already got timeout notification, but the service still continually to process the request. Oracle TSAM Plus Alert can allow you to configure an "drop request" action with some metrics. For example, you can drop a request if the waiting time of a message greater an large value. You can also configure an alert with drop request action under the condition that the message number in the request queue exceeding some threshold.


Quick Start

To add Oracle TSAM Plus functionality to an existing Oracle Tuxedo application, do the following steps:

  1. Install Oracle TSAM Plus
  2. Install the Oracle TSAM Plus Agent and the Oracle TSAM Plus Manager. For more information, see the Oracle TSAM Plus Installation Guide.

  3. Deploy Oracle TSAM Plus Agent and Oracle TSAM Plus Manager
  4. For more information, see the Oracle TSAM Plus Deployment Guide.

  5. Find Your Oracle Tuxedo Configuration
  6. Login to the Oracle TSAM Plus Manager Console (for example: http://localhost:8080/tsam/faces).

    Your Oracle Tuxedo configuration can be found in the Oracle Tuxedo component tree panel. For more information, see the Oracle TSAM Plus Console User Guide.

  7. Configure Monitoring Policy
  8. Monitoring policy defines what and how you want to monitor.

    For more information, see Monitoring Policy Management in the “Oracle TSAM Plus Agent User Guide.”

    For more information, see Policy Management in “Oracle TSAM Plus Console User Guide.”

    • Typical Monitoring Policy

    Go to Policy > Monitoring Policy page, click "Add" to enter the "Create Policy" page. Input "tsampolicy" in the "Name:" input field.

    Monitor call path initiated from a particular client

a. In the left panel "Tuxedo Component", select the "Domain" in the drop down lists
b. In the right panel "Call Path" tab, select the "Enable" checkbox
c. Select the "Filter" check box with "Workstation Client"
d. Input a client name in the "Client Name" input box
e. Click "Add & Enable" button

• Monitor services of a particular server

Similar steps as call path monitoring policy, except you must select options at the "Service" tab. In the "Filter", you can select service from a list or input it manually.
Other monitoring policy set have similar steps. You can group several monitoring categories in one policy.
  1. Start to Monitor Tuxedo
  2. Login to TSAM Plus Console, and start to monitor Tuxedo system and application.

    Go to Metrics > Call Path to monitor call path.

    Go to Metrics > Service to monitor service.

    Go to Metrics > Domain Gateway to monitor GWTDOMAIN.

    For more information, see the Oracle TSAM Plus Console User Guide.


See Also

  Back to Top       Previous  Next