call-trace commands

configure 
   —  call-trace 
      —  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 
         —  applications 
            —  connectivity-management boolean
            —  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
            —  local-storage 
         —  size-limit number
         —  time-limit number
Parent topic: Configuration commands

call-trace command descriptions

call-trace

  Synopsis Enter the call-trace context
  Context configure call-trace
  Tree call-trace
 

Description

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

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

buffering boolean

  Synopsis Buffer messages until the trace key is known
  Context configure call-trace buffering boolean
  Tree buffering
 

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, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

location [location-type] keyword

  Synopsis Enter the location list instance
  Context configure call-trace location keyword
  Tree location
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
[location-type] keyword
  Synopsis Compact flash card to be used
  Context configure call-trace location keyword
  Options cf1, cf2
 

Notes

This element is part of a list key.
  Introduced 16.0.R4
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
admin-state keyword
  Synopsis Administrative state of compact flash for log storage
  Context configure call-trace location keyword admin-state keyword
  Tree admin-state
  Default enable
  Options enable, disable
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
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)
  Tree size-limit
  Range 1 to 65536
  Default 1000
  Options unlimited
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

max-files-number number

  Synopsis Maximum number of files call trace can create
  Context configure call-trace max-files-number number
  Tree max-files-number
  Range 1 to 1024
  Default 200
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

primary-cf keyword

  Synopsis Primary CF card as local storage location
  Context configure call-trace primary-cf keyword
  Tree primary-cf
  Default cf1
  Options cf1, cf2
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR

trace-profile [name] string

  Synopsis Enter the trace-profile list instance
  Context configure call-trace trace-profile string
  Tree trace-profile
 

Description

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

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
[name] string
  Synopsis Call trace profile name
  Context configure call-trace trace-profile string
  String Length 1 to 32
 

Notes

This element is part of a list key.
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
applications
  Synopsis Enter the applications context
  Context configure call-trace trace-profile string applications
  Tree applications
 

Description

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

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
connectivity-management boolean
  Synopsis Trace messages used for connectivity protocols
  Context configure call-trace trace-profile string applications connectivity-management boolean
  Tree connectivity-management
 

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, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
gx boolean
  Synopsis Trace Diameter messages used for the Gx application
  Context configure call-trace trace-profile string applications gx boolean
  Tree gx
 

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, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
gy boolean
  Synopsis Trace Diameter messages used for the Gy application
  Context configure call-trace trace-profile string applications gy boolean
  Tree gy
 

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, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ludb boolean
  Synopsis Trace local user database lookups
  Context configure call-trace trace-profile string applications ludb boolean
  Tree ludb
 

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, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
msap boolean
  Synopsis Trace MSAP creation events
  Context configure call-trace trace-profile string applications msap boolean
  Tree msap
 

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, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
nasreq boolean
  Synopsis Trace Diameter messages used for NASREQ application
  Context configure call-trace trace-profile string applications nasreq boolean
  Tree nasreq
 

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, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
ppp-event boolean
  Synopsis Allow tracing for PPP state machine related events
  Context configure call-trace trace-profile string applications ppp-event boolean
  Tree ppp-event
 

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, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
python boolean
  Synopsis Trace Python script execution
  Context configure call-trace trace-profile string applications python boolean
  Tree python
 

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, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
radius-acct boolean
  Synopsis Trace messages and events for RADIUS-based accounting
  Context configure call-trace trace-profile string applications radius-acct boolean
  Tree radius-acct
 

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, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
radius-auth boolean
  Synopsis Trace RADIUS authentication messages and events
  Context configure call-trace trace-profile string applications radius-auth boolean
  Tree radius-auth
 

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, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
description string
  Synopsis Text description
  Context configure call-trace trace-profile string description string
  Tree description
  String Length 1 to 80
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
events keyword
  Synopsis Events to include in the captured trace
  Context configure call-trace trace-profile string events keyword
  Tree events
  Options public-only, all
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
output
  Synopsis Enter the output context
  Context configure call-trace trace-profile string output
  Tree output
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
debug
  Synopsis Enable output to the debug log
  Context configure call-trace trace-profile string output debug
  Tree debug
 

Notes

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

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
live
  Synopsis Enable the live context
  Context configure call-trace trace-profile string output live
  Tree live
 

Notes

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

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
fqdn string
  Synopsis Fully qualified domain name of live output destination
  Context configure call-trace trace-profile string output live fqdn string
  Tree fqdn
  String Length 1 to 255
 

Notes

The following elements are part of a mandatory choice: fqdn or ip-address.
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
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)
  Tree ip-address
 

Notes

The following elements are part of a mandatory choice: fqdn or ip-address.
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
port number
  Synopsis TCP IP port
  Context configure call-trace trace-profile string output live port number
  Tree port
  Range 1 to 65536
  Default 29770
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
router-instance string
  Synopsis Router instance or VPRN service name
  Context configure call-trace trace-profile string output live router-instance string
  Tree router-instance
  Default Base
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
local-storage
  Synopsis Destination for output
  Context configure call-trace trace-profile string output local-storage
  Tree local-storage
 

Notes

This element is the default part of a choice.

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

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
size-limit number
  Synopsis Maximum data output for a single call trace operation
  Context configure call-trace trace-profile string size-limit number
  Tree size-limit
  Range 1 to 1000
  Default 10
  Units megabytes
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR
time-limit number
  Synopsis Maximum time for a single call trace job
  Context configure call-trace trace-profile string time-limit number
  Tree time-limit
  Range 1 to 604800
  Default 86400
  Units seconds
  Introduced 16.0.R1
 

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, VSR