How to troubleshoot call routing
From TBwiki
(Difference between revisions)
m (→Get the log files from the server) |
|||
| (11 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | {{DISPLAYTITLE:How to Troubleshoot Call Routing}} | |
| + | To debug calls, different methods can be used: <br> | ||
| − | + | == Using the Call Detail Records == | |
| − | This can be done in the configuration database, using RADIUS or in text files. See | + | This can be done in the configuration database, using RADIUS or in text files. See [[Call_detail_record|Call Detail Records (CDR)]] |
| − | <br> | + | == Using the Call Trace Tool <br> == |
| + | |||
| + | Call Trace was created to trace the callflow from any incoming call through the Tmedia system. It allows to see the incoming call, outgoing calls, TDM channel, SIP SDP and more. This can be accessed from the Web Portal. You can create a filter to see call information. See [[Using Unique call trace|Using Call Trace]].<br> | ||
| + | |||
| + | == <br> Using the web portal status == | ||
<pre>Status -> NAP -> Edit</pre> | <pre>Status -> NAP -> Edit</pre> | ||
You can see how many instantaneous calls incoming, outgoing, in the last hour, in the last 24 hours, etc. | You can see how many instantaneous calls incoming, outgoing, in the last hour, in the last 24 hours, etc. | ||
| − | <br> | + | == <br> Using the applications log files == |
| − | + | ||
| − | + | ||
| − | + | ||
<br>Brief details on the application: | <br>Brief details on the application: | ||
| Line 18: | Line 20: | ||
*'''toolpack_engine''' handles the protocols (SS7, SIP, ISDN, CAS, Sigtran, etc.) and media (RTP, TDM, tones, etc)<br> | *'''toolpack_engine''' handles the protocols (SS7, SIP, ISDN, CAS, Sigtran, etc.) and media (RTP, TDM, tones, etc)<br> | ||
*'''toolpack_sys_manager''' handles the configuration of the system | *'''toolpack_sys_manager''' handles the configuration of the system | ||
| − | *'''tboamapp''' controls the startup of the | + | *'''tboamapp''' controls the startup of the applications and system upgrades<br> |
*'''tbstreamserver''' is used for playing and recording files; by default this application is not started. See How to Start Stream Server | *'''tbstreamserver''' is used for playing and recording files; by default this application is not started. See How to Start Stream Server | ||
*'''tblogtrace''' are low-level logs coming from the Telecom platform | *'''tblogtrace''' are low-level logs coming from the Telecom platform | ||
| + | *'''tbsnmpagent/tbsnmpmux''' allows SNMP queries to unit | ||
| + | *'''tbuctwriter''' captures call traces | ||
| + | === <br> Change an Application log trace level === | ||
<br>You can change the trace level of the application here: | <br>You can change the trace level of the application here: | ||
| − | <pre>Applications-> | + | <pre>Applications-> [Application name] -> Advanced parameters -> Default Trace Level -> Save</pre> |
| − | And then activate the new configuration. | + | And then activate the new configuration. Trace level 3 for '''gateway '''and '''toolpack_engine''' application will give most of the required information.<br> |
| + | |||
| + | === <br> Get log files from web portal === | ||
| + | <pre>Maintenance -> Logs -> Select filename -> 2000 lines -> select Read</pre> | ||
| − | <br> | + | === <br> Get the log files from the server === |
| + | You can get the files directly from the server running Toolpack. Connect sFTP (for example using Winscp or filezilla) to the management port of the unit and get the files at this location: | ||
| + | <pre>/lib/tb/toolpack/setup/12358/2.9/apps/</pre> | ||
| − | + | == <br> Using the signaling traces == | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | <br> | + | |
You can get the signaling traces (SS7, ISDN and SIP) using the tbsigtrace program: [[Toolpack Debug Application:Tbsigtrace|using tbsigtrace]] | You can get the signaling traces (SS7, ISDN and SIP) using the tbsigtrace program: [[Toolpack Debug Application:Tbsigtrace|using tbsigtrace]] | ||
| − | <br> | + | == <br> Using the Toolpack programs backdoor tool == |
You can access to the toolpack applications directly by using the tbx_cli_tools_remote application. This application allows full control over any Toolpack application. This allows for example to view real time calls going through the Toolpack Engine. | You can access to the toolpack applications directly by using the tbx_cli_tools_remote application. This application allows full control over any Toolpack application. This allows for example to view real time calls going through the Toolpack Engine. | ||
Latest revision as of 13:57, 11 December 2018
To debug calls, different methods can be used:
Contents |
Using the Call Detail Records
This can be done in the configuration database, using RADIUS or in text files. See Call Detail Records (CDR)
Using the Call Trace Tool
Call Trace was created to trace the callflow from any incoming call through the Tmedia system. It allows to see the incoming call, outgoing calls, TDM channel, SIP SDP and more. This can be accessed from the Web Portal. You can create a filter to see call information. See Using Call Trace.
Using the web portal status
Status -> NAP -> Edit
You can see how many instantaneous calls incoming, outgoing, in the last hour, in the last 24 hours, etc.
Using the applications log files
Brief details on the application:
- gateway application is for high-level call routing, like called number, Network Access Points, routing scripts, regular expressions.
- toolpack_engine handles the protocols (SS7, SIP, ISDN, CAS, Sigtran, etc.) and media (RTP, TDM, tones, etc)
- toolpack_sys_manager handles the configuration of the system
- tboamapp controls the startup of the applications and system upgrades
- tbstreamserver is used for playing and recording files; by default this application is not started. See How to Start Stream Server
- tblogtrace are low-level logs coming from the Telecom platform
- tbsnmpagent/tbsnmpmux allows SNMP queries to unit
- tbuctwriter captures call traces
Change an Application log trace level
You can change the trace level of the application here:
Applications-> [Application name] -> Advanced parameters -> Default Trace Level -> Save
And then activate the new configuration. Trace level 3 for gateway and toolpack_engine application will give most of the required information.
Get log files from web portal
Maintenance -> Logs -> Select filename -> 2000 lines -> select Read
Get the log files from the server
You can get the files directly from the server running Toolpack. Connect sFTP (for example using Winscp or filezilla) to the management port of the unit and get the files at this location:
/lib/tb/toolpack/setup/12358/2.9/apps/
Using the signaling traces
You can get the signaling traces (SS7, ISDN and SIP) using the tbsigtrace program: using tbsigtrace
Using the Toolpack programs backdoor tool
You can access to the toolpack applications directly by using the tbx_cli_tools_remote application. This application allows full control over any Toolpack application. This allows for example to view real time calls going through the Toolpack Engine.
Select this to learn How to use tbx cli tools remote program.
Typical errors:
404 not found
