Onboard Failure Logging Commands

Related Documents

This module describes the Cisco IOS XR7 Software commands used for viewing the onboard failure logging (OBFL) outputs on the router. OBFL gathers boot, environmental, and critical hardware data for field-replaceable units (FRUs), and stores the information in the nonvolatile memory of the FRU. This information is used for troubleshooting, testing, and diagnosis if a failure or other error occurs, providing improved accuracy in hardware troubleshooting and root cause isolation analysis. Stored OBFL data can be retrieved in the event of a failure and is accessible even if the card does not boot.

Because OBFL is on by default, data is collected and stored as soon as the card is installed. If a problem occurs, the data can provide information about historical environmental conditions, uptime, downtime, errors, and other operating conditions.


Note

OBFL is activated by default in all cards and cannot be disabled.

For detailed information about OBFL concepts, configuration tasks, and examples, see the Onboard Failure Logging chapter in the System Monitoring Configuration Guide for Cisco 8000 Series Routers.

clear logging onboard

To clear OBFL logging messages from a node or from all nodes, use the clear logging onboard command in XR EXEC mode.

clear logging onboard [location node-id]

Syntax Description

location node-id

(Optional) Clears OBFL messages from the designated node. The node-id argument is entered in the rack/slot/module notation.

Command Default

All OBFL logging messages are cleared from all nodes.

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the clear logging onboard command to clear OBFL messages from all nodes. Use the clear logging onboard command with the location node-id keyword and argument to clear OBFL messages for a specific node. If the specified node is not present, an error message is displayed.


Caution

The clear logging onboard command permanently deletes all OBFL data for a node or for all nodes. Do not clear the OBFL logs without specific reasons, because the OBFL data is used to diagnose and resolve problems in FRUs.


Caution

If OBFL is actively running on a card, issuing the clear logging onboard command can result in a corrupt or incomplete log at a later point in time. OBFL should always be disabled before this command is issued.

Task ID

Task ID

Operations

logging

read

In the following example, the OBFL data is cleared for all nodes in the system: 


Router# clear logging onboard
Remove all onboard failure log files for 0/RP0/CPU0? [confirm] y
Router#

show logging onboard

To display the onboard failure logging (OBFL) messages, use the show logging onboard command in XR EXEC mode.

show logging onboard { alarm | current | fpd | inventory | npu | temperature | uptime | voltage } [ location node-id ] [verbose]

Syntax Description

alarm

Displays the OBFL alarm information.

current

Displays the OBFL electric current sensor data..

fpd

Displays the OBFL FPD data information.

inventory

Displays the OBFL inventory data information.

npu

Displays the OBFL NPU lifetime data.

temperature

Displays temperature information.

uptime

Displays the OBFL uptime.

voltage

Displays voltage information.

location node-id

(Optional) Displays OBFL messages from the designated node. The node-id argument is entered in the rack/slot/module notation.

Command Default

None

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the show logging onboard command to display all logging messages for OBFL.

To narrow the output of the command, enter the show logging onboard command with one of the keyword.

Use the location node-id keyword and argument to display OBFL messages for a specific node.

Task ID

Task ID

Operations

logging

read

This example displays uptime information from the OBFL feature: 

Router# show logging onboard uptime
OBFL uptime information for: 0/RP0/CPU0
    * indicates incomplete time-sync while record was written
    ! indicates time reset backwards while system was running
--------------------------------------------------------------------------------
    Entity Name                    : Value
--------------------------------------------------------------------------------
    UPTIME CARD INFORMATION        
--------------------------------------------------------------------------------
    Previous Chassis SN            : FOC2325NREU
    Current Chassis SN             : FOC2325NREU
    Previous R/S/I                 : -/-/-
    Current R/S/I                  : 0/0/0
    Write Interval                 : 15 (min)
    First Power On TS              : 07/02/2019 02:49:13
    Last Erase TS                  : 03/03/2020 02:46:46
    Rack Change Count              : 0
    Slot Change Count              : 0
    Last Reset Reason              : 0
--------------------------------------------------------------------------------
    UPTIME INFORMATION             
--------------------------------------------------------------------------------
    Start Time (UTC)    | End Time (UTC)      | Card Uptime info
    mm/dd/yyyy hh:mm:ss | mm/dd/yyyy hh:mm:ss | Weeks.Days.Hrs.Min.Sec
--------------------------------------------------------------------------------
    02/29/2020 02:08:18 | 03/03/2020 16:39:00 | 0.3.14.30.42