Tracing Objects
You can set trace counters on multiple objects, and all results are logged to mtx_debug.log.
You can set trace counters on the following objects using the
trace_object.py script:
- MtxAccountObject
- MtxDeviceObject
- MtxGroupObject
- MtxSubscriberObject
- MtxUserObject
When tracing is enabled, an LM_TRACE message is logged with the
ObjectId
of the traced object and the current TraceCounter
value allowing you to correlate
messages (RelatedMsgId
) using the ObjectId
across different logical flow categories, task-chain executions, and processing servers. For example, after
running the following command: trace_object.py -t ObjectId 0:1:5:1 0:1:5:2 --traceCounter 10
The log file includes information for both
objects:
LM_INFO 25868|25976 2021-05-25 10:56:13.151419 [charging_server_1:1:1:1(5230.82827)] MDC-8000658b894a76cc | SubManFunctions::traceDatabaseObject: Setting TraceCounter=10 on MtxMobileDeviceObject: OID=0:1:5:1
...
LM_INFO 25868|25978 2021-05-25 10:56:13.156675 [charging_server_1:1:1:1(5230.82827)] MDC-8001658b894a8bea | SubManFunctions::traceDatabaseObject: Setting TraceCounter=10 on MtxLoginDeviceObject: OID=0:1:5:2
For information about the trace_object.py script, see the discussion about trace_object.py in the appendixes.
Note: You can run this script on a maintenance VM and point it to the MDC port of the Traffic Routing Agent (TRA) in a Kubernetes cluster.
The
TraceCounter
field is applied to the specified objects on all
servers on active and standby engines. The default TraceCounter
value
(10) is set in mtx_config.xml. You can change this value in the
/opt/mtx/custom/mtx_config_base_xml_sed.extra file. For
example:s@default_object_trace_counter>.*<@default_object_trace_counter>20<@