Versions Compared

Old Version 5

changes.mady.by.user Ribbon Communications

Saved on

compared with

New Version 6

changes.mady.by.user Ribbon Communications

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Noprint
Panel
borderColorgreen
bgColortransparent
borderWidth2

Back to Table of Contents

Back to CLI Configure Mode

Back to Global - CLI

...

Code Block
titleGlobal Call Trace Syntax
% set global callTrace 
	callFilter <callFilter_name> 
	callTraceTimer <1-360>
	errorFilter errorType <any | earlyAttempt | none | outOfDialog | parseError>
	maxTriggerCount <0-64>	
	signalingPacketCapture 
		devices <mgmt0 | mgmt1 | pkt0 | pkt1 | pkt2 | pkt3> <VLAN tag>
		filter <signaling trace filter name>
		signalingPacketCaptureTimer <0-360 seconds>
		state <disable | enable>

Call Filter Syntax

Code Block
titleCall Filter Syntax
% 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>

...

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. See Call Filter Parameters table below for details.

callTraceTimer1-360

Duration 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

Signaling Packet Capture configuration.

  • devices – Choose a port to perform signaling packet capture against.

      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).

      • filter – Enter the user name of this signaling trace filter.

      • signalingPacketCaptureTimer – Call trace timer for both call and error trace filters. (range: 0-360 seconds / default=180)

      • state – Use this flag to enable/disable Signaling Packet Captures.

        • disable (default)

        • enable

    Call Filter Parameters

    Caption
    0Table
    1Call Filter Parameters
    3Call Filter Parameters
     

    ...