Contents
1 Introduction
This document describes how to use and apply the Application Trace (AppTrace) in the MTAS. The document lists the MTAS process types and domains that are applicable for collecting trace information. AppTrace is a service available in the vDicos execution environment. AppTrace is used for tracing vDicos applications selectively and safely.
1.1 Prerequisites
It is assumed that users of this document are familiar with performing operations within the area for Operation and Maintenance (O&M), in general.
1.1.1 Documents
Information on how to use the AppTrace, the different states, levels, and commands can be found in AppTrace User Guide.
For information about how to troubleshoot the MTAS node, refer to MTAS Troubleshooting Guideline.
2 AppTrace
The AppTrace is a service available in the vDicos runtime environment. The main purpose of the AppTrace is to provide practical assistance in troubleshooting vDicos applications on live systems. By using the AppTrace, an AppTrace end user can gain insight into the current behavior of an application. An AppTrace end user is an Ericsson support personnel performing operation and service provisioning tasks in a live network. Operators are not considered AppTrace end users.
Use the AppTrace with caution, since the inherent problem with observing the behavior of a system by tracing is the consumed capacity of the tracing itself. If the cost is too high, it can interfere with the primary function of the system and at worst even cause system failure.
The traces end up in the console log. The console log is a two-file wrapping log writer that writes one log per processor.
Each AppTrace statement includes the following:
- Date
- Time
- Trace level
- Filename
- Line
- Forlop identity
- Processor name
- Process identity
- Process name
Abstract domains cannot be used in the AppTrace definition because they mask underlying concrete domains and generate empty lines in console logs.
For more information about how to configure the AppTrace, refer to AppTrace User Guide.
For more information about the Console Logs, refer to MTAS Logs.
3 AppTrace Use
This section describes how to use the AppTrace and the defined trace levels in the MTAS. The trace level must be set to the defined trace level+1 to include the trace level in the log, for example, for DEBUG (55), the trace level is set to 56.
- Note:
- Narrow down the trace domains when applying AppTrace for the MTAS. All trace domains must not be used at once and do not apply together with the vDicos or other application traces.
There is also a possibility to use preconfigured trace profiles. For more information about handling of trace profiles, refer to section Trace Profiles in MTAS Troubleshooting Guideline.
3.1 Trace Levels for Live System
Trace levels used in the MTAS for live systems are listed in ascending order in the following table:
- Note:
- It is possible to use FORLOP (56) to trace a single user in a live system providing the load does not exceed 50%.
|
Trace Level |
Description |
|---|---|
|
CRITICAL (7) |
Applied to report when a service or an interface is not working, for example, owing to a faulty configuration, DNS resolution problems, or unsupported protocol versions. |
|
CONFIG (20) |
All changes of configuration data are reported in this trace level. Normally, only one trace per configuration change is reported. |
|
MAJOR (24) |
Used to report network tracing of SIP messages for a specific subscriber in the live network. |
|
WARNING (36) |
Traces to be generated whenever an unexpected event internally in the node is detected and no assert or error is to be called. This scenario occurs when source of the fault is unclear. It could be owing to node internal errors or external misbehavior (transport errors, and so on), therefore assert is not appropriate to use. |
|
PROTOCOL_ERROR (38) |
Traces to be generated whenever a message received on an interface is erroneous or received in unexpected state. |
|
MINOR (39) or MINOR_LOW (40) |
Two levels used to report an unexpected event which not necessarily indicates an error. Any important information can also be logged with these trace levels. |
|
PROTOCOL_TIMEOUT (41) |
Traces to be generated whenever there is a protocol time-out. |
3.2 Trace Levels for Single Session
The recommended trace level for single session, DEBUG (55), is 56 or FORLOP (56) is 57. Other trace levels used in the MTAS are listed in ascending order in the following table:
|
Trace Level |
Description |
|---|---|
|
PROGRESS (43) |
Function progress (call setup), interface signaling (SIP, Diameter, H248 signaling), and state transitions are reported using this trace level. Applying this trace level, it is possible to follow the progress of a call, with state transitions, through all protocol functions and services. |
|
PROCESS (51) |
Applied when report creation or termination of a dynamic and static process and creation or deletion of vDicos dialogues. |
|
DEBUG (55) |
Applied to generate debug traces. |
|
FORLOP (56) |
Applied to generate traces when forlop has a value higher than zero. |
|
SIP_STACK (61) |
Applied for traces generated by the SIP stack. Must not be used unless a SIP problem is identified. |
3.3 EventHistory
In a live system, it is not possible to use full tracing owing to the number of logs generated. To help analyze problems occurring under these circumstances, important trace strings can be written to the EventHistory.
These traces are output to the console logs if there is an unexpected process termination in the following Capsule Abortion (CA) cases:
- Divide by zero
- Illegal opcode
- Page fault exception
The type of information saved in the EventHistory could, for example, be the incoming and outgoing SIP messages, h.248, expiring timers, created events, and code execution
The MTAS EventHistory is always on.
3.4 Catalina Log
The MTAS Catalina log files contain information about MTAS XDMS processes. Each Catalina file has a maximum size of 10 MB. Once this size has been reached, a new file is created. The total number of files can be up to 11, named catalina.log, catalina.log.1, and so on. The resulting string starts with the date, time, thread name, log level, AppTrace domain, session, and sequence number. Next part of the string is the "-" character, after which is the logging information. The resulting string ends up in the Catalina log and is printed to the following directory:
/opt/mmas/appserver/traffic_instance0/standalone/logs/
The following are examples of a Catalina string:
2015-09-15 10:10:01,260 [http-apr-127.0.0.1-8095-exec-8]
DEBUG mtas.xdms.xdms.cai3g A192D168D83D100Z1441384753S516P65537 1688257881
- Document pre-edit
2015-09-15 10:07:07,879 [http-apr-127.0.0.1-8090-exec-2]
DEBUG mtas.xdms.xdms.validation 127.0.0.1 simservs sip:user@telcom.com
- ...application validated.
3.5 Applog
The MTAS applog log files contain information about terminated MTAS processes. Such a terminated process is a fault indication. Each applog file is determined to a maximum size of 40 MB. Once this size has been reached, a new applog file is created. The total number of applog files can be up to 15, and are named MTAS_<timestamp>.log, MTAS_<timestamp>.log.1, MTAS_<timestamp>.log.2, and so on.
The resulting string starts with the sequence number, time stamp, log level, process key, and descriptive field. The resulting string ends up in the following directory:
/cluster/storage/no-backup/coremw/var/log/saflog/MTASAppLogs/vdicos
The following is an example of an applog string:
163 11:11:40 10/29/2014 WA "[SipDistributorProcess] Control::init() SipDistributorControl ok, done synchronizing! OamSynchronizerPortName published!!!"
For more information about the AppLogs, refer to MTAS Logs.
3.6 One Subscriber Tracing
Subscriber tracing can be done using the existing forlop tracing supported by vDicos AppTrace. Forlop tracing makes it possible to inject a forlop identity into the AppTrace at a trace event and then to use that identity in subsequent AppTrace expressions to capture related events. The basic idea is to allow the trace-user to trace an entire "call", as it propagates through the system by passing through various processes on several processors. A forlop identity is simply an integer value. The default value of zero is a predefined "anonymous forlop", that is, forlop tracing is turned off.
Trace profiles for forlop can be found in Section 6 Trace Profiles
Example of using forlop can be found in Step 6 in Section 7.
For an example use of a subscriber tracing profile, refer to section Trace Profiles in MTAS Troubleshooting Guideline.
3.7 Default Trace
The MTAS automatically writes certain number of important trace events into console log files without any manual action needed from the end user. The default trace printouts provide useful information about potential problems on a live system even if the logs do not contain more detailed and specific traces that can be produced by starting an AppTrace session.
The trace events that are printed by default are randomly selected from WARNING, CONFIG, and CRITICAL level trace events. The number of printed trace events is under control: 10 WARNING and another 10 CONFIG, and CRITICAL events are logged by default on average each minute into each console log file of each processor (if so many such events happen at all).
The following is an example of a default trace string:
DEF-TRACE: WARNI 7220 sip:B_barring_dndcb_ 10202668@barringdndcb.imsas.uab.ericsson.se ApplicationProcess SubscriberLanguageCdcsHandler.cc:127 Found no language mapping entry for sv
The default trace feature can be controlled through CM attributes. The feature can be turned off and also an intensive default tracing can be achieved for debugging purposes.
For more details, see the description of the mtasTraceDefaultWarningPerMinute, mtasTraceDefaultCriticalConfigPerMinute, and mtasTraceDefaultTracePrintSubscriberKey CM attributes in Managed Object Model (MOM).
4 AppTrace Process Types in MTAS
MTAS static processes and most dynamic processes start directly after system startup. Certain dynamic processes can however be started or restarted a long time after the system startup. The following table lists the available MTAS processes, each with a short description or comment.
The table shows the complete syntax used in AppTrace process name.
This is for most process types written according to the following
format:
<ProcessName>.RTID
|
Process Type |
Description or Comment |
|---|---|
|
AcrStorageHandlerProc.1119246 |
When communication with an offline Charging Server is lost, this process is used by the application process to store all offline charging ACR messages on disk. |
|
ApplicationProcess.1060633 |
Application process |
|
CarrierSelectDataProcess.1101115 |
Handles the MTAS configuration data for Carrier Select |
|
ChargingBackupHandlerProcNew.1101924 |
Charging backup handler process |
|
ChargingProcess.1101151 |
Charging process |
|
CmControllerPT.1058017 |
CM controller processes |
|
CmJimLDAPAdapterProcess.1058088 |
CM jim ldap adapter process |
|
Cm_TcpSetupHandlerProcess.1058091 |
|
|
DIA_PRC_ConnectionMgrProcess.1015860 |
- |
|
DIA_PRC_DBAccessHandlerProcess.1053645 |
- |
|
DIA_PRC_DefaultService.1015914 |
- |
|
DIA_PRC_HandlerProcess.1015878 |
- |
|
DIA_PRC_TransportListenerProcess.1015881 |
- |
|
DeeUtilCliDaemon.1045185 |
- |
|
DeeUtilGlobalRootDaemon.1045188 |
- |
|
DeeUtilLocalRootDaemon.1045191 |
- |
|
DeeatCAgent.1041553 |
- |
|
DeeatCCoord.1041547 |
- |
|
DialPlanProcess.1101962 |
Caches configuration tables of Dial Plan, Barring Programs and CAC Connection Limit at MTAS start and implements to match the input number against the different cached tables. |
|
DiameterInstallerProc.1060881 |
Diameter installer process |
|
DiameterInstallerShProc.1101088 |
Diameter installer Sh process |
|
DicosAppTraceMO_PT.1044688 |
Dicos application trace Managed Object |
|
DoamEventProcess.1109439 |
- |
|
FilterHandlerProcess.1117544 |
- |
|
H248ProcessNew.1101915 |
H248 process |
|
H248TransportProcessTypeNew.1101945 |
H.248 transport process |
|
HTTP_TransportProc.1105060 |
HTTP process |
|
HeadProcessNew.1101927 |
Head process |
|
HttpDistributorProcessNew.1101918 |
- |
|
ICMP_Traffic_Proc.1105036 |
- |
|
ImrnAllocatorProcess.1101646 |
Imrn allocator process |
|
JIM_InstallerProcess.555481 |
- |
|
JIM_ServerProcess.555497 |
- |
|
MomCMInstallerProcess.1060808 |
Mom configuration installer process |
|
ModelHandlerProcess.1117166 |
- |
|
MProfSrvProc_PT.1101281 |
- |
|
MTASPbxProcess.SWI_StPbxProcess |
Responsible for incrementing/decrementing SIP Trunking Call Admission Control (CAC) counters on PBX level and for controlling if CAC limits have been reached or not. |
|
NUMANA_ConfigSyncProc.1105198 |
- |
|
NUMANA_OamInstallerProc.1105203 |
- |
|
NUMANA_Proc.1105183 |
- |
|
NumberTranslationProcess.1119085 |
Number translation process |
|
OamProcess.1060627 |
At initial startup, the subsystem instantiates the MIB (MOM) and connects to the license server and periodically checks license status. |
|
PotAuditProcess.1101244 |
Pot audit process |
|
PbxProcess.1126156 |
- |
|
PmCollector.1117076 |
- |
|
SS7DistributorProcess.1101552 |
SS7DistributorProcess receives and sends CAP messages. |
|
SS7MapDistributorProcess.1119989 |
Responsible for handling SS7/MAP communication. |
|
SctpOamProcess.1101098 |
|
|
ShNotifyProcessNew.1101930 |
Sh notify process |
|
ShRequestProcessNew.1101921 |
Sh request process |
|
SipDistributorProcessNew.1101932 |
SIP distributor process |
|
SipWorkerProcess.1126164 |
SIP distributor worker process |
|
SubscriberDataControlProcess.1126150 |
Subscriber data process |
|
SubscriberDataOamProcess.1061067 |
Subscriber data OAM process |
|
TimerProcessNew.1101935 |
Timer process |
|
vDicosLdapInstallerProcess.1127011 |
- |
|
XdmsDiameterDistributor_PT.1101094 |
XDMS Diameter distribution process |
|
XdmsDiameterInstallerProc.1061368 |
Process on vDicos that runs the code for initializing the XDMS instance of the Diameter stack. |
|
XdmsLinuxServer_PT.1101006 |
XDMS Linux server process |
Available Common Components (CMCOs) processes are listed in the following table:
|
Process Type |
Description or Comment |
|---|---|
|
CMCO_UtcOffsetMgrProc_PT.1105704 |
- |
|
CARSEL_CsProc.1084367 |
Handles Carrier Select functions used by the MTAS. |
|
CARSEL_DsaProc.1084423 |
Handles Carrier Select functions used by the MTAS. |
|
CARSEL_OamInstallerProc.1084373 |
Handles Carrier Select functions used by the MTAS. |
|
CARSEL_ConfigSyncProc.1084447 |
Handles Carrier Select functions used by the MTAS. |
|
DnsCacheProc.1041760 |
Handles DNS server functions used by the MTAS. |
|
DnsTransportProc.1042512 |
Handles DNS server functions used by the MTAS. |
|
DnsApplInstallProc.1041869 |
Handles DNS server functions used by the MTAS. |
|
HTTP_TransportProc.1105060 |
Handles HTTP transport functions used by the MTAS. |
|
ICMP_ControllerProc.1084198 |
Handles the creation and removal of the ICMP sockets. |
|
ICMP_OamInstallerProc.1084211 |
Runs the code for initializing the ICMP Framework data. |
|
ICMP_OamInstallerProc.1084211 |
Runs the code for initializing the ICMP Framework data. |
|
Ipmm_NumberNormalization_Proc.1041857 |
Handles the Number Normalization function used by the MTAS. |
|
IpmmNumNormOamInstallerProc.1041979 |
Handles the Number Normalization function used by the MTAS. |
|
IpmmNumNormConfigSyncProc.1105066 |
Handles the Number Normalization function used by the MTAS. |
5 AppTrace Domains in MTAS
To collect trace output from a trace domain, the name of the domain is added to the trace session as shown in Section 7 Example. A subset of AppTrace domains and domain groups in the MTAS are listed in the following table:
- Note:
- Select the MTAS trace domains with four levels in the AppTrace session. Example: ims.mtas.sip.*.
|
Domain |
Description or Comment |
|---|---|
|
ims.mtas.ccmp.dispatcher |
This trace domain handles traces on the ccmpDispatcher. Centralized Conferencing Manipulation Protocol |
|
ims.mtas.charging.common |
This trace domain handles traces on commonly used functions for Charging. |
|
ims.mtas.common.common |
This trace domain handles the common parts. |
|
ims.mtas.common.headprocess |
This trace domain exists in only one instance. It supervises the processors to detect added, removed, or restarted processors, and provides the overall control of small restarts and the overall control of the actions required as a result of changes to the administrative states. |
|
ims.mtas.common.nc |
This trace domain handles the traces for Node control. |
|
ims.mtas.common.timers |
This trace domain handles the traces for Timers. |
|
ims.mtas.common.trace |
This trace domain contains the MTAS trace. |
|
ims.mtas.common.utils |
This trace domain handles traces on commonly used functions. |
|
ims.mtas.csi.applicationprocess |
This trace domain handles traces in the CSI subsystem for CAMEL interaction steps done in the application process. Typically activated together with ims.mtas.csi.common, ims.mtas.csi.staticprocess, and ims.mtas.services.ncc. |
|
ims.mtas.csi.common |
This trace domain handles traces in the CSI subsystem for CAMEL interaction steps done in the SS7DistributorProcess and Application process. Typical activated together with ims.mtas.csi.staticprocess, ims.mtas.csi.applicationprocess, and ims.mtas.services.ncc. |
|
ims.mtas.csi.staticprocess |
This trace domain handles traces in the CSI subsystem for CAMEL interaction steps done in the SS7DistributorProcess. Typically activated together with ims.mtas.csi.common, ims.mtas.csi.applicationprocess, and ims.mtas.services.ncc. |
|
ims.mtas.errlog.diam.rf |
This trace domain handles traces of the Error responses and Reason phrases for Diameter on the RF interface. |
|
ims.mtas.errlog.diam.ro |
This trace domain handles traces of the Error responses and Reason phrases for Diameter on the Ro interface. |
|
ims.mtas.errlog.diam.sh |
This trace domain handles traces of the Error responses and Reason phrases for Diameter on the SH interface. |
|
ims.mtas.errlog.h248 |
This trace domain handles traces of the Error responses and Reason phrases on the H.248 interface. |
|
ims.mtas.errlog.sip |
This trace domain handles traces of the Error responses and Reason phrases on the SIP interface |
|
ims.mtas.if.http |
This trace domain handles traces on the HTTP interface. |
|
ims.mtas.if.mr |
This trace domain handles traces on the Mr interface. |
|
ims.mtas.if.mrfc |
This trace domain handles traces on the MRFC interface. |
|
ims.mtas.if.namedb |
This trace domain handles traces on the Name DB interface. |
|
ims.mtas.if.rx |
This trace domain handles traces on the online charging interface. |
|
ims.mtas.if.sh |
This trace domain handles traces on the SH interface. |
|
ims.mtas.if.sip |
This trace domain handles traces on the SIP interface. |
|
ims.mtas.log.start |
This trace domain starts forlop tracing. |
|
ims.mtas.memory |
This trace domain handles traces about memory use information by Applicaton Process. |
|
ims.mtas.mrfc.additionalmediaresource |
This trace domain handles the traces on the media framework towards MRFC for additional media resource. |
|
ims.mtas.mrfc.h248stack |
This trace domain handles the traces on the H.248 stack. |
|
ims.mtas.mrfc.mediafw |
This trace domain handles the traces on the media framework towards MRFC. |
|
ims.mtas.netio.info |
This trace domain handles the traces for NetTrace on maximum level in human readable format. |
|
ims.mtas.netio.rx |
This trace domain handles the traces for NetTrace on maximum level in human readable format. |
|
ims.mtas.netio.sip |
This trace domain handles the traces for NetTrace, SIP signalling trace on maximum level in human readable format. |
|
ims.mtas.netio.tx |
This trace domain handles the traces for NetTrace on maximum level in human readable format. |
|
ims.mtas.nettrace.info |
This trace domain handles the traces for NetTrace on maximum level in machine-readable format as defined by 3GPP. |
|
ims.mtas.nettrace.init |
This trace domain handles the traces for NetTrace on maximum level in machine-readable format as defined by 3GPP. |
|
ims.mtas.nettrace.rx |
This trace domain handles the traces for NetTrace on maximum level in machine-readable format as defined by 3GPP. |
|
ims.mtas.nettrace.sip |
This trace domain handles the traces for NetTrace, SIP signalling trace on maximum level in machine-readable format as defined by 3GPP. |
|
ims.mtas.nettrace.tx |
This trace domain handles the traces for NetTrace on maximum level in machine-readable format as defined by 3GPP. |
|
ims.mtas.oam.3pty |
This trace domain handles the traces on configuration attributes for three-party. |
|
ims.mtas.oam.abdial |
This trace domain handles the traces on configuration attributes for Abbreviated Dialing. |
|
ims.mtas.oam.aoc |
This trace domain handles the traces on configuration attributes for Advise Of Charge. |
|
ims.mtas.oam.ap |
This trace domain handles the traces on configuration attributes for aggregation proxy. |
|
ims.mtas.oam.asiw |
This trace domain handles the traces on configuration attributes for application server interworking. |
|
ims.mtas.oam.cac |
This trace domain traces on configuration attributes for Call Admission Control. |
|
ims.mtas.oam.cb |
This trace domain traces on configuration attributes for Communication Barring. |
|
ims.mtas.oam.cc |
This trace domain handles traces on configuration attributes for Call Completion. |
|
ims.mtas.oam.cdiv |
This trace domain handles traces on configuration attributes for call diversion. |
|
ims.mtas.oam.charging |
This trace domain handles traces on configuration attributes for Charging. |
|
ims.mtas.oam.comdetails |
This trace domain handles traces on configuration attributes for Communication details. |
|
ims.mtas.oam.common |
This trace domain handles traces on configuration attributes for commonly used parts. |
|
ims.mtas.oam.conf |
This trace domain handles traces on configuration attributes for Conference. |
|
ims.mtas.oam.cpc |
This trace domain handles traces on configuration attributes for Call party category. |
|
ims.mtas.oam.cps |
This trace domain handles traces on configuration attributes for Carrier Pre-Select. |
|
ims.mtas.oam.cr |
This trace domain handles the traces on configuration attributes for call return |
|
ims.mtas.oam.cs |
This trace domain handles traces on configuration attributes for Carrier Select. |
|
ims.mtas.oam.csi |
This trace domain handles traces on configuration attributes for CSI subsystem, Circuit Switch Interworking. |
|
ims.mtas.oam.csvfb |
This trace domain handles traces on configuration attributes for Carrier Select Video Fallback. |
|
ims.mtas.oam.cug |
This trace domain handles the traces on configuration attributes for close user group. |
|
ims.mtas.oam.cw |
This trace domain handles traces on configuration attributes for Communication Waiting. |
|
ims.mtas.oam.dialplan |
This trace domain handles traces on configuration attributes for Dial Plan. |
|
ims.mtas.oam.dr |
This trace domain handles the traces on configuration attributes for Distinctive Ring. |
|
ims.mtas.oam.dtm |
This trace domain handles traces on configuration attributes for Dial Tone Management. |
|
ims.mtas.oam.ect |
This trace domain handles traces on configuration attributes for Explicit Communication Transfer. |
|
ims.mtas.oam.fcd |
This trace domain handles traces on configuration attributes for Flexible Communication Distribution. |
|
ims.mtas.oam.fsfs |
This trace domain handles the traces on configuration attributes for file transfer |
|
ims.mtas.oam.ga |
This trace domain handles traces on configuration attributes for Generic Announcement. |
|
ims.mtas.oam.gls |
This trace domain handles traces on configuration attributes for Global Licensing Service. |
|
ims.mtas.oam.gm |
This trace domain handles traces on configuration attributes for Gateway Model. |
|
ims.mtas.oam.hold |
This trace domain handles traces on configuration attributes for hold. |
|
ims.mtas.oam.hotline |
This trace domain handles the traces on configuration attributes for hotline. |
|
ims.mtas.oam.idpres |
This trace domain handles traces on configuration attributes for Identity Presentation. |
|
ims.mtas.oam.jc |
This trace domain handles traces on configuration attributes for Japanese Charging. |
|
ims.mtas.oam.mcid |
This trace domain handles traces on configuration attributes for Malicious Communication IDentification. |
|
ims.mtas.oam.mmt |
This trace domain handles traces on configuration attributes for Multimedia Telephony. |
|
ims.mtas.oam.mrfc |
This trace domain handles traces on configuration attributes for the MRFC. |
|
ims.mtas.oam.na |
This trace domain handles traces on configuration attributes for network announcement. |
|
ims.mtas.oam.namedb |
This trace domain handles traces on configuration attributes for nameDb. |
|
ims.mtas.oam.ncc |
This trace domain handles traces on configuration attributes for Northbound Call Control. |
|
ims.mtas.oam.numnorm |
This trace domain handles traces on configuration attributes for Number Normalization. |
|
ims.mtas.oam.numport |
This trace domain handles the traces on configuration attributes for Number Portability. |
|
ims.mtas.oam.oct |
This trace domain handles the traces on configuration attributes for Operator Controlled Transfer |
|
ims.mtas.oam.priocall |
This trace domain handles traces on configuration attributes for priority call. |
|
ims.mtas.oam.px |
This trace domain handles traces on configuration attributes for Parlay-X. |
|
ims.mtas.oam.rbt |
This trace domain handles the traces on configuration attributes for Ring Back Tone. |
|
ims.mtas.oam.scc |
This trace domain handles the traces on configuration attributes for Supplementary Service Code. |
|
ims.mtas.oam.sds |
This trace domain handles the traces on configuration attributes for Service Domain Selection. |
|
ims.mtas.oam.sh |
This trace domain handles traces on configuration attributes for SH. |
|
ims.mtas.oam.sip |
This trace domain handles traces on configuration attributes for SIP. |
|
ims.mtas.oam.snd |
This trace domain handles traces on configuration attributes for Short Number Dialing. |
|
ims.mtas.oam.ssc |
This trace domain handles traces on configuration attributes for supplementary service codes. |
|
ims.mtas.oam.st |
This trace domain handles traces on configuration attributes for STAS (SIP Trunking AS). |
|
ims.mtas.oam.subscriberdata |
This trace domain handles traces on configuration attributes for subscriber data. |
|
ims.mtas.oam.tads |
This trace domain handles the traces on configuration attributes for Terminating Access Domain Selection. |
|
ims.mtas.oam.vtp |
This trace domain handles traces on configuration attributes for virtual |
|
ims.mtas.oam.xdms |
This trace domain handles traces on configuration attributes for XDMS. |
|
ims.mtas.px.dispatcher |
This trace domain handles traces on the pxDispatcher. |
|
ims.mtas.services.3pty |
This trace domain handles traces on the Three Party service. |
|
ims.mtas.services.abdial |
This trace domain handles traces on the Abbreviated Dialing service. |
|
ims.mtas.services.aoc |
This trace domain handles traces on the Advice of Charge service. |
|
ims.mtas.services.asiw |
This trace domain handles traces on the Application Server InterWorking service. |
|
ims.mtas.services.cac |
This trace domain handles traces on the Call Admission Control service. |
|
ims.mtas.services.cat |
This trace domain handles traces on the Customized Alerting Tones service. |
|
ims.mtas.services.cb |
This trace domain handles traces on the Communication Barring service. |
|
ims.mtas.services.cc |
This trace domain handles traces on the Call Completion service. |
|
ims.mtas.services.cd |
This trace domain handles traces on the Communication Distribution service. |
|
ims.mtas.services.cdiv |
This trace domain handles traces on the Communication Diversion service. |
|
ims.mtas.services.charging |
This trace domain handles traces on the Charging service. |
|
ims.mtas.services.common |
This trace domain handles traces on the commonly used functions for services. |
|
ims.mtas.services.conf |
This trace domain handles traces on the Conference service. |
|
ims.mtas.services.conference |
This trace domain handles traces on the Conference service. |
|
ims.mtas.services.cpc |
This trace domain handles traces on the Call party category service. |
|
ims.mtas.services.cps |
This trace domain handles traces on the Carrier Pre-Select service. |
|
ims.mtas.services.cr |
This trace domain handles traces on the Call Return service. |
|
ims.mtas.services.cs |
This trace domain handles traces on the Carrier Select service. |
|
ims.mtas.services.csvfb |
This trace domain handles traces on the Carrier Select Video Fallback service. |
|
ims.mtas.services.cug |
This trace domain handles traces on the Closed User Group service. |
|
ims.mtas.services.cw |
This trace domain handles traces on the Communication Waiting service. |
|
ims.mtas.services.dbl |
This trace domain handles traces on the Dynamic Black List service. |
|
ims.mtas.services.dr |
This trace domain handles traces on the Distinctive Ring service. |
|
ims.mtas.services.dtm |
This trace domain handles traces on the Dial Tone Management service. |
|
ims.mtas.services.ect |
This trace domain handles traces on the Explicit Communication Transfer services. |
|
ims.mtas.services.emergencystate |
This trace domain handles traces on the Emergency State service. |
|
ims.mtas.services.flp |
This trace domain handles traces on Scheduled Conference service. |
|
ims.mtas.services.gls |
This trace domain handles traces on the GLS service. |
|
ims.mtas.services.gm |
This trace domain handles traces on the Gateway Model service. |
|
ims.mtas.services.hold |
This trace domain handles traces on the Hold service. |
|
ims.mtas.services.hotline |
This trace domain handles traces on the hotline service. |
|
ims.mtas.services.idpres |
This trace domain handles traces on the Identity Presentation service. |
|
ims.mtas.services.jc |
This trace domain handles traces on the Japanese Charging service. |
|
ims.mtas.services.mcid |
This trace domain handles traces on the Malicious Communication IDentification service. |
|
ims.mtas.services.mmt |
This trace domain handles traces on the Multimedia Telephony service. |
|
ims.mtas.services.na |
This trace domain handles traces on the Network Announcement service. |
|
ims.mtas.services.ncc |
This trace domain handles traces on the Northbound Call Control service. |
|
ims.mtas.services.numbertranslation |
This trace domain handles traces on the Number translation service. |
|
ims.mtas.services.numnorm |
This trace domain handles traces on the Number Normalization service. |
|
ims.mtas.services.numport |
This trace domain handles traces on the Number Portability service. |
|
ims.mtas.services.ocb |
This trace domain handles traces on the Outgoing Communication Barring service. |
|
ims.mtas.services.oct |
This trace domain handles traces on the Operator Controlled Transfer service. |
|
ims.mtas.services.presence |
This trace domain handles traces on the Presence Service. |
|
ims.mtas.services.priocall |
This trace domain handles traces on the Priority Call service. |
|
ims.mtas.services.px3pcc |
This trace domain handles traces on the Parlay-X Third-Party Call Control service. |
|
ims.mtas.services.pxcn |
This trace domain handles traces on the Parlay-X Common Name service. |
|
ims.mtas.services.rbt |
This trace domain handles traces on the Ring Back Tone service. |
|
ims.mtas.services.scc |
This trace domain handles traces on the Service Centralization and Continuity service. |
|
ims.mtas.services.scn |
This trace domain handles traces on the Subscriber Credit Notification service. |
|
ims.mtas.services.sds |
This trace domain handles traces on the Service Domain Selection service. |
|
ims.mtas.services.servicefw |
This trace domain handles traces on the Service Framework service. |
|
ims.mtas.services.snd |
This trace domain handles traces on the Short Number Dialing service. |
|
ims.mtas.services.srvcc |
This trace domain handles traces on the Single Radio Voice Call Continuity service. |
|
ims.mtas.services.ssc |
This trace domain handles traces on the Supplementary Service Codes service including the DICOS part of the Generic SSC feature. |
|
ims.mtas.services.stod |
This trace domain handles traces on the Session Transfer to Own Device service. |
|
ims.mtas.services.subdata |
This trace domain handles traces on the Subscriber Data service. |
|
ims.mtas.services.tads |
This trace domain handles traces on the Terminating Access Domain Selection service. |
|
ims.mtas.services.uloc |
This trace domain handles traces on the user location service. |
|
ims.mtas.services.unreg |
This trace domain handles traces on the unregistered Subscriber service. |
|
ims.mtas.services.vm |
This trace domain handles traces on the Voice Mail service. |
|
ims.mtas.sip.dispatcher |
This trace domain handles traces on the sipDispatcher. |
|
ims.mtas.sip.distributor |
This trace domain handles traces on the SipDistributor. |
|
ims.mtas.sip.sipstack |
This trace domain handles traces on the SIP stack. |
|
ims.mtas.st.core |
This trace domain handles traces in the core parts of the STAS (SIP Trunking AS). |
|
ims.mtas.st.services |
|
|
ims.mtas.subscriberdata.conferencedata |
This trace domain handles traces on the conference part of the subscriber data. |
|
ims.mtas.subscriberdata.core |
This trace domain handles traces on the core of subscriber data. |
|
ims.mtas.subscriberdata.servicedata |
This trace domain handles traces on the service data of the subscriber data. |
|
ims.mtas.subscriberdata.servicenumdata |
This trace domain handles traces on Number Normalization part of the subscriber data. |
|
ims.mtas.subscriberdata.stasdata |
This trace domain handles traces in the STAS (SIP Trunking AS) part of subscriber data. |
|
ims.mtas.subscriberdata.userdata |
This trace domain handles traces on the user data of the subscriber data. |
|
ims.mtas.tools.mprof |
This trace domain handles traces on the Memory profiler. |
|
ims.mtas.utils.potaudit |
This trace domain handles traces on the POT Audit. |
|
ims.mtas.xdms.cai3g |
This trace domain handles traces on the CAI3G operator provisioning interface. |
|
ims.mtas.xdms.ccmp |
This trace domain handles traces for the CCMP interface. |
|
ims.mtas.xdms.charging |
This trace domain handles traces for Charging for Ut interface updates. |
|
ims.mtas.xdms.dao |
This trace domain handles traces for common functions for the XML service data access. |
|
ims.mtas.xdms.dtm |
This trace domain handles traces for the XDMS part of the Dial Tone Management feature. |
|
ims.mtas.xdms.genssc |
This trace domain handles traces for the XDMS part of the Generic SSC feature. |
|
ims.mtas.xdms.license |
This trace domain handles traces for XDMS licenses. |
|
ims.mtas.xdms.misc |
This trace domain handles traces for commonly used functions in XDMS. |
|
ims.mtas.xdms.numnorm |
This trace domain handles traces for XDMS Number Normalization. |
|
ims.mtas.xdms.oam |
This trace domain handles traces for O&M functions (configuration and performance management) within the XDMS. |
|
ims.mtas.xdms.rules |
This trace domain handles traces on application rule checks for the XML service data consistency. |
|
ims.mtas.xdms.timings |
This trace domain handles traces for timer code within the XDMS. |
|
ims.mtas.xdms.trace |
This trace domain handles traces for XDMS trace. |
|
ims.mtas.xdms.triggers |
This trace domain handles traces for trigger operation including triggering of Dial Tone Management (DTM). |
|
ims.mtas.xdms.utility |
This trace domain handles traces for commonly used utility support functions. |
|
ims.mtas.xdms.xcap |
This trace domain handles traces for the Ut XCAP interface for self-administration of XML service data. |
|
ims.mtas.xdms.xconconferenceinfo |
This trace domain handles traces for the XDMS part of the conference feature. |
|
ims.mtas.xdms.xdp |
This trace domain handles traces for inter-process communication within the XDMS. |
|
ims.mtas.xdmsval.validation |
This trace domain handles traces for XDMS validation. |
5.1 Domain Parameters
The Msg parameter is available for all CMCO and most MTAS domains, exceptions are the ones listed.
|
Domain |
Parameters |
|---|---|
|
ims.mtas.netio.rx |
Max level trace in human readable format $MiId, $MiVer, $Length, $Msg |
|
ims.mtas.netio.tx |
Max level trace in human readable format $MiId, $MiVer, $Length, $Msg |
|
ims.mtas.nettrace.info |
$MiId, $MiVer, $Length, $Msg |
|
ims.mtas.nettrace.sip |
$MiId, $MiVer, $Length, $Msg |
|
ims.mtas.nettrace.rx |
Max level trace in machine-readable format as defined by 3GPP $MiId, $MiVer, $Length, $Msg |
|
ims.mtas.nettrace.tx |
Max level trace in machine-readable format as defined by 3GPP $MiId, $MiVer, $Length, $Msg |
|
ims.mtas.errlog.sip |
$FromID, $Response, $Reason, $SessSide |
|
ims.mtas.errlog.h248 |
$Response, $Reason |
|
ims.mtas.errlog.diam.sh |
$Response, FromID, $Response, $Reason |
|
ims.mtas.errlog.diam.rf |
$FromID, $Response, $Reason, $SessSide |
|
ims.mtas.errlog.diam.ro |
$Reason, $SessSide |
6 Trace Profiles
Preconfigured trace profiles can be used for either a single session or a live system.
6.1 Trace Profiles for Single Session Software Trace
Table 1 shows the preconfigured trace profiles for a single session software trace:
|
Profile Name |
MtasProgressTrace43 |
|
Description |
Dumps information about any user. (1) |
|
Trace level |
PROGRESS (43) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess H248ProcessNew.SWI_H248ProcessNew TimerProcessNew.SWI_TimerProcessNew DiameterInstallerProc.SWI_DiameterInstaller ChargingBackupHandlerProcNew.SWI_ChargingBackupHandlerProcNew HeadProcessNew.SWI_HeadProcessNew SubscriberDataOamProcess.SWI_SubscriberDataOamProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew ShRequestProcessNew.SWI_ShRequestProcessNew DiameterInstallerShProc.SWI_DiameterInstallerSh ShNotifyProcessNew.SWI_ShNotifyProcessNew ChargingProcess.SWI_ChargingProcess PotAuditProcess.SWI_PotAuditProcess H248TransportProcessTypeNew.SWI_H248TransportProcessTypeNew HttpDistributorProcessNew.SWI_HttpDistributorProcessNew ImsAsXdms_PT.OU_ImsAsXdms MomCMInstallerProcess.SWI_MomCMInstaller SS7DistributorProcess.SWI_SS7DistributorProcess XdmsDiameterDistributor_PT.OU_XdmsDiameterDistributor XdmsLinuxServer_PT.OU_XdmsLinuxServer OamProcess.SWI_OamProcess AcrStorageHandlerProc.SWI_AcrStorageHandlerProc XdmsDiameterInstallerProc.OU_XdmsDiameterInstaller NumberTranslationProcess.SWI_NumberTranslationProcess CarrierSelectDataProcess.SWI_CarrierSelectDataProcess DialPlanProcess.SWI_DialPlanProcess ImrnAllocatorProcess.SWI_ImrnAllocatorProcess PbxProcess.SWI_StPbxProcess SS7MapDistributorProcess.SWI_SS7MapDistributorProcess SS7ReporterProcess.SWI_SS7ReporterProcess SipWorkerProcess.SWI_SipWorkerProcess SubscriberDataControlProcess.SWI_SubscriberDataControlProcess SctpOamProcess.SWI_SctpOamProcess |
|
Domains |
ims.mtas.ccmp.dispatcher ims.mtas.charging.common ims.mtas.common.* ims.mtas.csi.* ims.mtas.errlog.diam.sh ims.mtas.errlog.diam.rf ims.mtas.errlog.diam.ro ims.mtas.errlog.h248 ims.mtas.errlog.sip ims.mtas.if.* ims.mtas.mrfc.* ims.mtas.oam.* ims.mtas.px.dispatcher ims.mtas.services.* ims.mtas.sip.* ims.mtas.st.* ims.mtas.subscriberdata.* ims.mtas.utils.* ims.mtas.tools.mprof ims.mtas.xdms.* ims.mtas.xdmsval.validation |
|
Profile Name |
MtasLoggingOfErrorResponsesDebug55 |
|
Description |
Dumps information about the Error Responses received on the H.248, Rf, Ro, Sh, and SIP interfaces and debug traces. |
|
Trace level |
DEBUG (55) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew ShNotifyProcessNew.SWI_ShNotifyProcessNew ChargingProcess.SWI_ChargingProcess H248ProcessNew.SWI_H248ProcessNew H248TransportProcessNew.SWI_H248TransportProcessNew |
|
Domains |
ims.mtas.charging.common ims.mtas.common.common ims.mtas.common.utils ims.mtas.errlog.diam.rf ims.mtas.errlog.diam.ro ims.mtas.errlog.diam.sh ims.mtas.errlog.h248 ims.mtas.errlog.sip ims.mtas.if.* ims.mtas.sip.dispatcher ims.mtas.sip.distributor |
|
Profile Name |
MtasUserTraceforFromID56, MtasUserTraceToID56, or MtasUserTraceforFromIDandToID56 |
|
Description |
Dumps information about a particular user or users. |
|
Trace level |
FORLOP (56) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess |
|
Domains |
ims.mtas.common.common ims.mtas.sip.dispatcher ims.mtas.services.* ims.mtas.st.* |
|
Profile Name |
MtasDebugTrace55 |
|
Description |
Dumps information about any user. (1) |
|
Trace level |
DEBUG (55) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess H248ProcessNew.SWI_H248ProcessNew TimerProcessNew.SWI_TimerProcessNew DiameterInstallerProc.SWI_DiameterInstaller ChargingBackupHandlerProcNew.SWI_ChargingBackupHandlerProcNew HeadProcessNew.SWI_HeadProcessNew SubscriberDataOamProcess.SWI_SubscriberDataOamProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew ShRequestProcessNew.SWI_ShRequestProcessNew DiameterInstallerShProc.SWI_DiameterInstallerSh ShNotifyProcessNew.SWI_ShNotifyProcessNew ChargingProcess.SWI_ChargingProcess PotAuditProcess.SWI_PotAuditProcess H248TransportProcessTypeNew.SWI_H248TransportProcessTypeNew HttpDistributorProcessNew.SWI_HttpDistributorProcessNew ImsAsXdms_PT.OU_ImsAsXdms MomCMInstallerProcess.SWI_MomCMInstaller SS7DistributorProcess.SWI_SS7DistributorProcess XdmsDiameterDistributor_PT.OU_XdmsDiameterDistributor XdmsLinuxServer_PT.OU_XdmsLinuxServer OamProcess.SWI_OamProcess AcrStorageHandlerProc.SWI_AcrStorageHandlerProc XdmsDiameterInstallerProc.OU_XdmsDiameterInstaller NumberTranslationProcess.SWI_NumberTranslationProcess CarrierSelectDataProcess.SWI_CarrierSelectDataProcess DialPlanProcess.SWI_DialPlanProcess ImrnAllocatorProcess.SWI_ImrnAllocatorProcess PbxProcess.SWI_StPbxProcess SS7MapDistributorProcess.SWI_SS7MapDistributorProcess SS7ReporterProcess.SWI_SS7ReporterProcess SipWorkerProcess.SWI_SipWorkerProcess SubscriberDataControlProcess.SWI_SubscriberDataControlProcess SctpOamProcess.SWI_SctpOamProcess |
|
Domains |
ims.mtas.errlog.sip ims.mtas.errlog.h248 ims.mtas.errlog.diam.sh ims.mtas.errlog.diam.rf ims.mtas.errlog.diam.ro ims.mtas.common.* ims.mtas.charging.common ims.mtas.if.* ims.mtas.ccmp.dispatcher ims.mtas.services.* ims.mtas.px.dispatcher ims.mtas.csi.* ims.mtas.mrfc.* ims.mtas.oam.* ims.mtas.sip.* ims.mtas.subscriberdata.* ims.mtas.utils.* ims.mtas.xdms.* ims.mtas.xdmsval.validation ims.mtas.tools.mprof ims.mtas.st.* |
|
Profile Name |
MtasSCCASTrace55 |
|
Description |
|
|
Trace level |
DEBUG (55) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew SS7DistributorProcess.SWI_SS7DistributorProcess SS7MapDistributorProcess.SWI_SS7MapDistributorProcess |
|
Domains |
ims.mtas.charging.common ims.mtas.common.common ims.mtas.common.utils ims.mtas.errlog.sip ims.mtas.errlog.diam.sh ims.mtas.errlog.diam.rf ims.mtas.if.sh ims.mtas.services.common ims.mtas.services.scc ims.mtas.services.sds ims.mtas.services.servicefw ims.mtas.services.srvcc ims.mtas.services.subdata ims.mtas.services.tads ims.mtas.csi.* ims.mtas.sip.* ims.mtas.subscriberdata.* |
(1) Only recommended to be used
for single session.
6.2 Trace Profiles for Live System Software Trace
Table 2 shows the preconfigured trace profiles for a live system software trace:
|
Profile Name |
MtasWarningTrace36 |
|
Description |
Dumps information about unexpected events and EventHistory. |
|
Trace level |
WARNING (36) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess H248ProcessNew.SWI_H248ProcessNew TimerProcessNew.SWI_TimerProcessNew DiameterInstallerProc.SWI_DiameterInstaller ChargingBackupHandlerProcNew.SWI_ChargingBackupHandlerProcNew HeadProcessNew.SWI_HeadProcessNew SubscriberDataOamProcess.SWI_SubscriberDataOamProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew ShRequestProcessNew.SWI_ShRequestProcessNew DiameterInstallerShProc.SWI_DiameterInstallerSh ShNotifyProcessNew.SWI_ShNotifyProcessNew ChargingProcess.SWI_ChargingProcess PotAuditProcess.SWI_PotAuditProcess H248TransportProcessTypeNew.SWI_H248TransportProcessTypeNew HttpDistributorProcessNew.SWI_HttpDistributorProcessNew ImsAsXdms_PT.OU_ImsAsXdms MomCMInstallerProcess.SWI_MomCMInstaller SS7DistributorProcess.SWI_SS7DistributorProcess XdmsDiameterDistributor_PT.OU_XdmsDiameterDistributor XdmsLinuxServer_PT.OU_XdmsLinuxServer OamProcess.SWI_OamProcess AcrStorageHandlerProc.SWI_AcrStorageHandlerProc XdmsDiameterInstallerProc.OU_XdmsDiameterInstaller NumberTranslationProcess.SWI_NumberTranslationProcess CarrierSelectDataProcess.SWI_CarrierSelectDataProcess DialPlanProcess.SWI_DialPlanProcess ImrnAllocatorProcess.SWI_ImrnAllocatorProcess PbxProcess.SWI_StPbxProcess SS7MapDistributorProcess.SWI_SS7MapDistributorProcess SS7ReporterProcess.SWI_SS7ReporterProcess SipWorkerProcess.SWI_SipWorkerProcess SubscriberDataControlProcess.SWI_SubscriberDataControlProcess SctpOamProcess.SWI_SctpOamProcess |
|
Domains |
ims.mtas.errlog.sip ims.mtas.errlog.h248 ims.mtas.errlog.diam.sh ims.mtas.errlog.diam.rf ims.mtas.errlog.diam.ro ims.mtas.common.* ims.mtas.charging.common ims.mtas.if.* ' ims.mtas.ccmp.dispatcher ims.mtas.services.* ims.mtas.px.dispatcher ims.mtas.csi.* ims.mtas.mrfc.* ims.mtas.oam.* ims.mtas.sip.* ims.mtas.subscriberdata.* ims.mtas.utils.* ims.mtas.xdms.* ims.mtas.xdmsval.validation ims.mtas.tools.mprof ims.mtas.st.* |
|
Profile Name |
MtasLoggingOfErrorResponses40 |
|
Description |
Dumps information about the Error Responses received on the H.248, Rf, Ro, Sh, and SIP interfaces. |
|
Trace level |
40 |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew ShNotifyProcessNew.SWI_ShNotifyProcessNew ChargingProcess.SWI_ChargingProcess H248ProcessNew.SWI_H248ProcessNew H248TransportProcessNew.SWI_H248TransportProcessNew |
|
Domains |
ims.mtas.errlog.sip ims.mtas.errlog.h248 ims.mtas.errlog.diam.sh ims.mtas.errlog.diam.rf ims.mtas.errlog.diam.ro |
|
Profile Name |
MtasProtocolTimeoutTrace41 |
|
Description |
Dumps information about unexpected events provided by MTAS. |
|
Trace level |
PROTOCOL_TIMEOUT (41) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess H248ProcessNew.SWI_H248ProcessNew TimerProcessNew.SWI_TimerProcessNew DiameterInstallerProc.SWI_DiameterInstaller ChargingBackupHandlerProcNew.SWI_ChargingBackupHandlerProcNew HeadProcessNew.SWI_HeadProcessNew SubscriberDataOamProcess.SWI_SubscriberDataOamProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew ShRequestProcessNew.SWI_ShRequestProcessNew DiameterInstallerShProc.SWI_DiameterInstallerSh ShNotifyProcessNew.SWI_ShNotifyProcessNew ChargingProcess.SWI_ChargingProcess PotAuditProcess.SWI_PotAuditProcess H248TransportProcessTypeNew.SWI_H248TransportProcessTypeNew HttpDistributorProcessNew.SWI_HttpDistributorProcessNew ImsAsXdms_PT.OU_ImsAsXdms MomCMInstallerProcess.SWI_MomCMInstaller SS7DistributorProcess.SWI_SS7DistributorProcess XdmsDiameterDistributor_PT.OU_XdmsDiameterDistributor XdmsLinuxServer_PT.OU_XdmsLinuxServer OamProcess.SWI_OamProcess AcrStorageHandlerProc.SWI_AcrStorageHandlerProc XdmsDiameterInstallerProc.OU_XdmsDiameterInstaller NumberTranslationProcess.SWI_NumberTranslationProcess CarrierSelectDataProcess.SWI_CarrierSelectDataProcess DialPlanProcess.SWI_DialPlanProcess ImrnAllocatorProcess.SWI_ImrnAllocatorProcess PbxProcess.SWI_StPbxProcess SS7MapDistributorProcess.SWI_SS7MapDistributorProcess SS7ReporterProcess.SWI_SS7ReporterProcess SipWorkerProcess.SWI_SipWorkerProcess SubscriberDataControlProcess.SWI_SubscriberDataControlProcess SctpOamProcess.SWI_SctpOamProcess |
|
Domains |
ims.mtas.errlog.sip ims.mtas.errlog.h248 ims.mtas.errlog.diam.sh ims.mtas.errlog.diam.rf ims.mtas.errlog.diam.ro ims.mtas.common.* ims.mtas.charging.common ims.mtas.if.* ims.mtas.ccmp.dispatcher ims.mtas.services.* ims.mtas.px.dispatcher ims.mtas.csi.* ims.mtas.mrfc.* ims.mtas.oam.* ims.mtas.sip.* ims.mtas.subscriberdata.* ims.mtas.utils.* ims.mtas.xdms.* ims.mtas.xdmsval.validation ims.mtas.tools.mprof ims.mtas.st.* |
6.3 Trace Profiles for Single Session Network Trace
Table 3 shows the preconfigured trace profiles for a single session network trace:
|
Profile Name |
MtasNetIoMinLevelOrigUser56 |
|
Description |
NetTrace, SIP signalling trace on minimum level including debug traces in human readable format. |
|
Trace level |
FORLOP (56) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew |
|
Domains |
ims.mtas.netio.info ims.mtas.netio.sip ims.mtas.common.utils ims.mtas.sip.dispatcher ims.mtas.sip.distributor ims.mtas.common.common |
|
Profile Name |
MtasNetIoMaxLevelOrigUser56 |
|
Description |
NetTrace, SIP signalling trace on maximum level including debug traces in human readable format. |
|
Trace level |
FORLOP (56) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew |
|
Domains |
ims.mtas.netio.info ims.mtas.netio.rx ims.mtas.netio.tx ims.mtas.common.utils ims.mtas.sip.dispatcher ims.mtas.sip.distributor ims.mtas.common.common |
|
Profile Name |
MtasNetTraceMinLevelOrigUser56 |
|
Description |
NetTrace, SIP signalling trace on minimum level including debug traces. |
|
Trace level |
FORLOP (56) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew |
|
Domains |
ims.mtas.nettrace.info ims.mtas.nettrace.sip ims.mtas.common.utils ims.mtas.sip.dispatcher ims.mtas.sip.distributor ims.mtas.common.common |
|
Profile Name |
MtasNetTraceMaxLevelOrigUser56 |
|
Description |
NetTrace, SIP signalling trace on maximum level including debug traces. |
|
Trace level |
FORLOP (56) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew |
|
Domains |
ims.mtas.nettrace.info ims.mtas.nettrace.rx ims.mtas.nettrace.tx ims.mtas.common.utils ims.mtas.sip.dispatcher ims.mtas.sip.distributor ims.mtas.common.common |
6.4 Trace Profiles for Live System Network Trace
Table 3 shows the preconfigured trace profiles for a live system network trace:
|
Profile Name |
MtasNetIoMinLevelOrigUser23 |
|
Description |
NetTrace, SIP signalling trace on minimum level in human readable format |
|
Trace level |
MAJOR (23) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew |
|
Domains |
ims.mtas.netio.info ims.mtas.netio.sip |
|
Profile Name |
MtasNetIoMaxLevelOrigUser23 |
|
Description |
NetTrace, SIP signalling trace on maximum level in human readable format. |
|
Trace level |
MAJOR (23) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew |
|
Domains |
ims.mtas.netio.info ims.mtas.netio.rx ims.mtas.netio.tx |
|
Profile Name |
MtasNetIoMinLevelTermUser23 |
|
Description |
NetTrace, SIP signalling trace on minimum level in human readable format. |
|
Trace level |
MAJOR (23) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess DistributorProcessNew.SWI_SipDistributorProcessNew |
|
Domains |
ims.mtas.netio.info ims.mtas.netio.sip |
|
Profile Name |
MtasNetIoMaxLevelTermUser23 |
|
Description |
NetTrace, SIP signalling trace on maximum level in human readable format. |
|
Trace level |
MAJOR (23) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew |
|
Domains |
ims.mtas.netio.info ims.mtas.netio.rx ims.mtas.netio.tx |
|
Profile Name |
MtasNetIoMinLevelOrigUserTermUser23 |
|
Description |
NetTrace, SIP signalling trace on minimum level in human readable format. |
|
Trace level |
MAJOR (23) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew |
|
Domains |
ims.mtas.netio.info ims.mtas.netio.sip |
|
Profile Name |
MtasNetTraceMaxLevelOrigUser23 |
|
Description |
NetTrace, SIP signalling trace on maximum level in machine-readable format |
|
Trace level |
MAJOR (23) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew |
|
Domains |
ims.mtas.nettrace.info ims.mtas.nettrace.rx ims.mtas.nettrace.tx |
|
Profile Name |
MtasNettraceMinLevelTermUser23 |
|
Description |
NetTrace, SIP signalling trace on minimum level in machine-readable format as defined by 3GPP. |
|
Trace level |
MAJOR (23) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew |
|
Domains |
ims.mtas.nettrace.info ims.mtas.nettrace.sip |
|
Profile Name |
MtasNettraceMaxLevelTermUser23 |
|
Description |
NetTrace, SIP signalling trace on maximum level in machine-readable format as defined by 3GPP. |
|
Trace level |
MAJOR (23) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew |
|
Domains |
ims.mtas.nettrace.info ims.mtas.nettrace.rx ims.mtas.nettrace.tx |
|
Profile Name |
MtasNettraceMinLevelOrigAndTerm23 |
|
Description |
NetTrace, SIP signalling trace on minimum level in machine-readable format as defined by 3GPP. Used for tracing call between specific users A and B. |
|
Trace level |
MAJOR (23) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew |
|
Domains |
ims.mtas.nettrace.info ims.mtas.nettrace.sip |
|
Profile Name |
MtasNettraceMaxLevelOrigAndTerm23 |
|
Description |
NetTrace, SIP signalling trace on maximum level in machine-readable format as defined by 3GPP. Used for tracing call between specific users A and B. |
|
Trace level |
MAJOR (23) |
|
Processes |
ApplicationProcess.SWI_ApplicationProcess SipDistributorProcessNew.SWI_SipDistributorProcessNew |
|
Domains |
ims.mtas.nettrace.info ims.mtas.nettrace.rx ims.mtas.nettrace.tx |
7 Example
As an example on how to start AppTrace, do the following:
- Note:
- The different processes and domains in the MTAS are shown in Section 4 AppTrace Process Types in MTAS and Section 5 AppTrace Domains in MTAS.
- Log on to any of the payloads in the cluster (PL-3 in the example below): ssh PL-3.
- Go to the AppTrace directory and start a new session:
cd /opt/lpmsv/bin/apptrace
./collect_domains.sh
./verify_domains.sh
Output example:
.......
ims.mtas.sip[abstract|OK]
ims.mtas.sip.dispatcher[concrete|OK]
ims.mtas.sip.distributor[concrete|OK]
ims.mtas.sip.sipstack[concrete|OK]
.......
SUMMARY: All domains verified OK
AppTrace verify_domains done - Begin the AppTrace session:
./begin_session.sh
Output example:
AppTrace begin_session done sessionId: 1264422676
- Trace on all processors (alternatively, specify the processor
to be traced):
./include_processors.sh -a
Output example:
Result from [.lpmsv.director.tutil]:AppTrace include_processors done
- Add process types:
add_process_type <PT1>[<PT2>...]
For example:
./add_process_type.sh ApplicationProcess.1060633
Output example:
AppTrace add_process_type done
- Add domains:
For forlop tracing insert:
./insert_expression.sh ims.mtas.log.start\(seek\(string\(<user@domain>\), \$FromID\)\) \=\> \$forlop\=\$forlop_set
For example:
./insert_expression.sh ims.mtas.log.start\(seek\(string\(7888005@\), \$FromID\)\) \=\> \$forlop\=\$forlop_set
For all other MTAS domains, insert:
./insert_expression.sh ims.mtas.sip.*
For example:
./insert_expression.sh ims.mtas.sip.* \=\> L\(\$id, \$forlop, \$Msg\)
Output example:
===Trace Program(simplified)===
[0]:ims.mtas.info
[1]:ims.mtas.log.start
[2]:ims.mtas.sip.dispatcher
[3]:ims.mtas.sip.distributor
[4]:ims.mtas.sip.sipstack
AppTrace insert_expression doneFor subscriber-specific domains, insert:
./insert_expression.sh ims.mtas.errlog.sip \(\$forlop \!\= 0\) \=\> L\(\$processorname, \$pid, \$date, \$time, \$id, \$forlop, \$FromID, \$Response, \$Reason, \$SessSide\)
Output example:
===Trace Program(simplified)===
[0]:ims.mtas.info
[1]:ims.mtas.log.start
[2]:ims.mtas.sip.dispatcher
[3]:ims.mtas.sip.distributor
[4]:ims.mtas.sip.sipstack
[5]:ims.mtas.errlog.sip AppTrace insert_expression done- Note:
- Output example [0]:ims.mtas.info, gives all trace variables.
To see all domains, enter:
./ls_domains.sh
To see all subdomains for a specific domain, enter the following (this is an example of the domain ims.mtas.sip.*):
./cat_domain.sh ims.mtas.sip
Output example:
Result from [.lpmsv.director.tutil]:
==============================================
---Domain ims.mtas.sip---
---Condition: [abstract|OK]
---Signatures:
---Output prefix:
---Parameter Types:NONE
---Parameter Names:
NONE
---Parameter Postfixes:
NONE
---Subdomains:
Subdomain:ims.mtas.sip.dispatcher
Subdomain:ims.mtas.sip.distributor
Subdomain:ims.mtas.sip.sipstack
---Errors:
NONE - Execute the AppTrace session:
./route_output.sh console
Output example:
AppTrace route_output command done
./display_session.sh
Output example:
Result from [.lpmsv.director.tutil]:
---Session 1414676139 is OPEN for editing
---general state:Clean
---Included processors:
SC-1
---Enable process types:
ApplicationProcess.1060633/1060633 located on:
SC-1
---Enable process instances:
NONE
---Trace program:
[0] ims.mtas.log.start() => L
Compiled: 1=>L($[0:48,0], $[0:0,0], $[0:1,0], $2)
[1] ims.mtas.log.start(seek(string(7888005@),$FromID)) => L
Compiled: seek([_7888005@],$[0:0,0])=>L($[0:48,0], $[0:0,0], $[0:1,0], $2)
[2] ims.mtas.log.start(seek(string(7888005@),$FromID)) => L
Compiled: seek([_7888005@],$[0:0,0])=>L($[0:48,0], $[0:0,0], $[0:1,0], $2)
[3] ims.mtas.sip.dispatcher() => L
Compiled: 1=>L($[0:48,0], $[0:0,0])
[4] ims.mtas.sip.distributor() => L
Compiled: 1=>L($[0:48,0], $[0:0,0])
[5] ims.mtas.sip.sipstack() => L
Compiled: 1=>L($[0:48,0], $[0:0,0])
[6] ims.mtas.sip.dispatcher() => L
Compiled: 1=>L($[0:48,0], $[0:0,0])
[7] ims.mtas.sip.distributor() => L
Compiled: 1=>L($[0:48,0], $[0:0,0])
[8] ims.mtas.sip.sipstack() => L
Compiled: 1=>L($[0:48,0], $[0:0,0])
---Routing of output:
To (buffered) console. Bytes/sec max:25000.
BuffSize/processor: 16384.
AppTrace display_session done - Upload the AppTrace session:
./upload_session.sh
Output example:
====Upload Session====
====Enabling Processes====
AppTrace upload_session done - Start tracing, for example, level DEBUG (55):
./start_trace.sh 56
Output example:
Trace level is 56 [trace events in ranges: debug, minor, major, and exceptional]
====Starting Trace====
AppTrace start_trace doneOutput of the trace shows in the console logs.
Output example:
2014-10-30 15:02:21.760 APP-TRACE: id:"ims.mtas.sip.dispatcher"
Msg:"2014-10-30 14:02:21.749 DEBUG
SipDispatcher.cc:773
SC-1 167 ApplicationProcess 00| mKey = [sip:A-TC_TCP_LMCOIR0010@ericsson.com]" - Stop the AppTrace session:
./stop_trace.sh
./unload_session.sh
./end_session.sh
The Console logs are stored in the /cluster/storage/no-backup/cdclsv/log/lpmsv directory. For more information about console logs, see MTAS Logs.