Onboard Failure Logging Commands

Related Documents


Note

  • Starting with Cisco IOS XR Release 6.6.25, all commands applicable for the Cisco NCS 5500 Series Router are also supported on the Cisco NCS 560 Series Routers.

  • Starting with Cisco IOS XR Release 6.3.2, all commands applicable for the Cisco NCS 5500 Series Router are also supported on the Cisco NCS 540 Series Router.

  • References to releases before Cisco IOS XR Release 6.3.2 apply to only the Cisco NCS 5500 Series Router.

  • Cisco IOS XR Software Release 7.0.1 specific updates are not applicable for the following variants of Cisco NCS 540 Series Routers:

    • N540-28Z4C-SYS-A

    • N540-28Z4C-SYS-D

    • N540X-16Z4G8Q2C-A

    • N540X-16Z4G8Q2C-D

    • N540X-16Z8Q2C-D

    • N540-12Z20G-SYS-A

    • N540-12Z20G-SYS-D

    • N540X-12Z16G-SYS-A

    • N540X-12Z16G-SYS-D

This module describes the Cisco IOS XR software commands used to configure onboard failure logging (OBFL) for system monitoring on the router. OBFL gathers boot, and environmental factors failure 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.

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

All commands applicable for the Cisco NCS 5500 Series Router are also supported on the Cisco NCS 540 Series Router that is introduced from Cisco IOS XR Release 6.3.2. References to earlier releases in Command History tables apply to only the Cisco NCS 5500 Series Router.


Caution

OBFL is activated by default in all cards and should not be deactivated. OBFL is used to diagnose problems in FRUs and to display a history of FRU data.

For detailed information about OBFL concepts, configuration tasks, and examples, see the Onboard Failure Logging Services module in the System Monitoring Configuration Guide for Cisco NCS 5500 Series RoutersSystem Monitoring Configuration Guide for Cisco NCS 540 Series RoutersSystem Monitoring Configuration Guide for Cisco NCS 560 Series Routers.

For detailed information about logging concepts, configuration tasks, and examples, see the Implementing Logging Services module in the System Monitoring Configuration Guide for Cisco NCS 5500 Series RoutersSystem Monitoring Configuration Guide for Cisco NCS 540 Series RoutersSystem Monitoring Configuration Guide for Cisco NCS 560 Series Routers.

For alarm management and logging correlation commands, see the Alarm Management and Logging Correlation Commands module in the System Monitoring Command Reference for Cisco NCS 5500 Series Routers and Cisco NCS 540 and NCS 560 Series Routers.

For detailed information about alarm and logging correlation concepts, configuration tasks, and examples, see the Implementing Alarm Logs and Logging Correlation module in the System Monitoring Configuration Guide for Cisco NCS 5500 Series RoutersSystem Monitoring Configuration Guide for Cisco NCS 540 Series RoutersSystem Monitoring Configuration Guide for Cisco NCS 560 Series Routers.

show logging onboard

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

show logging onboard {diag_log | diag_result | fabric | fmea | fpd | inventory | temperature | uptime | voltage} [location node-id] [verbose]

Syntax Description

diag_log

Displays the OBFL diag logs data information.

diag_result

Displays the OBFL diag test results information.

fabric

Displays the OBFL fabric data information.

fmea

Displays the OBFL FMEA data information.

fpd

Displays the OBFL FPD data information.

inventory

Displays the OBFL inventory data information.

temperature

Displays temperature information.

uptime

Displays the OBFL uptime.

voltage

Displays voltage information.

Command Default

None

Command Modes

System Admin EXEC mode

Command History

Release

Modification

Release 6.0

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

Examples

This example displays uptime information from the OBFL feature: 

sysadmin-vm:0_RP0# show logging onboard uptime location 0/7