Oracle Tuxedo Monitoring

Overview

Oracle Tuxedo provides the framework for building scalable multi-tier client/server applications in heterogeneous distributed environments. From the Web to the Enterprise, Tuxedo users can develop, manage, and deploy distributed applications independent of the underlying hardware, operating system, network and database environment.

Monitoring Oracle Tuxedo applications can be complex, providing requests that run across multiple processes, machines, and domain boundaries. Applications Manager can help you monitor system and application data from key Tuxedo components like the bulletin board, queue and communication bridge details, transaction info, ATMI operations and service details.

Creating a new Oracle Tuxedo monitor

Oracle Tuxedo Versions Supported: Tuxedo version 6.5 and above.We are using BEA SNMP Agent and the SNMP MIBs to manage Tuxedo applications.

Prerequisites for monitoring Oracle Tuxedo: You must have Tuxedo SNMP agent installed. When you specify the SNMP community string, make sure that the community string has at least 'Read-only' privileges.

Attributes Monitored: Refer Oracle Tuxedo Monitoring Parameters to know more about the attributes monitored.

To create a Oracle Tuxedo Monitor:

Click on New Monitor link.
Select Oracle Tuxedo.
Enter the Display Name of the monitor.
Enter the Hostname of the host where the Oracle Tuxedo Server is running.
Enter the SNMP port number , on which the Tuxedo SNMP agent is running. The default port number is 161.
You can enter your own credential details or select preconfigured credentials details in Credentials Manager.
Specify the SNMP community string of Tuxedo SNMP agent. The default value is 'public'. Make sure you use a community string, that has 'Read' privileges.
Enter the timeout in seconds.
Set the Polling interval.
If you are adding a new monitor from an Admin Server, select a Managed Server.
Choose the Monitor Group from the combo box with which you want to associate Tuxedo server (optional). You can choose multiple groups to associate your monitor.
Click Add Monitor(s). This discovers the Tuxedo server from the network and starts monitoring it.

Monitored Parameters

Go to the Monitors Category View by clicking the Monitors tab. Click on Oracle Tuxedo under the Middleware/Portal Table. Displayed is the Oracle Tuxedo bulk configuration view distributed into three tabs:

Availability tab, gives the Availability history for the past 24 hours or 30 days.
Performance tab gives the Health Status and events for the past 24 hours or 30 days.
List view enables you to perform bulk admin configurations.

Click on the monitor name to see all the server details listed under the following tabs:

Performance Overview
Servers
Queue
Service
Configuration

Performance Overview

Parameter	Description
BULLETIN BOARD PARAMETERS
Max Accessers	The maximum number of clients and servers that can have access to the bulletin board on the server machine at one time.
Max Conversations	The maximum number of simultaneous conversations in which clients and servers on the Tuxedo server can be involved.
Max Transactions	The maximum number of simultaneous global transactions in which this machine can be involved.
Max Objects	The default maximum number of active objects to be accommodated in the Active Object Map Tables.
BULLETIN BOARD STATUS
Accessers Used	The number of processes in use that can have access to a bulletin board on a particular processor at any one time.
Conversations Used	The current number of conversations used.
Service Load Enqueued	The service load currently enqueued on the server machine.
Current Clients Count	The number of clients, both native and workstation, currently logged in to the server machine.
Domain State	The state of the domain. The various states are: 1 - Active 2 - Inactive 3 - Forcible Inactive Note: Forcible shutdown works only in case of single-machine applications.
MACHINE STATUS
Machine Name	The source logical machine name.
Machine State	The state of the source machine. The various states are: 1 - Active 2 - InActive 3 - Partitioned 4 - Invalid 5 - Re-Activate 6 - Cleaning
BULLETIN BOARD LIAISON (BBL)
Server	The name of the Tuxedo server where the BBL administration process running
Process Name	The name of the BBL process running on the Tuxedo server
State	The state of the BBL Process.
TLISTEN
Lmid	The logical machine identifier.
TListen State	The state of your workstation listener within the application. Various states are: 1 - active 2 - inactive
BRIDGE DETAILS
Bridge Lmid	The source logical machine identifier.
Bridge State	The state of the communication bridge. The various states are: 1 - active 2 - inactive 3 - suspended 4 - pending
Bytes Received/Sec	The average number of bytes sent per second from the destination logical machine to the source logical machine.
Bytes Sent/Sec	The average number of bytes sent per second from the source logical machine to the destination logical machine.
Messages Received/Sec	The average number of messages sent per second from the destination logical machine to the source logical machine.
Messages Sent/Sec	The average number of messages sent per second from the source logical machine to the destination logical machine.
TRANSACTION DETAILS
Initiated/Sec	The number of transactions initiated per second from the server machine.
Aborted/Sec	The number of transactions aborted per second from the server machine.
Committed/Sec	The number of transactions committed per second from the server machine.
Transactions Used	The number of transactions on the tuxedo server.
ATMI OPERATION DETAILS
Connections/Sec	The number of connections performed per second from the server.
Dequeues/Sec	The number of dequeue operations performed per second from the server.
Enqueues/Sec	The number of enqueue operations performed per second from the server.
Post/Sec	The number of post operations performed per second from the server.

Servers

Parameter	Description
SERVER DETAILS
Name	The name of the Tuxedo machine.
Group Number	The group number associated with a server's group.
Server ID	A numeric identifier that uniquely identifies a server within a group.
State	This field displays the state of your server. A server can be in one of the following states: 1 - active 2 - inactive 3 - migrating 4 - cleaning 5 - restarting 6 - suspended 7 - partitioned 8 - dead 9 - invalid
SERVER TRANSACTION DETAILS
Transaction Initiated/Sec	The number of transactions initiated per second from the server.
Aborted/Sec	The number of transactions aborted per second from the server.
Committed/Sec	The average number of transactions committed per second from the server.
SERVER OPERATION DETAILS
Dequeues/Sec	The number of dequeue operations performed per second from the server.
Enqueues/Sec	The number of enqueue operations performed per second from the server.
Post/Sec	The number of post operations performed per second from the server.
Requests/Sec	The number service requests operations performed per second from the server.
Subscriptions/Sec	The number of subscribe operations performed per second from the server.

Queue

Parameter	Description
QUEUE DETAILS
Queue Address	The address of the request queue for an active server offering the interface.
State	The state of the Interface Queue objects. Values are: 1 - Active state 2 - Migration State 3 - Suspended state 4 - Partitioned state
Active Servers	The number of active servers associated with this queue.
Queue Length	The sum of the queue lengths of this queue while it has been active.
Workload/Sec	The load on the system imposed per second by the queue.
Requests/Sec	The number of requests enqueued per second for this interface.

Service

Parameter	Description
SERVICE DETAILS
Name	The name of the service on which the server is currently working.
State	The state of the service: 1 - active 2 - inactive 3 - invalid
Load On System	The relative load that the service imposes on the system.
Timeout (in Seconds)	The time limit (in seconds) for processing requests for this service.

Configuration

Parameter	Description
CONFIGURATION
Domain Master	The host where the Tuxedo domain master is running.
Model	The classification of your Tuxedo application as a single-machine (SHM) or multiprocessor (MP) application.
License Expiration Date	The expiration date for the binary on the server machine or a 0- length string if binary is not a TUXEDO System/T master binary.
MACHINE DETAILS
Machine Name	The name of the machine used by Tuxedo for mapping application resources to machines configured for this application.
Machine Lmid	The machine identifier used for mapping application resources to configured machines.
Machine Role	This field displays the role of this machine. The various roles are: MASTER BACKUP OTHER (Neither the master nor the backup master machine).
TUXDIR	The absolute path name of the installation directory of Oracle Tuxedo.
TUX Conf File	Each Tuxedo application is controlled by a configuration file in which installation-dependent parameters are defined. This parameter displays the path to the location of the configuration file.