Monitoring Oracle Tuxedo
The Oracle Tuxedo sensor supports only local monitoring, so you must install Instana agent on your Tuxedo server. After you install the Instana agent, Oracle Tuxedo sensor is automatically installed, but you need to configure Oracle Tuxedo sensor as outlined in this topic. Then, you can view metrics that are related to Oracle Tuxedo in the Instana UI.
Supported information
Supported operating systems
The Oracle Tuxedo sensor supports AIX 7.2, SUSE 12 SP5 on x86_64, and RHEL 7.9 on x86_64.
Supported Oracle Tuxedo versions and platforms
Instana supports metrics and configuration data for Oracle Tuxedo 12.1.3 or later. The supported platforms are the same as the Supported operating systems for Tuxedo sensor.
Configuring
To collect monitoring data of Oracle Tuxedo, you need to configure the following fields in the agent configuration file <agent_install_dir>/etc/instana/configuration.yaml:
The Oracle Tuxedo sensor instance monitors Tuxedo runtime application by querying data from Management Information Base (MIB) by using the ud32 and tmadmin command-line utilities. Make sure that the configurations are
correct.
See the following configurations in the <agent_install_dir>/etc/instana/configuration.yaml file:
com.instana.plugin.tuxedo:
# Oracle Tuxedo
enabled: true
poll_rate: 60 # The mininum poll rate is 60 seconds, the default is 60 seconds.
tuxdir: <INSERT_TUXEDO_SERVER_INSTALL_DIR_HERE> # The default full qualified path of Oracle Tuxedo installation directory
tuxuser: <INSERT_OS_ACCOUNT_OF_TUXEDO_DOMAIN_HERE> # The default Unix/Linux account of the Tuxedo domains
availabilityZone: <INSERT_AVAILABILITYZONE_HERE> # The default availability zone of the Tuxedo Domains
domains:
- tuxconfig: <INSERT_TUXCONFIG_OF_FIRST_DOMAIN_HERE> # The full qualified path to the binary configuration file of the Tuxedo domain
tuxdir: <INSERT_TUXEDO_SERVER_INSTALL_DIR_HERE> # The optional parameter to specify the Tuxedo installation directory if it is different from the default setting.
tuxuser: <INSERT_OS_ACCOUNT_OF_TUXEDO_DOMAIN_HERE> # The optional parameter to specify the Unix/Linux account of the Tuxedo domain if it is different from the default setting.
availabilityZone: <INSERT_AVAILABILITYZONE_HERE> # The optional parameter to specify a zone for this Tuxedo domain if it is different from the default setting.
- tuxconfig: <INSERT_TUXCONFIG_OF_SECOND_DOMAIN_HERE> # The full qualified path to the binary configuration file of the Tuxedo domain
Viewing metrics
To view the metrics, complete the following steps:
- Select Infrastructure in the sidebar of the Instana UI.
- Locate the availability zone that you defined in the configuration file. The default zone is
Tuxedo Domainsif it is not specified in the configuration file. - Click the domain pillar in the availability zone.
You can see the domain dashboard with all the collected metrics for the selected Tuxedo domain.
Tuxedo domain
The following tables list the configuration and metric details of the Tuxedo domain:
Configuration data
| Domain details | Description |
|---|---|
| Domain Name | Name of the domain that uniquely identifies the domain |
| Domain Id | Domain identification string that is nonunique |
| TUXCONFIG | Binary configuration file of the Tuxedo domain |
| IPCKEY | Numeric key for the well-known address in the system bulletin board |
| TUXDIR | Installation directory of the Tuxedo server |
Performance metrics
| Domain metric | Description |
|---|---|
| numOfSvrs | Number of servers |
| numOfSvcs | Number of services |
| numOfReqQue | Number of request queues |
| numOfSrvGrps | Number of server groups |
| numOfIntfs | Number of interfaces |
| totalIPCQnum | Total number of IPC messages currently on the queues |
Tuxedo machine
The following tables list the configuration and metric details of the Tuxedo machine:
Configuration data
| Machine details | Description |
|---|---|
| pmid | Physical machine identifier |
| lmid | Logical machine identifier |
| state | State of the machine in the domain |
| role | Role of the machine in the domain |
Performance metrics
| Machine metric | Description |
|---|---|
| stateMetric | State of the machine: 1 - ACTIVE, 2 - INACTIVE, and 3 - PARTITIONED |
| currLoad | Current service load enqueued on this machine |
| curAccessers | Number of clients and servers that are currently accessing the application |
| hwAccessers | High water number of clients and servers that are accessing the application |
| numReq | Number of tpacall() or tpcall() operations that are performed from this machine |
| wkCompleted | Total service loads that are dequeued and processed successfully by servers running on this machine |
| wkInitiated | Total service loads that are enqueued by clients or servers running on this machine |
| numDequeue | Number of tpdequeue() operations that are performed from this machine |
| numEnqueue | Number of tpenqueue() operations that are performed from this machine |
| totalQnum | Total number of IPC messages that are currently on the queues |
IPC queue
The following tables list the configuration and metric details of the IPC queue:
Configuration data
| IPC queue details | Description |
|---|---|
| id | UNIX system message queue identifier |
| senderSrv | Process name of the last process that wrote to the queue |
| receiverSrv | Process name of the last process that read from the queue |
Performance metrics
| IPC Queue details | Description |
|---|---|
| cbyte | Current number of bytes on the queue |
| qnum | Number of messages that are currently on the queue |
| usage | Percentage of queue usage |
| senderPID | Process identifier of the last process that wrote to the queue |
| receiverPID | Process identifier of the last process that read from the queue |
Tuxedo server
The following tables list the configuration and metric details of the Tuxedo server:
Configuration data
| Server details | Description |
|---|---|
| Id | Unique server identifier within the group |
| name | Name of the server executable file |
| grpName | Group name associated with this server's group |
| grpNo | Group number associated with this server's group |
| lmid | Current logical machine on which the server is running |
| PID | Process identifier of the server |
| state | State of the server |
Performance metrics
| Server details | Description |
|---|---|
| stateMetric | State of the server: 1 - ACTIVE, 2 - INACTIVE, 3 - MIGRATING, 4 - CLEANING, 5 - RESTARTING, 6 - SUSPENDED, 7 - EXITING, 8 - PARTITIONED,
and 9 - DEAD |
| numCompleted | Total number of requests completed by this server |
| numQueued | Number of requests initiated by this server that are still active |
Service
The following tables list the configuration and metric details of the Tuxedo service:
Configuration data
| Service details | Description |
|---|---|
| name | Service name |
| state | State of the service |
Performance metrics
| Service details | Description |
|---|---|
| stateMetric | State of the service: 1 - ACTIVE, and 2 - INACTIVE |
| numCompleted | Number of service requests completed that are returned only when LDBAL is set to Y |
| numQueued | Number of requests currently enqueued to this service that are returned only when LDBAL is set to Y |