Panel | ||||
---|---|---|---|---|
In this section:
|
Use the Configure Trace and Media Packet Capture window to both configure Call Trace Filters and to initiate call traces to use in debugging policy and call routing issues.
The SBC supports logging PES call trace messages in the tracing files (.TRC
). Trace information is used for debugging policy and routing of a call. Processing information such as pre-processing, applying services, routing, and post processing is logged. For identifying traces of a call, the call identifier is also logged in the .TRC
file.
...
On the SBC main screen, go to Troubleshooting > Call Trace/Logs/Monitors > Call Trace and Packet Capture > Call Trace. The Configure Trace and Media Packet Capture window opens.
Caption | ||||||
---|---|---|---|---|---|---|
| ||||||
|
There are two panels in this window: the Call Trace Status and Setting panel and the Call Trace Filters panel. The Call Trace Filters panel lists any existing Call Trace Filters.
Call Trace Filters define conditions that determine which call events trigger logging PES call trace messages to the system trace data event log. When a call meets the criteria, the trace information is written to a tracing file (.TRC
). The following default information is collected during a call trace:
...
Warning | ||
---|---|---|
| ||
Do not configure a Call Trace Filter |
...
to |
...
trace all calls. Use of the Call Trace feature can have significant impact on the network performance of the
|
Info | ||
---|---|---|
| ||
Only |
When a call trace filter is created, call trace is started, and a call fulfills the filter criteria, the trace information is written to a tracing file (.TRC
). Call trace can be started and stopped from the Call Trace > Configure Trace and Media Packet Capture screen. The trace continues running until the specified duration or number of call filter matches is reached.
The Call Trace feature supports to:
...
Administrators, Field Service, Guests and Operators have the ability to access the Call Trace |
...
configuration screen. |
...
You must create Call Trace Filters before you can start a call trace. |
The Call Trace Filter object allows you to create and configure Call Trace Filters that specify criteria that the SBC uses to determine which call events
...
to
...
trace
...
.
Navigation Path:
On the SBC main screen, navigate to Troubleshooting > Call Trace/Logs/Monitors > Call Trace and Packet Capture > Call Trace. The Configure Trace and Media Packet Capture window appears.
Caption | ||||
---|---|---|---|---|
| ||||
There are two panels for this window: Call Trace Status and Setting panel and Call Trace Filters panel.
Info |
---|
You need to create Filters first or use the created Filters to start a Call Trace on it. |
On the SBC main screen, navigate to Troubleshooting > Call Trace/Logs/Monitors > Call Trace and Packet Capture > Call Trace. The Configure Trace and Media Packet Capture window appears.The second panel reflects the Filter entries in it.
Caption | ||||
---|---|---|---|---|
| ||||
Anchor | ||||
---|---|---|---|---|
|
To create a new Call Trace Filter, click New Call Filter
...
on the Call Trace Filters panel.
...
Caption | ||||
---|---|---|---|---|
| ||||
The Create New Call Trace Filter window
...
opens.
Caption | ||||
---|---|---|---|---|
|
...
| |
Enter values for the Call Trace Filter object using the following table and click Save.
...
Caption | ||||
---|---|---|---|---|
| ||||
Parameter | Description |
---|---|
Name | Specifies the name of the Call Trace |
...
Filter of up to 23 characters. | |
State | Specifies the state of this filter. The options are:
|
...
| |
Capture type | Specifies the type of |
...
logs to capture while running |
...
a Call Trace. The options are: |
...
|
...
...
|
...
|
...
Detail level to log | Specifies the level of details that need to be capture in the log file when the trace is complete. The options are:
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
...
|
Note |
---|
The Level 4 log is implemented to capture SIP Ladder diagrams for the interpretation of calls. |
Capture calls that match these filters | Specifies |
...
the criteria to use determine which calls to capture in the logs in a Call Trace (these are optional). The options are: Called |
...
number: Specifies the called party number to trace. |
...
Field length is up to 30 characters. Calling number: Specifies the calling party number to trace. Field length is up to 30 characters. Contractor number: Specifies the contractor number to trace. Field length is up to 30 characters. Redirecting number: Specifies the redirecting number to trace. Field length is up to 30 characters. CDDN number: Specifies the Called Directory Number to trace. Field length is up to 30 characters. NOTE: For the preceding options, the following characters are accepted by the SBC when specifying |
...
Call Trace Filter |
...
criteria:
|
...
Wilcard characters (“x” or “X”) to match any single digit within the search string
...
Wilcard symbol (%) to match any digits from that point forward
Contractor Number:
Specifies the contractor number to trace. An X or x means accept anything in that digit position. For example, 617xxx1212 would filter for all numbers 6170001212 through 6179991212. The % symbol acts as a wildcard for all remaining digits. For example, use 978% to trace all calls with a 978 prefix. Field Length is upto 30 characters.
Wildcard matching is also supported. Use |
...
"X" or "x" wildcard |
...
character to match any single digit, and "%" symbol to match any digits from that point forward. |
...
For example, |
...
using "978xxx1212" returns all calls between 9780001212 and 9789991212, and using "978%" returns all calls with a 978 prefix. |
...
Transfer capability: Specifies the transfer capability of the call trace filter. Options are:
|
...
Trunk Group: The name of a trunk group to filter the calls to trace. This string must match the trunk group name exactly. You cannot use wildcard characters for this argument. Field |
...
length is |
...
up to 23 characters. Peer IP |
...
address: Specifies the peer IpV4 or IpV6 |
...
address for call tracing. |
...
Stop Match | Specifies the |
...
condition to stop |
...
matching filters. The options are:
|
Info | ||
---|---|---|
| ||
As a general rule, set the Call Trace Filter for the ingress side except for the Called number. |
To edit any of the Call Filter entries in the list, click the radio button next to the specific Call Filter entry.
Caption | ||||
---|---|---|---|---|
| ||||
...
Select an existing Call Trace Filter object by clicking the radio button adjacent to it in the Call Trace Filters window. The Edit Call Trace Filter window is displayed
...
.
...
...
...
...
...
Caption | ||||
---|---|---|---|---|
| ||||
...
...
...
Caption | ||||
---|---|---|---|---|
| ||||
...
...
Caption | ||||
---|---|---|---|---|
| ||||
...
...
...
...
...
...
...
Confirm the deletion when prompted
Caption | ||||
---|---|---|---|---|
| ||||
Click Delete at the end of the highlighted row. A delete confirmation message appears seeking your decision.
Caption | ||||
---|---|---|---|---|
| ||||
...
.
Anchor | ||||
---|---|---|---|---|
|
Call Trace Status and Settings panel allows you to perform a Call Trace. It allows you to Start, Save and Stop the traces on the selected filters.
...
Once you have one or more Call Trace Filters created, call traces can be started and stopped from the top panel of the Configure Trace and Media Packet Capture window. See the earlier figure of the Configure Trace and Media Packet Capture window
...
. There you can start, save and stop traces using the enabled filters. The trace continues running until a specified duration elapses or the specified number of call filter matches is reached.
Info | ||
---|---|---|
| ||
When you start a trace, by default, the first three enabled filters in the table are used for the trace. |
In
Caption | ||||
---|---|---|---|---|
| ||||
...
the Call Trace Status and Settings panel, choose the required conditions for the trace using the following table.
Caption | ||||
---|---|---|---|---|
|
...
|
...
Parameter | Description |
---|---|
Call Trace Duration | Specifies the duration for the Call Trace to run |
...
. The options are:
|
...
| |
Number of Matches (optional) | Specifies the maximum number of |
...
calls to match before stopping the trace. The value ranges from 1 to 64 times. |
Trace Calls with errors of the type |
...
Check this object to |
...
enable specifying a system-wide call trace error filter trigger criteria. |
...
By default the option is unchecked which means there is no SIP PDU logging for this error filter. After checking the option the following options are available:
For further details on error logs, see the section Call Trace Log Messages. | ||||||
Call Trace Status | Displays the current status of the Call Trace.
|
...
|
...
|
...
|
...
Follow these simple steps to run a Call Trace on a selected filter:
...
|
Click Save & Start Trace
...
to start the trace. The trace status is displayed in the same panel.
...
Note |
---|
When you start the trace, by default, the first three enabled filters in the table are used for the trace. |
Caption | ||||
---|---|---|---|---|
| ||||
The trace stops automatically if
...
a time limit is specified, otherwise you must stop the trace manually by clicking Stop Trace.
Caption | ||||
---|---|---|---|---|
|
...
Once the trace is complete, the logs are generated and stored at Log Management. Look for TRC and PKT log files (.trc and .pkt log files). For more details on log messages, see the section Call Trace Log Messages.
Anchor | ||||
---|---|---|---|---|
|
Include Page | ||||
---|---|---|---|---|
|
...
Multiexcerpt-include |
---|
...
|
...
Pagebreak |
---|
...