Oracle Tuxedo and Enduro/X Metrics

For how the subagent reads these values and how to set it up, see Oracle Tuxedo and Enduro/X Monitoring.

These metrics are provided by the tuxedo subagent. The subagent is built either for Oracle Tuxedo or for Enduro/X: the Tuxedo build provides the Tuxedo.* names, and the Enduro/X build provides the EnduroX.* names. Each entry shows the Enduro/X name next to the Tuxedo name when the Enduro/X build provides the metric; otherwise the metric exists only in the Tuxedo build.

The values come from the data that the subagent reads from the application every PollingInterval seconds, not from a request at query time. Metrics that read the class caches return an error when the last read of their class failed or no read has completed yet, and the error no such instance when the argument does not match an object in the last read data (the ServerInstance metrics return not supported instead). Tuxedo.LocalMachineId keeps its learned value across later collection failures. String arguments are matched case-insensitively.

Domain Metrics

Tuxedo.Domain.ID, EnduroX.Domain.ID

Domain ID (TA_DOMAINID of class T_DOMAIN).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Domain.Master

Logical machine IDs of the master machine and, after a comma, of the backup master machine, if one is configured (TA_MASTER).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Tuxedo.Domain.Model

Configuration model of the application (TA_MODEL).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Tuxedo.Domain.Queues, EnduroX.Domain.Queues

Current number of queues in the application (TA_CURQUEUES).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Domain.Routes

Current number of bulletin board routing table entries (TA_CURDRT).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Tuxedo.Domain.Servers, EnduroX.Domain.Servers

Current number of servers in the application (TA_CURSERVERS).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Domain.Services, EnduroX.Domain.Services

Current number of services in the application (TA_CURSERVICES).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Domain.State, EnduroX.Domain.State

State of the application (TA_STATE of class T_DOMAIN).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.IsMasterMachine

1 if the agent host is the master machine of the application, 0 otherwise. The subagent takes the first logical machine ID from Tuxedo.Domain.Master, looks up the physical machine ID (TA_PMID) of that machine, and compares it with the host name of the agent host (case-sensitive on UNIX-like systems). Returns an error when domain information is unavailable or the master machine is absent from an available machine list.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Tuxedo.LocalMachineId

Logical machine ID (LMID) of the agent host: the machine whose physical machine ID (TA_PMID) matches the host name of the agent host (case-insensitive). Returns an error until the subagent has found such a machine (see Local Machine ID and Filtering).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Machine Metrics

Tuxedo.Machine.Accessers(lmid), EnduroX.Machine.Accessers(lmid)

Number of clients and servers currently accessing the application on the machine (TA_CURACCESSERS).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 1. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.Bridge(lmid)

Bridge device of the machine (TA_BRIDGE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 2. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.Clients(lmid), EnduroX.Machine.Clients(lmid)

Number of clients currently logged in on the machine (TA_CURCLIENTS).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 3. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.Conversations(lmid), EnduroX.Machine.Conversations(lmid)

Number of active conversations on the machine (TA_CURCONV).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 4. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.Load(lmid)

Current service load of the machine (TA_CURRLOAD).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 5. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.PhysicalID(lmid)

Physical machine ID (TA_PMID).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 6. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.Role(lmid)

Role of the machine in the application (TA_ROLE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 7. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.SoftwareRelease(lmid)

Software release installed on the machine (TA_SWRELEASE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 8. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.State(lmid), EnduroX.Machine.State(lmid)

State of the machine (TA_STATE of class T_MACHINE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 9. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.Type(lmid)

Machine type (TA_TYPE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 10. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.WorkloadsInitiated(lmid)

Workloads initiated on the machine (TA_WKINITIATED).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 11. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.WorkloadsProcessed(lmid)

Workloads processed on the machine (TA_WKCOMPLETED).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 12. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Tuxedo.Machine.WorkstationClients(lmid)

Number of workstation clients currently logged in on the machine (TA_CURWSCLIENTS).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 13. Arguments
Argument Type Description

lmid

String

Logical machine ID (LMID) of the machine, as returned by the Tuxedo.Machines list; case-insensitive

Client Metrics

Tuxedo.Client.ActiveConversations(client-id), EnduroX.Client.ActiveConversations(client-id)

Number of conversations of the client that are currently active (TA_CURCONV of class T_CLIENT).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 14. Arguments
Argument Type Description

client-id

String

Client ID (TA_CLIENTID), as returned by the Tuxedo.Clients list; case-insensitive

Tuxedo.Client.ActiveRequests(client-id), EnduroX.Client.ActiveRequests(client-id)

Number of requests of the client that are currently active (TA_CURREQ of class T_CLIENT).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 15. Arguments
Argument Type Description

client-id

String

Client ID (TA_CLIENTID), as returned by the Tuxedo.Clients list; case-insensitive

Tuxedo.Client.Machine(client-id), EnduroX.Client.Machine(client-id)

Intended to return the logical machine ID of the client. Because of a product defect, it returns the client name (TA_CLTNAME), the same value as Tuxedo.Client.Name. The MACHINE column of the Tuxedo.Clients table contains the machine ID.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 16. Arguments
Argument Type Description

client-id

String

Client ID (TA_CLIENTID), as returned by the Tuxedo.Clients list; case-insensitive

Tuxedo.Client.Name(client-id), EnduroX.Client.Name(client-id)

Client name (TA_CLTNAME).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 17. Arguments
Argument Type Description

client-id

String

Client ID (TA_CLIENTID), as returned by the Tuxedo.Clients list; case-insensitive

Tuxedo.Client.State(client-id), EnduroX.Client.State(client-id)

State of the client (TA_STATE of class T_CLIENT).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 18. Arguments
Argument Type Description

client-id

String

Client ID (TA_CLIENTID), as returned by the Tuxedo.Clients list; case-insensitive

Queue Metrics

Tuxedo.Queue.Machine(queue), EnduroX.Queue.Machine(queue)

Logical machine ID of the queue (TA_LMID).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 19. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Tuxedo.Queue.RequestsCurrent(queue), EnduroX.Queue.RequestsCurrent(queue)

Number of requests currently queued (TA_NQUEUED). The metric is registered with data type String, but the value is an integer.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 20. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Tuxedo.Queue.RequestsTotal(queue)

Total number of requests queued (TA_TOTNQUEUED). The metric is registered with data type String, but the value is an integer.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 21. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Tuxedo.Queue.Server(queue)

Executable name of the server that reads the queue (TA_SERVERNAME without the directory).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 22. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Tuxedo.Queue.ServerCount(queue)

Number of servers reading the queue (TA_SERVERCNT). The metric is registered with data type String, but the value is an integer.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 23. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Tuxedo.Queue.State(queue), EnduroX.Queue.State(queue)

State of the queue (TA_STATE of class T_QUEUE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 24. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Tuxedo.Queue.WorkloadsCurrent(queue)

Workloads currently queued (TA_WKQUEUED). The metric is registered with data type String, but the value is an integer.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 25. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Tuxedo.Queue.WorkloadsTotal(queue)

Total workloads queued (TA_TOTWKQUEUED). The metric is registered with data type String, but the value is an integer.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 26. Arguments
Argument Type Description

queue

String

Queue name (TA_RQADDR), as returned by the Tuxedo.Queues list, or the executable name of a server; case-insensitive. A queue name is looked up first; if no queue has that name, the values of all queues served by servers with that executable name are summed

Server Metrics

Tuxedo.Server.ActiveRequests(group, base-id)

Number of requests currently being processed, summed over all instances of the server (TA_CURREQ).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 27. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.CommandLine(group, base-id)

Command line options of the server (TA_CLOPT). The value is taken from the first instance record that the application returns for the server.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 28. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.Group(group, base-id)

Server group name (TA_SRVGRP).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 29. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.Machine(group, base-id)

Logical machine ID of the server (TA_LMID). The value is taken from the first instance record that the application returns for the server.

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 30. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.MaxInstances(group, base-id)

Maximum number of server instances (TA_MAX).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 31. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.MinInstances(group, base-id)

Minimum number of server instances (TA_MIN).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 32. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.Name(group, base-id)

Executable name of the server (TA_SERVERNAME without the directory).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 33. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.ProcessedRequests(group, base-id)

Number of requests processed (TA_TOTREQC). Despite the metric name, the value is not summed over all instances: the metric returns the value of the single instance whose server ID equals the base server ID, the same value as Tuxedo.ServerInstance.ProcessedRequests(group, base-id). The PROCESSED_REQUESTS column of the Tuxedo.Servers table contains the sum over all instances.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 34. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.ProcessedWorkloads(group, base-id)

Workloads processed (TA_TOTWORKL). Despite the metric name, the value is not summed over all instances: the metric returns the value of the single instance whose server ID equals the base server ID, the same value as Tuxedo.ServerInstance.ProcessedWorkloads(group, base-id). The PROCESSED_WORKLOADS column of the Tuxedo.Servers table contains the sum over all instances.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 35. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Tuxedo.Server.RunningInstances(group, base-id)

Number of server instances in state ACTIVE.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 36. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

base-id

Integer

Base server ID (TA_BASESRVID)

Server Instance Metrics

Tuxedo.ServerInstance.ActiveRequests(group, server-id)

Number of requests the instance is currently processing (TA_CURREQ).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 37. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.BaseID(group, server-id)

Base server ID of the server the instance belongs to (TA_BASESRVID).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 38. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.CommandLine(group, server-id), EnduroX.ServerInstance.CommandLine(group, server-id)

Command line options of the instance (TA_CLOPT).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 39. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.CurrentService(group, server-id)

Service the instance is currently processing (TA_CURRSERVICE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 40. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.Generation(group, server-id), EnduroX.ServerInstance.Generation(group, server-id)

Generation of the instance (TA_GENERATION).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 41. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.Group(group, server-id)

Server group name (TA_SRVGRP).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 42. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.Machine(group, server-id), EnduroX.ServerInstance.Machine(group, server-id)

Logical machine ID of the instance (TA_LMID).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 43. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.Name(group, server-id), EnduroX.ServerInstance.Name(group, server-id)

Executable name of the server (TA_SERVERNAME without the directory).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 44. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.PID(group, server-id), EnduroX.ServerInstance.PID(group, server-id)

Process ID of the instance (TA_PID).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 45. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.ProcessedRequests(group, server-id)

Number of requests processed by the instance (TA_TOTREQC).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 46. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.ProcessedWorkloads(group, server-id)

Workloads processed by the instance (TA_TOTWORKL).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 47. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Tuxedo.ServerInstance.State(group, server-id), EnduroX.ServerInstance.State(group, server-id)

State of the instance (TA_STATE of class T_SERVER).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 48. Arguments
Argument Type Description

group

Integer

Server group number (TA_GRPNO)

server-id

Integer

Server ID of the instance (TA_SRVID)

Service Metrics

Tuxedo.Service.Load(service)

Load of the service (TA_LOAD).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 49. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME), as returned by the Tuxedo.Services list; case-insensitive

Tuxedo.Service.Priority(service)

Priority of the service (TA_PRIO).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 50. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME), as returned by the Tuxedo.Services list; case-insensitive

Tuxedo.Service.RoutingName(service)

Routing criteria name of the service (TA_ROUTINGNAME).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 51. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME), as returned by the Tuxedo.Services list; case-insensitive

Tuxedo.Service.State(service), EnduroX.Service.State(service)

State of the service (TA_STATE of class T_SERVICE).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 52. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME), as returned by the Tuxedo.Services list; case-insensitive

Service Group Metrics

Tuxedo.ServiceGroup.CompletedRequests(service, group[, lmid]), EnduroX.ServiceGroup.CompletedRequests(service, group[, lmid])

Number of completed requests (TA_NCOMPLETED).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 53. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.FailedRequests(service, group[, lmid]), EnduroX.ServiceGroup.FailedRequests(service, group[, lmid])

Number of failed requests (TA_TOTSFAILNUM). Only the Enduro/X build returns a value. The Tuxedo build registers the metric, but every request returns the error not supported.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 54. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.LastExecutionTime(service, group[, lmid]), EnduroX.ServiceGroup.LastExecutionTime(service, group[, lmid])

Execution time of the last request, in microseconds (TA_LASTEXECTIMEUSEC). Only the Enduro/X build returns a value. The Tuxedo build registers the metric, but every request returns the error not supported.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 55. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.Load(service, group[, lmid])

Load of the service in the server group (TA_LOAD).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 56. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.MaxExecutionTime(service, group[, lmid]), EnduroX.ServiceGroup.MaxExecutionTime(service, group[, lmid])

Longest request execution time, in microseconds (TA_MAXEXECTIMEUSEC). Only the Enduro/X build returns a value. The Tuxedo build registers the metric, but every request returns the error not supported.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 57. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.MinExecutionTime(service, group[, lmid]), EnduroX.ServiceGroup.MinExecutionTime(service, group[, lmid])

Shortest request execution time, in microseconds (TA_MINEXECTIMEUSEC). Only the Enduro/X build returns a value. The Tuxedo build registers the metric, but every request returns the error not supported.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 58. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.Priority(service, group[, lmid])

Priority of the service in the server group (TA_PRIO).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 59. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.QueuedRequests(service, group[, lmid])

Number of requests currently queued (TA_NQUEUED).

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 60. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.RequestAddress(service, group[, lmid])

Request queue name of the servers offering the service (TA_RQADDR).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 61. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.RoutingName(service, group[, lmid])

Routing criteria name (TA_ROUTINGNAME).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo build only)

Table 62. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.State(service, group[, lmid]), EnduroX.ServiceGroup.State(service, group[, lmid])

State of the service in the server group (TA_STATE of class T_SVCGRP).

Data Type

String

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 63. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Tuxedo.ServiceGroup.SuccessfulRequests(service, group[, lmid]), EnduroX.ServiceGroup.SuccessfulRequests(service, group[, lmid])

Number of successfully completed requests (TA_TOTSUCCNUM). Only the Enduro/X build returns a value. The Tuxedo build registers the metric, but every request returns the error not supported.

Data Type

Integer

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 64. Arguments
Argument Type Description

service

String

Service name (TA_SERVICENAME); case-insensitive

group

String

Server group name (TA_SRVGRP); case-insensitive

lmid

String

Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see Tuxedo.LocalMachineId)

Lists

Both builds provide all lists, under the names Tuxedo.<name> and EnduroX.<name>.

Tuxedo.Clients, EnduroX.Clients (List)

Client IDs (TA_CLIENTID) of the clients. With machine filtering active, only clients on the local machine.

Data Type

List

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Machines, EnduroX.Machines (List)

Logical machine IDs (LMID) of all machines of the application.

Data Type

List

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Queues, EnduroX.Queues (List)

Names (TA_RQADDR) of the queues. With machine filtering active, only queues on the local machine.

Data Type

List

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.ServerInstances, EnduroX.ServerInstances (List)

Server instances in group,server-id form (server group number and server ID), ready to use as the argument of the Tuxedo.ServerInstance.* metrics. With machine filtering active, only instances on the local machine.

Data Type

List

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Servers, EnduroX.Servers (List)

Servers in group,base-id form (server group number and base server ID), ready to use as the argument of the Tuxedo.Server.* metrics. With machine filtering active, only servers on the local machine.

Data Type

List

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.ServiceGroups, EnduroX.ServiceGroups (List)

Service groups in service,group,lmid form (service name, server group name, logical machine ID), ready to use as the argument of the Tuxedo.ServiceGroup.* metrics. With machine filtering active, only service groups on the local machine.

Data Type

List

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tuxedo.Services, EnduroX.Services (List)

Names of all services of the application (TA_SERVICENAME).

Data Type

List

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Tables

Both builds provide all tables, under the names Tuxedo.<name> and EnduroX.<name>, with the same columns, except the Enduro/X-only columns of the service group table.

Tuxedo.Clients, EnduroX.Clients (Table)

Clients of the application (class T_CLIENT), one row per client. With machine filtering active, only clients on the local machine.

Data Type

Table

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 65. Columns
Column Type Description

ID

String

Client ID (TA_CLIENTID), instance column

NAME

String

Client name (TA_CLTNAME)

MACHINE

String

Logical machine ID (TA_LMID)

STATE

String

State (TA_STATE)

GROUP

String

Server group (TA_SRVGRP)

USERNAME

String

User name (TA_USRNAME)

IDLE_TIME

Integer

Idle time (TA_IDLETIME)

PID

Integer

Process ID (TA_PID)

ACTIVE_REQUESTS

Integer

Active requests (TA_CURREQ)

ACTIVE_CONV

Integer

Active conversations (TA_CURCONV)

CONV_COUNT

Integer

Conversations (TA_NUMCONV)

DEQUEUE_COUNT

Integer

Dequeue operations (TA_NUMDEQUEUE)

ENQUEUE_COUNT

Integer

Enqueue operations (TA_NUMENQUEUE)

POST_COUNT

Integer

Posts (TA_NUMPOST)

REQUEST_COUNT

Integer

Requests (TA_NUMREQ)

SUBSCR_COUNT

Integer

Subscriptions (TA_NUMSUBSCRIBE)

TRAN_COUNT

Integer

Transactions (TA_NUMTRAN)

WSCLIENT

String

Workstation client flag (TA_WSC)

WSCID

String

Workstation handler client ID (TA_WSHCLIENTID)

NETADDR

String

Network address (TA_NADDR)

ENCBITS

Integer

Encryption bits (TA_CURENCRYPTBITS)

Tuxedo.Machines, EnduroX.Machines (Table)

Machines of the application (class T_MACHINE), one row per machine. The machine list is not filtered by machine.

Data Type

Table

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 66. Columns
Column Type Description

ID

String

Logical machine ID (TA_LMID), instance column

PMID

String

Physical machine ID (TA_PMID)

TYPE

String

Machine type (TA_TYPE)

STATE

String

State (TA_STATE)

ROLE

String

Role (TA_ROLE)

BRIDGE

String

Bridge device (TA_BRIDGE)

SW_REL

String

Software release (TA_SWRELEASE)

ACCESSERS

Integer

Current accessers (TA_CURACCESSERS)

CLIENTS

Integer

Current clients (TA_CURCLIENTS)

WS_CLIENTS

Integer

Current workstation clients (TA_CURWSCLIENTS)

CONVERSATIONS

Integer

Current conversations (TA_CURCONV)

LOAD

Integer

Current load (TA_CURRLOAD)

WK_PROCESSED

Integer

Workloads processed (TA_WKCOMPLETED)

WK_INITIATED

Integer

Workloads initiated (TA_WKINITIATED)

TUXCONFIG

String

Configuration file (TA_TUXCONFIG)

TUXDIR

String

Product installation directory (TA_TUXDIR)

APPDIR

String

Application directory (TA_APPDIR)

ENV_FILE

String

Environment file (TA_ENVFILE)

TLOG_DEVICE

String

Transaction log device (TA_TLOGDEVICE)

TLOG_NAME

String

Transaction log name (TA_TLOGNAME)

Tuxedo.Queues, EnduroX.Queues (Table)

Queues of the application (class T_QUEUE), one row per queue name. Records with the same queue name (on different machines) are merged into one row: the counters are summed, the other columns come from the first record. With machine filtering active, only queues on the local machine.

Data Type

Table

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 67. Columns
Column Type Description

NAME

String

Queue name (TA_RQADDR), instance column

MACHINE

String

Logical machine ID (TA_LMID)

SERVER

String

Executable name of the server (TA_SERVERNAME without the directory)

STATE

String

State (TA_STATE)

SRV_COUNT

Integer

Number of servers (TA_SERVERCNT)

RQ_TOTAL

Integer

Total requests queued (TA_TOTNQUEUED)

RQ_CURRENT

Integer

Requests currently queued (TA_NQUEUED)

WK_TOTAL

Integer

Total workloads queued (TA_TOTWKQUEUED)

WK_CURRENT

Integer

Workloads currently queued (TA_WKQUEUED)

Tuxedo.ServerInstances, EnduroX.ServerInstances (Table)

Server instances (class T_SERVER), one row per instance. With machine filtering active, only instances on the local machine.

Data Type

Table

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 68. Columns
Column Type Description

GROUP_ID

Integer

Server group number (TA_GRPNO), instance column

ID

Integer

Server ID (TA_SRVID), instance column

BASE_ID

Integer

Base server ID (TA_BASESRVID)

NAME

String

Executable name (TA_SERVERNAME without the directory)

GROUP_NAME

String

Server group name (TA_SRVGRP)

STATE

String

State (TA_STATE)

RQ_ADDR

String

Request queue name (TA_RQADDR)

LMID

String

Logical machine ID (TA_LMID)

PID

Integer

Process ID (TA_PID)

GENERATION

Integer

Generation (TA_GENERATION)

THREADS

Integer

Current dispatch threads (TA_CURDISPATCHTHREADS)

THREADS_MIN

Integer

Minimum dispatch threads (TA_MINDISPATCHTHREADS)

THREADS_MAX

Integer

Maximum dispatch threads (TA_MAXDISPATCHTHREADS)

ACTIVE_REQUESTS

Integer

Active requests (TA_CURREQ)

CURR_SERVICE

String

Current service (TA_CURRSERVICE)

TRAN_LEVEL

Integer

Transaction level (TA_TRANLEV)

PROCESSED_REQUESTS

Integer

Processed requests (TA_TOTREQC)

PROCESSED_WORKLOADS

Integer

Processed workloads (TA_TOTWORKL)

CONVERSATIONS

Integer

Conversations (TA_NUMCONV)

DEQUEUE_COUNT

Integer

Dequeue operations (TA_NUMDEQUEUE)

ENQUEUE_COUNT

Integer

Enqueue operations (TA_NUMENQUEUE)

POSTS

Integer

Posts (TA_NUMPOST)

INITIATED_REQUESTS

Integer

Initiated requests (TA_NUMREQ)

SUBSCRIPTIONS

Integer

Subscriptions (TA_NUMSUBSCRIBE)

TRANSACTIONS

Integer

Transactions (TA_NUMTRAN)

START_TIME

Integer

Start time (TA_TIMESTART)

RESTART_TIME

Integer

Restart time (TA_TIMERESTART)

ENV_FILE

String

Environment file (TA_ENVFILE)

CMDLINE

String

Command line options (TA_CLOPT)

Tuxedo.Servers, EnduroX.Servers (Table)

Servers (class T_SERVER), one row per server: all instances with the same server group number and base server ID. Counters are summed over the instances; NAME, GROUP_NAME, MIN, MAX, LMID, THREADS_MIN, THREADS_MAX, ENV_FILE, and CMDLINE come from the first instance record. With machine filtering active, only servers on the local machine.

Data Type

Table

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 69. Columns
Column Type Description

GROUP_ID

Integer

Server group number (TA_GRPNO), instance column

BASE_ID

Integer

Base server ID (TA_BASESRVID), instance column

NAME

String

Executable name (TA_SERVERNAME without the directory)

GROUP_NAME

String

Server group name (TA_SRVGRP)

MIN

Integer

Minimum instances (TA_MIN)

MAX

Integer

Maximum instances (TA_MAX)

RUNNING

Integer

Instances in state ACTIVE

LMID

String

Logical machine ID (TA_LMID)

THREADS

Integer

Current dispatch threads, sum (TA_CURDISPATCHTHREADS)

THREADS_MIN

Integer

Minimum dispatch threads (TA_MINDISPATCHTHREADS)

THREADS_MAX

Integer

Maximum dispatch threads (TA_MAXDISPATCHTHREADS)

ACTIVE_REQUESTS

Integer

Active requests, sum (TA_CURREQ)

PROCESSED_REQUESTS

Integer

Processed requests, sum (TA_TOTREQC)

PROCESSED_WORKLOADS

Integer

Processed workloads, sum (TA_TOTWORKL)

CONVERSATIONS

Integer

Conversations, sum (TA_NUMCONV)

DEQUEUE_COUNT

Integer

Dequeue operations, sum (TA_NUMDEQUEUE)

ENQUEUE_COUNT

Integer

Enqueue operations, sum (TA_NUMENQUEUE)

POSTS

Integer

Posts, sum (TA_NUMPOST)

INITIATED_REQUESTS

Integer

Initiated requests, sum (TA_NUMREQ)

SUBSCRIPTIONS

Integer

Subscriptions, sum (TA_NUMSUBSCRIBE)

TRANSACTIONS

Integer

Transactions, sum (TA_NUMTRAN)

ENV_FILE

String

Environment file (TA_ENVFILE)

CMDLINE

String

Command line options (TA_CLOPT)

Tuxedo.ServiceGroups, EnduroX.ServiceGroups (Table)

Service groups (class T_SVCGRP): one row per service, server group, and machine. With machine filtering active, only service groups on the local machine.

Data Type

Table

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 70. Columns
Column Type Description

SVCNAME

String

Service name (TA_SERVICENAME), instance column

SRVGROUP

String

Server group name (TA_SRVGRP), instance column

LMID

String

Logical machine ID (TA_LMID), instance column

GROUPNO

Integer

Server group number (TA_GRPNO)

RQADDR

String

Request queue name (TA_RQADDR)

STATE

String

State (TA_STATE)

RT_NAME

String

Routing criteria name (TA_ROUTINGNAME)

LOAD

Integer

Load (TA_LOAD)

PRIO

Integer

Priority (TA_PRIO)

COMPLETED

Integer

Completed requests (TA_NCOMPLETED)

QUEUED

Integer

Queued requests (TA_NQUEUED)

SUCCESSFUL

Integer

Successful requests (TA_TOTSUCCNUM); Enduro/X build only

FAILED

Integer

Failed requests (TA_TOTSFAILNUM); Enduro/X build only

EXECTIME_LAST

Integer

Execution time of the last request in microseconds (TA_LASTEXECTIMEUSEC); Enduro/X build only

EXECTIME_MAX

Integer

Longest execution time in microseconds (TA_MAXEXECTIMEUSEC); Enduro/X build only

EXECTIME_MIN

Integer

Shortest execution time in microseconds (TA_MINEXECTIMEUSEC); Enduro/X build only

Tuxedo.Services, EnduroX.Services (Table)

Services of the application (class T_SERVICE), one row per service. The service list is not filtered by machine.

Data Type

Table

Platforms

UNIX-like systems (Oracle Tuxedo and Enduro/X builds)

Table 71. Columns
Column Type Description

NAME

String

Service name (TA_SERVICENAME), instance column

STATE

String

State (TA_STATE)

RT_NAME

String

Routing criteria name (TA_ROUTINGNAME)

LOAD

Integer

Load (TA_LOAD)

PRIO

Integer

Priority (TA_PRIO)