13. call-trace Commands

configure
— apply-groups reference
— apply-groups-exclude reference
buffering boolean
location keyword
admin-state keyword
— apply-groups reference
— apply-groups-exclude reference
size-limit (number | keyword)
max-files-number number
primary-cf keyword
trace-profile string
gx boolean
gy boolean
ludb boolean
msap boolean
nasreq boolean
ppp-event boolean
python boolean
radius-acct boolean
radius-auth boolean
— apply-groups reference
— apply-groups-exclude reference
description string
events keyword
output
debug
live
fqdn string
ip-address (ipv4-address-no-zone | ipv6-address-no-zone)
port number
router-instance string
size-limit number
time-limit number

13.1. call-trace Command Descriptions

call-trace

Synopsis

Enter the call-trace context

Description

Commands in this context configure the attributes of the call trace debugging functionality.

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

buffering boolean

Synopsis

Buffer messages until the trace key is known

Tree
Description

When configured to true, the router buffers initial messages for sessions where the trace key is not yet known, for example, a username for a PPP session.

When the trace key, for example, a username, indicates a match for a traced session, the router sends the buffered messages immediately. If the key does not match a trace, the router discards the buffered messages.

When configured to false, the router does not buffer any messages and therefore initial messages may not be traced.

Default

false

Introduced

20.5.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

location [location-type] keyword

Synopsis

Enter the location list instance

Context
Tree
Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

[location-type] keyword

Synopsis

ID of the compact flash card to be used

Context
Options

cf1, cf2

Notes

This element is part of a list key.

Introduced

16.0.R4

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

admin-state keyword

Synopsis

Administrative state of compact flash for log storage

Context
Default

enable

Options

enable, disable

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

size-limit (number | keyword)

Synopsis

Maximum cumulative size of call trace files on the card

Context

configure call-trace location keyword size-limit (number | keyword)

Range

1 to 65536

Default

1000

Options

unlimited

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

max-files-number number

Synopsis

Maximum number of call trace files that can be created

Range

1 to 1024

Default

200

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

primary-cf keyword

Synopsis

Primary CF card as local storage location

Default

cf1

Options

cf1, cf2

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

trace-profile [name] string

Synopsis

Enter the trace-profile list instance

Description

Commands in this context configure the attributes of the call-trace profile list.

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

[name] string

Synopsis

Call trace profile name

String Length

1 to 32

Notes

This element is part of a list key.

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

applications

Synopsis

Enter the applications context

Description

Commands in this context configure call trace attributes for the specified application.

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

connectivity-management boolean

Synopsis

Trace messages used for connectivity protocols

Description

When configured to true, this command enables call trace for connectivity protocols, such as DHCP, ARP, and DHCPv6, and events related to connectivity management; for example, migrant or data-triggered host creation, idling, or session timeout.

When configured to false, connectivity protocols are not traced.

Default

true

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

gx boolean

Synopsis

Trace Diameter messages used for the Gx application

Tree
Description

When configured to true, this command enables call trace for Diameter messages used for the Gx application.

When configured to false, Diameter Gx messages are not traced.

Introduced

21.5.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

gy boolean

Synopsis

Trace Diameter messages used for the Gy application

Tree
Description

When configured to true, this command enables call trace for Diameter messages used for the Gy application.

When configured to false, Diameter Gy messages are not traced.

Introduced

21.5.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

ludb boolean

Synopsis

Trace local user database lookups

Tree
Description

When configured to true, this command enables call trace for Local User Data Base (LUDB) lookups. 

When configured to false, LUDB lookups are not traced.

Default

true

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

msap boolean

Synopsis

Trace MSAP creation events

Tree
Description

When configured to true, this command enables tracing of Managed Service Access Point (MSAP) creation events.

When configured to false, MSAP create events are not traced.

Default

true

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

nasreq boolean

Synopsis

Trace Diameter messages used for NASREQ application

Tree
Description

When configured to true, this command enables call trace for Diameter messages used for the Diameter Network Access Server Requirements (NASREQ) application.

When configured to false, Diameter NASREQ messages are not traced.

Introduced

21.5.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

ppp-event boolean

Synopsis

Allow tracing for PPP state machine related events

Tree
Description

When configured to true, events related to the PPP state machine are traced.

This configuration may result in a large amount of event messages.

When configured to false, tracing is not activated for PPP state machine events.

Default

false

Introduced

20.5.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

python boolean

Synopsis

Trace Python script execution

Tree
Description

When configured to true, this command enables tracing of Python script execution.

When configured to false, Python script execution is not traced.

Default

true

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

radius-acct boolean

Synopsis

Trace messages and events for RADIUS-based accounting

Description

When configured to true, this command enables tracing of messages and events related to RADIUS-based accounting.

When configured to false, RADIUS-based accounting messages and events are not traced.

Default

true

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

radius-auth boolean

Synopsis

Trace RADIUS authentication messages and events

Description

When configured to true, this command enables tracing of messages and events related to RADIUS authentication, including CoA and Disconnect.

When configured to false, messages and events related to RADIUS authentication are not traced.

Default

true

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

description string

Synopsis

Text description

String Length

1 to 80

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

events keyword

Synopsis

Events to include in the captured trace

Context
Tree
Options

public-only, all

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

output

Synopsis

Enter the output context

Tree
Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

debug

Synopsis

Enable output to the debug log

Tree
Notes

The following are part of a choice: debug, live, or local-storage.

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

live

Synopsis

Enable the live context

Tree
Notes

The following are part of a choice: debug, live, or local-storage.

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

fqdn string

Synopsis

Fully qualified domain name of live output destination

Tree
String Length

1 to 255

Notes

The following are part of a mandatory choice: fqdn or ip-address.

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

ip-address (ipv4-address-no-zone | ipv6-address-no-zone)

Synopsis

IP address of the live output destination server

Context

configure call-trace trace-profile string output live ip-address (ipv4-address-no-zone | ipv6-address-no-zone)

Notes

The following are part of a mandatory choice: fqdn or ip-address.

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

port number

Synopsis

TCP IP port

Tree
Range

1 to 65536

Default

29770

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

router-instance string

Synopsis

Router instance or VPRN service name

Default

Base

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

local-storage

Synopsis

Default destination for output

Notes

This element is the default part of a choice.

The following are part of a choice: debug, live, or local-storage.

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

size-limit number

Synopsis

Maximum data output for a single call trace operation

Range

1 to 1000

Default

10

Units

megabytes

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s

time-limit number

Synopsis

Maximum time for a single call trace job

Range

1 to 604800

Default

86400

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR-7/12/12e, 7750 SR-a, 7750 SR-e, 7750 SR-2s, 7750 SR-7s, 7750 SR-14s