3.3.4.4.1.2 Check Commonly Used Metrics
After get the necessary information on the monitoring stage, message type and process location, the next step is to check the common used metrics also carried in the FML32 buffer. The metrics will be available depending on the conditions mentioned previously.
The following table lists the commonly used metrics
Table 3-10 Commonly Used Metrics
| Field Name | Type | Description | Stage |
|---|---|---|---|
TA_MONCORRID
|
string | The correlation ID of this monitored call path | All |
TA_MONMSGSIZE
|
long | The message size of current message | All |
TA_MONMSGQUEUED
|
long | How many message queued on the server request IPC queue | Request Message
Q2ME |
TA_MONSTARTTIMESEC
|
long | The second part of timestamp when this call path monitoring is initiated. It is the number of seconds since epoch. | All |
TA_MONSTARTTIMEUSEC
|
long | The microsecond part of the startup timestamp. It is always with TA_MONSTARTUTIMESEC to provide a more fine-grained time measurement. | All |
TA_MONLASTTIMESEC
|
long | The second part of timestamp when the monitored message entering/leaving a transport. It is the number of seconds since epoch. A transport is the way carrying message, such as IPC queue and network. A typical usage is,
|
All |
TA_MONLASTTIMEUSEC
|
long | The microsecond part of the last time timestamp. It is always with TA_MONLASTTIMESEC to provide a more fin-grained time measurement. | All |
TA_MONLGTRID
|
string | The GTRID of current monitoring points if the call path involved in transaction. | Monitoring points involved transaction |
TA_MONCLTADDR
|
string | The remote client address. If the monitoring is started from an Oracle Tuxedo workstation client, WSH, JSH or GWWS, TSAM Plus framework will attach the client ip address and port number to call path information propagation. The format is //ip address:port. | All |
TA_MONDEPTH
|
short | The call path depth. A hop from one service to another is deemed the depth increased one. The start value at the initiator is 0.The detail can be referred at TSAM Plus User Guide. | All |
TA_MONERRNO
|
long | The error number set by Oracle Tuxedo infrastructure. | Reply Message |
TA_MONURCODE
|
long | The urcode of tpreturn. | Reply Message |
TA_MONSVCNAME
|
string | The service name of current monitoring points involved. For request message, it is the target service name and for reply message, it is the service which returns the reply. | All |
TA_MONHOSTSVC
|
string | The service name of current service routine | Monitoring points in a application server. |
TA_MONCALLFLAG
|
long | The call flags set in tpcall/tpacall | Request Message
ME2Q STMO |
TA_MONCALLMODE
|
short | The call type, 1 - tpacall, 2 - tpcall, 3 - tpforward | Request Message
ME2Q STMO |
TA_MONQID
|
string | The request queue id of server which provides current service. Its format is “physical queue key - Oracle Tuxedo logic queue name”. For example, 14444547-00004.00018 | Request Message
Q2ME |
TA_MONLDOM
|
string | The local domain configuration. Its format is ldom:domainid. For example DOM1:FINANCE. The detail information of the “LDOM” and “DOMAINID” can be referred Oracle Tuxedo Manual of DMCONFIG. | ME2NET NET2ME |
TA_MONRDOM |
string | The remote domain configuration. Its format is same with TA_MONLDOM but the values are for remote domain. |
ME2NET NET2ME |
TA_MONWSENDPOINT |
string | The web service end point URL of GWWS. |
Reply Message ME2Q |
TA_MONCPUTIME |
long | CPU time used for service execution. | Reply Message ME2Q |
Note:
For some self-describe buffer types, such as STRING, the size might be zero.Parent topic: Call Path Monitoring Plug-in Routine