Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

request flight-recorder set high-cpu

 

Syntax

Release Information

Command introduced in Junos OS Release 18.2R1 on all platforms.

Description

Enable flight recorder tool to collect snapshots of historical data on when the CPU utilization for the routing protocol process on a device was high and what processes caused the high utilization. The detection of high CPU usage enables faster resolution of issues.

The recorded snapshots and core files are saved as log files in a folder under the /var/log/flight_recorder/ directory. The log files are listed in the order of time stamp saved. The folder format is Flr_MONTH_DD_YYYY_HH:MM:SS; for example, Flr_May_09_2018_02:20:50. Each log file in the directory includes the following information:

  • Output from the show task accounting detail command (after enabling and waiting for 10 seconds).

  • Output from the show task jobs command.

  • Running core data stored in a separate core log file, if enabled.

Options

noneEnable flight recorder tool to collect snapshots of data used for detecting high CPU utilization. The recorded snapshots and core files are saved as log files in a folder under the /var/log/flight_recorder/.
disableDisable flight recorder tool that has been enabled using the request flight-recorder set high-cpu command.

Default: Disabled.

backoff-duration seconds(Optional) Specify the time interval in seconds between two snapshots of data.

Default: 100 seconds.

Range: 10 through 1000.

collect-core(Optional) Perform snapshot collection of the running core with every snapshot of data taken.

When the collect-core option is enabled, the data snapshots are stored in a separate core log file in a folder under the /var/log/flight_recorder/ directory. The folder format is Flr_MONTH_DD_YYYY_HH:MM:SS; for example, Flr_May_09_2018_02:20:50.

Default: Disabled.

cpu-threshold percentage(Optional) Specify the maximum value of CPU utilization in percentage, beyond which the collection of data is triggered.

Default: 80

Range: 1 through 400.

logical-system(Optional) Enable data collection on logical systems.

Default: Disabled.

num-snapshots number(Optional) Specify the number of snapshots of data to be collected before quitting the collection process.

Default: 0

Range: 1 through 20

polling-frequency seconds(Optional) Specify the time in seconds for polling for high CPU utilization.

Default: 10 seconds.

Range: 5 through 100.

Required Privilege Level

root

Related Documentation

List of Sample Output

request flight-recorder set high-cpu (Enable flight-recorder)

request flight-recorder set high-cpu disable (When flight-recorder is enabled)

request flight-recorder set high-cpu disable (When flight-recorder is disabled)

Output Fields

When you enter this command, you are provided feedback on the status of your request.

Sample Output

request flight-recorder set high-cpu (Enable flight-recorder)

user@host> request flight-recorder set high-cpu cpu-threshold 10 polling-frequency 5 backoff-duration 10 collect-core num-snapshots 1

request flight-recorder set high-cpu disable (When flight-recorder is enabled)

user@host> request flight-recorder set high-cpu disable

request flight-recorder set high-cpu disable (When flight-recorder is disabled)

user@host> request flight-recorder set high-cpu disable