Oracle Tuxedo and Enduro/X Monitoring
The tuxedo subagent monitors an Oracle Tuxedo or Enduro/X application from the NetXMS agent on one of the application’s machines.
It reads the state and statistics of the domain, machines, clients, queues, servers, services, and service groups, and provides them as metrics, lists, and tables.
Enduro/X is an open-source middleware compatible with the Oracle Tuxedo ATMI programming interface.
The subagent uses the same ATMI calls, FML32 buffers, and .TMIB administration requests with both products; which product it works with is decided when it is built.
How It Works
Tuxedo and Enduro/X Builds
The subagent is compiled against the libraries of one product:
-
Oracle Tuxedo build — linked with the Tuxedo libraries. The metrics, lists, and tables have names that start with
Tuxedo.. -
Enduro/X build — linked with the Enduro/X libraries. The names start with
EnduroX.. The Enduro/X build provides fewer metrics (31 instead of 74), but only the Enduro/X build returns values for the service group success and failure counters and execution times. Both builds provide the same lists and tables.
The module file is tuxedo.nsm in both cases.
The metric reference in Agent Metrics shows for each metric whether the Enduro/X build provides it.
Data Collection
The subagent does not query the application when a metric is requested. A background thread reads all information at a fixed interval and keeps it in memory; metric requests return the values from the last read.
At every polling interval (parameter PollingInterval, default 10 seconds), the thread:
-
Joins the application as a native ATMI client with
tpinit(). The subagent passes noTPINITbuffer, so it uses no user name, client name, or application password. -
Sends
GETrequests in FML32 buffers to the.TMIBservice for the MIB classesT_CLIENT,T_DOMAIN,T_MACHINE,T_QUEUE,T_SERVER,T_SVCGRP, andT_SERVICE, in this order. When the application returns more records than fit in one reply, the thread reads the rest withGETNEXTrequests. -
Replaces the stored information of each class with the new records.
-
Leaves the application with
tpterm().
The first read takes place one polling interval after the agent starts; until then, all metrics return an error.
If tpinit() fails, the subagent discards the cached class information, and metrics based on that data return an error until a later read succeeds.
Tuxedo.LocalMachineId keeps its value once the local machine ID has been learned, even when later reads fail.
If the request for one class fails, only the information of that class is discarded.
| MIB class | Metrics | Machine filter | QueryLocalData bit |
|---|---|---|---|
|
|
No |
— |
|
|
No |
|
|
|
Yes |
— |
|
|
Yes |
|
|
|
Yes |
|
|
|
Yes |
|
|
|
No |
— |
The Machine filter column shows which classes are limited to the agent host’s machine when machine filtering is active (see Local Machine ID and Filtering).
The QueryLocalData parameter is a bit mask.
For each class with a bit in the table, the subagent sets the MIB_LOCAL flag in the TA_FLAGS field of the request when the bit is set.
See the MIB(5) reference in the Oracle Tuxedo documentation for the effect of this flag.
By default, all bits are set (15).
Service group requests use bit 4, the same bit as server requests.
Bit 8 is logged as the service group setting at agent startup, but it has no effect.
|
Local Machine ID and Filtering
A Tuxedo or Enduro/X application can span several machines, each with a logical machine ID (LMID) and a physical machine ID (PMID).
After each read of the machine list, as long as the local machine ID is not known yet, the subagent looks for the machine whose physical machine ID is equal to the host name of the agent host (the node name from uname on UNIX-like systems, the computer name on Windows; compared case-insensitively).
The logical machine ID of that machine becomes the local machine ID.
The subagent keeps it until the agent restarts and does not check it again.
The local machine ID is used in three places:
-
Machine filtering — when
FilterByLocalMachineIdis enabled (the default), the requests for clients, queues, servers, and service groups ask only for objects on the local machine. Disable it to monitor the objects of all machines from one agent. Machines, services, and the domain information are never filtered. -
Service group metrics — when the machine argument of a
ServiceGroup.*metric is omitted, the local machine ID is used. -
Tuxedo.LocalMachineId— returns it.
If no physical machine ID matches the host name, for example because the application configuration uses a fully qualified name and the host name is short, there is no local machine ID.
The subagent then does not filter, Tuxedo.LocalMachineId returns an error, and the service group metrics need the machine argument.
Within each read, the client list is read before the machine list. The first client list after agent start is therefore not filtered.
Requirements
-
Build from source on UNIX-like systems —
tuxedo.nsmis not included in the NetXMS agent packages. Build the agent from source on the application machine, with the Tuxedo or Enduro/X development files installed (see Building the Subagent). The Windows agent installer (x64) and the server installer (x64) include an Oracle Tuxedo build oftuxedo.nsm; there is no Enduro/X build for Windows. -
Application machine — the agent connects as a native client, so it must run on a machine of the application, with access to the application’s configuration. The application must be booted, and its
.TMIBservice must be available. -
No client authentication — because the subagent passes no user name or password to
tpinit(), it cannot join an application that requires client authentication. -
Environment — the agent process needs the product’s client environment:
-
Oracle Tuxedo build: the
TUXCONFIGenvironment variable, plus the other variables the Tuxedo libraries need (for exampleTUXDIR). The subagent refuses to load whenTUXCONFIGis not set. -
Enduro/X build: at least one of the environment variables
NDRX_CONFIG,NDRX_CCONFIG,NDRX_CCONFIG1…NDRX_CCONFIG5. The subagent refuses to load when none of them is set.
-
-
Libraries — the dynamic linker must find the product’s shared libraries when the agent loads the subagent:
libtuxandlibfml32for Oracle Tuxedo (on AIX alsolibengine, if present),libatmi,libubf, andlibnstdfor Enduro/X. The build does not record the library directory in the module, so add it to the system’s linker configuration or toLD_LIBRARY_PATHin the environment of the agent service.
You can set the product’s environment variables in the [ENV] section of nxagentd.conf or in an environment file loaded with EnvironmentFile (see Environment Variables).
The agent applies both before it loads subagents.
LD_LIBRARY_PATH is different: the dynamic linker reads it only when a process starts, so set it in the agent service definition instead (for example, with Environment= in a systemd unit).
Building the Subagent
Add the --with-tuxedo option when you configure the agent build (see Building the Agent from Source):
./configure --enable-release-build --with-agent --with-tuxedo=/opt/tuxedo
make
sudo make install
The directory given to --with-tuxedo is the installation directory of Oracle Tuxedo or Enduro/X; the build uses its include and lib subdirectories.
Without a directory, the compiler and linker search their default paths.
The build checks for the Tuxedo library libtux first.
If it finds it, it produces the Oracle Tuxedo build; otherwise it looks for the Enduro/X library libatmi and produces the Enduro/X build.
If neither library is found, configure stops with the error libtux or libatmi is required for Tuxedo support.
Enabling Tuxedo Monitoring
-
Make sure the agent process has the environment described in Requirements.
-
Load the subagent in
nxagentd.conf:SubAgent = tuxedo -
Optionally, change the subagent settings in the
[Tuxedo]section. -
Restart the agent.
-
Check that the subagent is loaded: the
Agent.SubAgentListlist containsTUXEDO. After one polling interval, query a metric, for examplenxget <agent-address> Tuxedo.Domain.State.
| Parameter | Default | Description |
|---|---|---|
|
|
Interval in seconds between reads of the application information. |
|
|
Limit client, queue, server, and service group information to the local machine (see Local Machine ID and Filtering). |
|
|
Bit mask that selects the classes for which the |
The subagent reads these parameters only at agent startup.
Example configuration for an Oracle Tuxedo application:
SubAgent = tuxedo
[ENV]
TUXCONFIG = /home/tuxapp/tuxconfig
TUXDIR = /opt/tuxedo
[Tuxedo]
PollingInterval = 30
FilterByLocalMachineId = no
Collecting Data
Most metrics take the ID or name of an object as argument. The lists return valid arguments, so you can create DCIs with instance discovery: select the method Agent List with the matching list (see Instance Discovery Methods).
| List | Example DCI metric with {instance} |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Server, server instance, and service group list entries contain several arguments separated by commas (for example 1,10 for server group 1, base server ID 10), so {instance} expands to the complete argument list.
The tables contain the same information, with more attributes, for table DCIs.
In the Enduro/X build, replace the Tuxedo. prefix with EnduroX..
Reference
Agent Metrics
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), Windows (Oracle Tuxedo build) |
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 and Windows (Oracle Tuxedo build only) |
Tuxedo.Domain.Model
Configuration model of the application (TA_MODEL).
Data Type |
String |
Platforms |
UNIX-like systems and Windows (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), Windows (Oracle Tuxedo build) |
Tuxedo.Domain.Routes
Current number of bulletin board routing table entries (TA_CURDRT).
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (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), Windows (Oracle Tuxedo build) |
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), Windows (Oracle Tuxedo build) |
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), Windows (Oracle Tuxedo build) |
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 and Windows (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 and Windows (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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
lmid |
String |
Logical machine ID (LMID) of the machine, as returned by the |
Tuxedo.Machine.Bridge(lmid)
Bridge device of the machine (TA_BRIDGE).
Data Type |
String |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
lmid |
String |
Logical machine ID (LMID) of the machine, as returned by the |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
lmid |
String |
Logical machine ID (LMID) of the machine, as returned by the |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
lmid |
String |
Logical machine ID (LMID) of the machine, as returned by the |
Tuxedo.Machine.Load(lmid)
Current service load of the machine (TA_CURRLOAD).
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
lmid |
String |
Logical machine ID (LMID) of the machine, as returned by the |
Tuxedo.Machine.PhysicalID(lmid)
Physical machine ID (TA_PMID).
Data Type |
String |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
lmid |
String |
Logical machine ID (LMID) of the machine, as returned by the |
Tuxedo.Machine.Role(lmid)
Role of the machine in the application (TA_ROLE).
Data Type |
String |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
lmid |
String |
Logical machine ID (LMID) of the machine, as returned by the |
Tuxedo.Machine.SoftwareRelease(lmid)
Software release installed on the machine (TA_SWRELEASE).
Data Type |
String |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
lmid |
String |
Logical machine ID (LMID) of the machine, as returned by the |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
lmid |
String |
Logical machine ID (LMID) of the machine, as returned by the |
Tuxedo.Machine.Type(lmid)
Machine type (TA_TYPE).
Data Type |
String |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
lmid |
String |
Logical machine ID (LMID) of the machine, as returned by the |
Tuxedo.Machine.WorkloadsInitiated(lmid)
Workloads initiated on the machine (TA_WKINITIATED).
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
lmid |
String |
Logical machine ID (LMID) of the machine, as returned by the |
Tuxedo.Machine.WorkloadsProcessed(lmid)
Workloads processed on the machine (TA_WKCOMPLETED).
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
lmid |
String |
Logical machine ID (LMID) of the machine, as returned by the |
Tuxedo.Machine.WorkstationClients(lmid)
Number of workstation clients currently logged in on the machine (TA_CURWSCLIENTS).
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
lmid |
String |
Logical machine ID (LMID) of the machine, as returned by the |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
client-id |
String |
Client ID ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
client-id |
String |
Client ID ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
client-id |
String |
Client ID ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
client-id |
String |
Client ID ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
client-id |
String |
Client ID ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
queue |
String |
Queue name ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
queue |
String |
Queue name ( |
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 and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
queue |
String |
Queue name ( |
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 and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
queue |
String |
Queue name ( |
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 and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
queue |
String |
Queue name ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
queue |
String |
Queue name ( |
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 and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
queue |
String |
Queue name ( |
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 and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
queue |
String |
Queue name ( |
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 and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
base-id |
Integer |
Base server ID ( |
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 and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
base-id |
Integer |
Base server ID ( |
Tuxedo.Server.Group(group, base-id)
Server group name (TA_SRVGRP).
Data Type |
String |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
base-id |
Integer |
Base server ID ( |
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 and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
base-id |
Integer |
Base server ID ( |
Tuxedo.Server.MaxInstances(group, base-id)
Maximum number of server instances (TA_MAX).
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
base-id |
Integer |
Base server ID ( |
Tuxedo.Server.MinInstances(group, base-id)
Minimum number of server instances (TA_MIN).
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
base-id |
Integer |
Base server ID ( |
Tuxedo.Server.Name(group, base-id)
Executable name of the server (TA_SERVERNAME without the directory).
Data Type |
String |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
base-id |
Integer |
Base server ID ( |
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 and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
base-id |
Integer |
Base server ID ( |
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 and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
base-id |
Integer |
Base server ID ( |
Tuxedo.Server.RunningInstances(group, base-id)
Number of server instances in state ACTIVE.
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
base-id |
Integer |
Base server ID ( |
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 and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
server-id |
Integer |
Server ID of the instance ( |
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 and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
server-id |
Integer |
Server ID of the instance ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
server-id |
Integer |
Server ID of the instance ( |
Tuxedo.ServerInstance.CurrentService(group, server-id)
Service the instance is currently processing (TA_CURRSERVICE).
Data Type |
String |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
server-id |
Integer |
Server ID of the instance ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
server-id |
Integer |
Server ID of the instance ( |
Tuxedo.ServerInstance.Group(group, server-id)
Server group name (TA_SRVGRP).
Data Type |
String |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
server-id |
Integer |
Server ID of the instance ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
server-id |
Integer |
Server ID of the instance ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
server-id |
Integer |
Server ID of the instance ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
server-id |
Integer |
Server ID of the instance ( |
Tuxedo.ServerInstance.ProcessedRequests(group, server-id)
Number of requests processed by the instance (TA_TOTREQC).
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
server-id |
Integer |
Server ID of the instance ( |
Tuxedo.ServerInstance.ProcessedWorkloads(group, server-id)
Workloads processed by the instance (TA_TOTWORKL).
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
server-id |
Integer |
Server ID of the instance ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
group |
Integer |
Server group number ( |
server-id |
Integer |
Server ID of the instance ( |
Service Metrics
Tuxedo.Service.Load(service)
Load of the service (TA_LOAD).
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
Tuxedo.Service.Priority(service)
Priority of the service (TA_PRIO).
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
Tuxedo.Service.RoutingName(service)
Routing criteria name of the service (TA_ROUTINGNAME).
Data Type |
String |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
group |
String |
Server group name ( |
lmid |
String |
Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
group |
String |
Server group name ( |
lmid |
String |
Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
group |
String |
Server group name ( |
lmid |
String |
Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see |
Tuxedo.ServiceGroup.Load(service, group[, lmid])
Load of the service in the server group (TA_LOAD).
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
group |
String |
Server group name ( |
lmid |
String |
Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
group |
String |
Server group name ( |
lmid |
String |
Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
group |
String |
Server group name ( |
lmid |
String |
Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see |
Tuxedo.ServiceGroup.Priority(service, group[, lmid])
Priority of the service in the server group (TA_PRIO).
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
group |
String |
Server group name ( |
lmid |
String |
Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see |
Tuxedo.ServiceGroup.QueuedRequests(service, group[, lmid])
Number of requests currently queued (TA_NQUEUED).
Data Type |
Integer |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
group |
String |
Server group name ( |
lmid |
String |
Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see |
Tuxedo.ServiceGroup.RequestAddress(service, group[, lmid])
Request queue name of the servers offering the service (TA_RQADDR).
Data Type |
String |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
group |
String |
Server group name ( |
lmid |
String |
Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see |
Tuxedo.ServiceGroup.RoutingName(service, group[, lmid])
Routing criteria name (TA_ROUTINGNAME).
Data Type |
String |
Platforms |
UNIX-like systems and Windows (Oracle Tuxedo build only) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
group |
String |
Server group name ( |
lmid |
String |
Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
group |
String |
Server group name ( |
lmid |
String |
Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see |
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), Windows (Oracle Tuxedo build) |
| Argument | Type | Description |
|---|---|---|
service |
String |
Service name ( |
group |
String |
Server group name ( |
lmid |
String |
Logical machine ID (LMID) of the machine; case-insensitive. Optional: when empty or omitted, the local machine ID is used (see |
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), Windows (Oracle Tuxedo build) |
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), Windows (Oracle Tuxedo build) |
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), Windows (Oracle Tuxedo build) |
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), Windows (Oracle Tuxedo build) |
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), Windows (Oracle Tuxedo build) |
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), Windows (Oracle Tuxedo build) |
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), Windows (Oracle Tuxedo build) |
| Column | Type | Description |
|---|---|---|
ID |
String |
Client ID ( |
NAME |
String |
Client name ( |
MACHINE |
String |
Logical machine ID ( |
STATE |
String |
State ( |
GROUP |
String |
Server group ( |
USERNAME |
String |
User name ( |
IDLE_TIME |
Integer |
Idle time ( |
PID |
Integer |
Process ID ( |
ACTIVE_REQUESTS |
Integer |
Active requests ( |
ACTIVE_CONV |
Integer |
Active conversations ( |
CONV_COUNT |
Integer |
Conversations ( |
DEQUEUE_COUNT |
Integer |
Dequeue operations ( |
ENQUEUE_COUNT |
Integer |
Enqueue operations ( |
POST_COUNT |
Integer |
Posts ( |
REQUEST_COUNT |
Integer |
Requests ( |
SUBSCR_COUNT |
Integer |
Subscriptions ( |
TRAN_COUNT |
Integer |
Transactions ( |
WSCLIENT |
String |
Workstation client flag ( |
WSCID |
String |
Workstation handler client ID ( |
NETADDR |
String |
Network address ( |
ENCBITS |
Integer |
Encryption bits ( |
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), Windows (Oracle Tuxedo build) |
| Column | Type | Description |
|---|---|---|
ID |
String |
Logical machine ID ( |
PMID |
String |
Physical machine ID ( |
TYPE |
String |
Machine type ( |
STATE |
String |
State ( |
ROLE |
String |
Role ( |
BRIDGE |
String |
Bridge device ( |
SW_REL |
String |
Software release ( |
ACCESSERS |
Integer |
Current accessers ( |
CLIENTS |
Integer |
Current clients ( |
WS_CLIENTS |
Integer |
Current workstation clients ( |
CONVERSATIONS |
Integer |
Current conversations ( |
LOAD |
Integer |
Current load ( |
WK_PROCESSED |
Integer |
Workloads processed ( |
WK_INITIATED |
Integer |
Workloads initiated ( |
TUXCONFIG |
String |
Configuration file ( |
TUXDIR |
String |
Product installation directory ( |
APPDIR |
String |
Application directory ( |
ENV_FILE |
String |
Environment file ( |
TLOG_DEVICE |
String |
Transaction log device ( |
TLOG_NAME |
String |
Transaction log name ( |
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), Windows (Oracle Tuxedo build) |
| Column | Type | Description |
|---|---|---|
NAME |
String |
Queue name ( |
MACHINE |
String |
Logical machine ID ( |
SERVER |
String |
Executable name of the server ( |
STATE |
String |
State ( |
SRV_COUNT |
Integer |
Number of servers ( |
RQ_TOTAL |
Integer |
Total requests queued ( |
RQ_CURRENT |
Integer |
Requests currently queued ( |
WK_TOTAL |
Integer |
Total workloads queued ( |
WK_CURRENT |
Integer |
Workloads currently queued ( |
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), Windows (Oracle Tuxedo build) |
| Column | Type | Description |
|---|---|---|
GROUP_ID |
Integer |
Server group number ( |
ID |
Integer |
Server ID ( |
BASE_ID |
Integer |
Base server ID ( |
NAME |
String |
Executable name ( |
GROUP_NAME |
String |
Server group name ( |
STATE |
String |
State ( |
RQ_ADDR |
String |
Request queue name ( |
LMID |
String |
Logical machine ID ( |
PID |
Integer |
Process ID ( |
GENERATION |
Integer |
Generation ( |
THREADS |
Integer |
Current dispatch threads ( |
THREADS_MIN |
Integer |
Minimum dispatch threads ( |
THREADS_MAX |
Integer |
Maximum dispatch threads ( |
ACTIVE_REQUESTS |
Integer |
Active requests ( |
CURR_SERVICE |
String |
Current service ( |
TRAN_LEVEL |
Integer |
Transaction level ( |
PROCESSED_REQUESTS |
Integer |
Processed requests ( |
PROCESSED_WORKLOADS |
Integer |
Processed workloads ( |
CONVERSATIONS |
Integer |
Conversations ( |
DEQUEUE_COUNT |
Integer |
Dequeue operations ( |
ENQUEUE_COUNT |
Integer |
Enqueue operations ( |
POSTS |
Integer |
Posts ( |
INITIATED_REQUESTS |
Integer |
Initiated requests ( |
SUBSCRIPTIONS |
Integer |
Subscriptions ( |
TRANSACTIONS |
Integer |
Transactions ( |
START_TIME |
Integer |
Start time ( |
RESTART_TIME |
Integer |
Restart time ( |
ENV_FILE |
String |
Environment file ( |
CMDLINE |
String |
Command line options ( |
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), Windows (Oracle Tuxedo build) |
| Column | Type | Description |
|---|---|---|
GROUP_ID |
Integer |
Server group number ( |
BASE_ID |
Integer |
Base server ID ( |
NAME |
String |
Executable name ( |
GROUP_NAME |
String |
Server group name ( |
MIN |
Integer |
Minimum instances ( |
MAX |
Integer |
Maximum instances ( |
RUNNING |
Integer |
Instances in state |
LMID |
String |
Logical machine ID ( |
THREADS |
Integer |
Current dispatch threads, sum ( |
THREADS_MIN |
Integer |
Minimum dispatch threads ( |
THREADS_MAX |
Integer |
Maximum dispatch threads ( |
ACTIVE_REQUESTS |
Integer |
Active requests, sum ( |
PROCESSED_REQUESTS |
Integer |
Processed requests, sum ( |
PROCESSED_WORKLOADS |
Integer |
Processed workloads, sum ( |
CONVERSATIONS |
Integer |
Conversations, sum ( |
DEQUEUE_COUNT |
Integer |
Dequeue operations, sum ( |
ENQUEUE_COUNT |
Integer |
Enqueue operations, sum ( |
POSTS |
Integer |
Posts, sum ( |
INITIATED_REQUESTS |
Integer |
Initiated requests, sum ( |
SUBSCRIPTIONS |
Integer |
Subscriptions, sum ( |
TRANSACTIONS |
Integer |
Transactions, sum ( |
ENV_FILE |
String |
Environment file ( |
CMDLINE |
String |
Command line options ( |
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), Windows (Oracle Tuxedo build) |
| Column | Type | Description |
|---|---|---|
SVCNAME |
String |
Service name ( |
SRVGROUP |
String |
Server group name ( |
LMID |
String |
Logical machine ID ( |
GROUPNO |
Integer |
Server group number ( |
RQADDR |
String |
Request queue name ( |
STATE |
String |
State ( |
RT_NAME |
String |
Routing criteria name ( |
LOAD |
Integer |
Load ( |
PRIO |
Integer |
Priority ( |
COMPLETED |
Integer |
Completed requests ( |
QUEUED |
Integer |
Queued requests ( |
SUCCESSFUL |
Integer |
Successful requests ( |
FAILED |
Integer |
Failed requests ( |
EXECTIME_LAST |
Integer |
Execution time of the last request in microseconds ( |
EXECTIME_MAX |
Integer |
Longest execution time in microseconds ( |
EXECTIME_MIN |
Integer |
Shortest execution time in microseconds ( |
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), Windows (Oracle Tuxedo build) |
| Column | Type | Description |
|---|---|---|
NAME |
String |
Service name ( |
STATE |
String |
State ( |
RT_NAME |
String |
Routing criteria name ( |
LOAD |
Integer |
Load ( |
PRIO |
Integer |
Priority ( |
Troubleshooting
-
The subagent does not load — the agent log contains
TUXCONFIG environment variable not set(Oracle Tuxedo build) orEnduro/X environment is not configured(Enduro/X build). Set the variables described in Requirements. If the log reports that the module cannot be loaded, the dynamic linker cannot find the Tuxedo or Enduro/X libraries. -
All metrics return an error — the subagent cannot join the application or has not completed its first read. Check that the application is booted, that the environment variables point to it, and that the application does not require client authentication. The debug message
tpinit() call failedshows the reason reported by the product. -
Client, queue, server, or service group metrics return no such instance — with machine filtering active, only objects on the local machine are available. Check
Tuxedo.LocalMachineId, or setFilterByLocalMachineId = no. -
Tuxedo.LocalMachineIdreturns an error — no machine of the application has a physical machine ID equal to the host name of the agent host; compare thePMIDcolumn of theTuxedo.Machinestable with the output ofuname -n(hostnameon Windows).
To see details, enable the agent debug tag tuxedo with DebugTags in nxagentd.conf (see Diagnostics), for example DebugTags = tuxedo:3:
| Level | Messages |
|---|---|
1 |
Local machine ID found |
2 |
Configuration file or Enduro/X configuration in use, subagent shutdown |
3 |
Settings at startup, poller start with polling interval, failed |
Every failed tpinit() call is also logged at debug level 3 without a tag, so it appears with DebugLevel = 3.