You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

In this section:

Call Trace Filtering

The global Call Trace command allows you to create and configure Call Trace Filters using criteria to determine call events added to the system trace data event log (which uses the ".TRC" file extension). The first three Call Trace filters are logged unless the stopMatch flag in enabled (whereby the number of filters logged may be less than three). The stopMatch flag will halt filter profile matching once a match is found.

The maxTriggerCount parameter is used to set/reset the Trigger Count, a mechanism used to limit the logging of call/error filter events in the .TRC file.

Please note that a system reboot, an application restart or a Live Software Upgrade (LSWU) causes the following call trace filters to go offline:

  • callFilter
  • callFilter/mediaPacketCapture
  • callFilter/callDetailCapture
  • signalingPacketCapture

To rectify this, disable and then re-enable the applicable filters using the following CLI command syntax:

% set global callTrace signalingPacketCapture state disable 
% set global callTrace signalingPacketCapture state enable
% set global callTrace
   callFilter <filterName> state disabled
% set global callTrace callFilter <filterName> state enabled
% set global callTrace callFilter <filterName> mediaPacketCapture disable
% set global callTrace callFilter <filterName> mediaPacketCapture enable
% set global callTrace callFilter <filterName> callDetailCapture disable
% set global callTrace callFilter <filterName> callDetailCapture enable
As a general rule, set Call Trace to ingress mode unless egress mode is specified.

Do not turn on the Call Trace Filter to trace all calls. Use of the Call Trace feature can have significant impact on the network performance of the 

Unable to show "metadata-from": No such page "_space_variables"
system. 
Unable to show "metadata-from": No such page "_space_variables"
strongly recommends configuring Call Filters which result in small quantities of calls being traced to avoid heavy loads. Also, be sure to delete Call Trace Filters once you have obtained the necessary information.


Use the following criteria to establish a Call Trace Filter:

  • Called Party Number
  • Calling Party Number
  • Contractor Number
  • Peer IP Address
  • Redirecting Number
  • Transfer Capability
  • Trunk Group

Use the match keyword to specify criteria to use to capture call data upon a match. Use the key keyword to specify criteria on which to filter call data.
Call events captured are:

  • Call attempt
  • Lookup request sent
  • Lookup request received
  • Alerting received
  • Cut-through received
  • Call Answer received
  • Cut-through complete
  • Service established
  • Disconnect Request received
  • Call terminated
  • Wait for more digits
  • Extra digits receiveda
  • Initiating new attempt
  • Signal messages received or sent
  • Egress call setup message
  • Route lookup failure
  • Call blocked
  • Policy Request
  • Policy Response
  • Policy processing of calls in different layers like pre-processor, services, pre-router, router, and post-router.
  • SIP signaling events for a single call incoming/outgoing to a particular source/destination IP endpoint
  • SIP Protocol Data Units (PDUs) for a single call incoming/outgoing from/to a particular source/destination IP endpoint
  • SIP out-of-dialog PDUs such as 18X, BYE, and INFO, regardless of whether they are successfully parsed

The TRC event log level must be info for this facility to operate properly.

Use the maxTriggerCount parameter to limit the logging of call/error filter events in the .TRC file. After configuring and enabling the callFilter, an ingress/egress call that matches the filter criteria causes the corresponding events to be logged to the .TRC file, as long as the Trigger Count has not been reached. Once the configured Trigger Count has been reached, the matching callFilter will not be triggered and events associated with the call trace filter will not be logged in the .TRC file. To re-enable triggering, you must configure the Trigger Count to a nonzero value less than 65.

Once the maxTriggerCount is reached or callTraceTimer expires, the call trace stops. To restart the call trace without changing the callTrace configuration, use following CLI command:

% request global callTrace action command start 

This command is only exposed after callTrace configuration is performed. If no entries are present in the callTrace, this command is not available from CLI.

Command Syntax

Use following CLI syntax to configure call trace filters:

% set global callTrace 
	callFilter <callFilter_name> 
		callDetailCapture <disable|enable>
   		key <called | calling | cddn | contractor | peerIpAddress | redirecting | transferCapability | trunkGroup>
		level <level1 | level2 | level3 | level4>
   		match
			called <string>
			calling <string>
			cddn <string>
			contractor <string>
			peerIpAddress <IP address>
			redirecting <string>
			transferCapability <audio31Khz | speech | unrestricted | unrestrictedWithTones | video>
			trunkGroup <trunkGroup_name>
		mediaPacketCapture <disable|enable>
		state <disabled|enabled>
  		stopMatch <supported | unsupported>
	callTraceTimer <1-360>
	errorFilter errorType <any | earlyAttempt | none | outOfDialog | parseError>
	maxTriggerCount <0-64>
	signalingPacketCapture
		devices <mgmt0 | mgmt1 | pkt0 | pkt1 | pkt2 | pkt3> <VLAN tag>
The default value for vlanTag is "0". If you want to configure VLAN and capture the packets on a specific VLAN, you must provide the devices name and the vlanTag value.


To configure signaling state:

% set global callTrace signalingPacketCapture state <enable | disable> 

Command Parameters

Global Call Trace Parameters

Parameter

Length/Range

Description

callFilter

1-23

The name of a call trace filter to apply to the system trace data log file. This filter may be created, configured, and deleted.

  • callDetailCaptureSpecifies whether the call details are captured or not. These files will be saved as ".out" files.
    • disable (default)
    • enable
  • key – Choose one or more active key components for this filter (called | calling | cddn | contractor | peerIpAddress | redirecting | transferCapability | trunkGroup).
  • level The trace level of this call trace entry.

    • level1 – Trace everything.
    • level2 (default) – Trace everything but raw hex dumps.
    • level3 – Trace only external message information (ISDN/ ISUP/CAS etc.) and errors.
    • level4Trace all SIP Protocol Data Unit (PDU) calls (without logging other trace messages) at the line-rate without any dropping any SIP PDUs.

      Level 4 Call Trace Filter conditions/behavior:

      • Level 4 filters based ONLY on peerIpAddress. This call trace method does not trace/filter based on trunk group, called number, calling number, etc.
      • Configure a Level 4 filter with a wildcard peerIpAddress of 255.255.255.255 to match ALL packets to/from any IP address.
      • Level 4 filters identify GCID when possible. However, some messages do not contain GCIDs and may have 0xfffffffff as the GCID (registration, notify, options ping, etc.).
  • match – Use this keyword to specify criteria to use to capture call data upon a match. Options are:

    • called – Called number being traced. (range: 0-30).
    • calling – Calling number being traced. (range: 0-30).
    • cddn – Called directory number being traced. (range: 0-30).
    • contractor – Contractor number being traced. (range: 0-30).

      For the above parameters, 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.
    • peerIpAddress – The peer IPv4 or IPv6 address for call tracing.
    • redirecting – The redirecting number being traced (default is "").
    • transferCapability– Transfer capability of the call trace filter. Options are:
      • audio31Khz – 3.1 kHz Audio – ITC 3.1 kHz audio calls are traced.
      • speech – ITC Speech based calls are traced.
      • unrestricted – (default) Calls with ITC Unrestricted are traced.
      • unrestrictedWithTones – Calls with ITC Unrestricted Digital Information With Tones Announcements are traced.
      • video – Calls with ITC Video are traced.
    • trunkGroup – Trunk group name to match against.
  • mediaPacketCapture– Specifies whether to enable or disable media packet capture settings. These files will be stored as ".pkt"files.
    • disable (default)
    • enable
      Note

      NICE and Media Packet Capture cannot be used simultaneously because the Splitter resource can only be configured for one feature.

  • stateAdministrative state of this filter:
    • disabled (default) – Call filter is off. In this state no calls will be traced by this filter. The filter must be in this state to change its configuration.
    • enabled – When enabled, all calls are processed by this filter for possible inclusion in the system trace data log file.
  • stopMatch –Use this flag to stop matching filter profiles once a match is found:
    • unsupported (default) – Continue matching filter profiles even after a match is found (up to three profiles can be matched).
    • supported – Stop matching filter profiles once a match is made.
callTraceTimer1-360Duration in minutes that call trace is enabled. (default = 180)

errorFilter

N/A

Call error trace for SIP Call Traces only.

  • errorType– Type of error to log:
    • any – Log all SIP PDUs that meet the requirement of the parseerror, outofdialog, and early attempt options below.
    • earlyattempt – Logs incoming SIP PDUs that result in early termination of the call (by either the pre-parser or SIP signaling).
    • none – (default) No SIP PDU logging, including validation/parsing errors.
    • outofdialog – Log incoming syntactically correct SIP PDUs (except INVITE) that do not belong to an existing dialog.
    • parsError – Log received SIP PDUs that fail parsing. If an error is detected by SIP signaling, the accompanying PDUs is not associated with any dialog, including an existing dialog. Hence all in dialog and out of dialog PDUs are assigned to this category. If an error is detected at the front end pre-parser, the PDU is logged and not forwarded to SIP signaling to prevent logging an offending PDU by both the pre-parser and SIP signaling.

maxTriggerCount

0-64

Maximum number of calls that match the callFilter criteria and the errorFilter type that may be logged to the .TRC file, per slot. When this limit is reached on a module in a particular slot, this parameter value becomes 0 and matching events are no longer logged. To re-enable logging, you must issue a CLI command that configures this parameter to a nonzero value (default = 0).

signalingPacketCapture

N/A

Specifies the signaling packet capture devices and the admin state. These files are saved as .pkt files. The options are:

  • devices– List of devices for signaling packet capture. The options are:
    •  mgmt0
    • mgmt1
    • pkt0
    • pkt1
    • pkt2
    • pkt3
  • <VLAN tag> – Enter VLAN tag of the device used for signaling capture (or enter "0" for no VLAN).

Command Examples

To enable call tracing based on the called number:

% set global callTrace callFilter CF-1 level level1 state enabled key called,calling match called 978%  
% set global callTrace callFilter CF-1 mediaPacketCapture enable  
% set global callTrace callFilter CF-1 callDetailCapture enable

To view the recently-enabled call trace filter:

% show table global callTrace callFilter  
   callFilter CF-1 {  
	state enabled;  
	level level1;  
	key called,calling; 
	match {  
		called 978%;  
	}  
	mediaPacketCapture enable;  
	callDetailCapture enable;

To enable signaling packet capture:

% Set global callTrace signalingPacketCapture state enable

Offline Call Trace Analysis Using LX Utility

  • No labels