To display the
onboard logging information based on the error type, use the
show
logging
onboard command.
show logging onboard {boot-uptime | device-version | endtime | environmental-history | exception-log | kernel-trace | obfl-history | obfl-logs | stack-trace | starttime | status} [> | file | | type]
Syntax Description
boot-uptime
|
Displays
the onboard failure logging (OBFL) boot and uptime information.
|
device-version
|
Displays
the OBFL device version information.
|
endtime
|
Displays
the OBFL logs until the specified end time in the following format:
mm / dd / yy - HH : MM : SS
|
environmental-history
|
Displays
the OBFL environmental history.
|
exception-log
|
Displays
the OBFL exception log.
|
kernel-trace
|
Displays
the OBFL kernel trace information.
|
obfl-history
|
Displays
the OBFL history information.
|
obfl-logs
|
Displays
the OBFL technical support log information.
|
stack-trace
|
Displays
the OBFL kernel stack trace information.
|
starttime
|
Displays
the OBFL logs from the specified start time in the following format:
mm / dd / yy - HH : MM : SS
|
status
|
Displays the OBFL status enable or disable.
|
>
file
|
(Optional) Redirects the output to a file. See the “Usage Guidelines” section
for additional information.
|
|
type
|
(Optional) Filters the output. See the “Usage Guidelines” section for
additional information.
|
Command History
Release
|
Modification
|
5.2(1)N1(1)
|
This
command was introduced.
|
Usage Guidelines
The date and time
arguments for the
starttime and
endtime
keywords are entered as the date month/day/year (mm / dd / yy ), followed by a hyphen, and the time in 24-hour
format in hours:minutes:seconds (HH:MM:SS ). For example:
- starttime 03/17/08-15:01:57
- endtime 03/18/08-15:04:57
The valid values
for
file are as
follows:
- bootflash:
- ftp:
- scp:
- sftp:
- tftp:
- volatile:
The valid values
for
type are as
follows:
- begin [-i ] [-x ] [word ] —Begin with the line that matches the text.
- -i —Ignores the case difference when comparing the
strings.
- -x —Prints only the lines where the match is a
whole line.
- word —Specifies for the expression.
- count [> file |
|
type ] —Counts
number of lines.
- egrep |
grep
print-match —Egrep or Grep. Egrep searches for
lines of text that match more sophisticated regular expression syntax than
grep. Grep searches for lines of text that match one or many regular
expressions, and outputs only the matching lines.
- -A
num —Prints
the specifies number of lines of context after every matching line. Range: 1 to
999.
- -B
num —Prints
the specifies number of lines of context before every matching line. Range: 1
to 999.
- -c —Prints a total count of matching lines only.
- -i —Ignores the case difference when comparing the
strings.
- -n —Prints each match preceded by its line number.
- -v —Prints only the lines that contain no matches
for the
word
argument.
- -w —Prints only lines where the match is a complete
word.
- -x —Prints only the lines where the match is a
whole line.
- word —Specifies for the expression.
- exclude [-i ] [-x ] [word ] —Excludes the lines that match.
- -i —Ignores the case difference when comparing the
strings.
- -x —Prints only the lines where the match is a
whole line.
- word —Specifies for the expression.
- head [-n
num ] —Stream
Editor. The optional
-n
num keyword
and argument allow you to specify the number of lines to print. Range: 0 to
2147483647.
- include [-i ] [-x ] [word ] —Include the lines that match.
- -i —Ignores the case difference when comparing the
strings.
- -x —Prints only the lines where the match is a
whole line.
- word —Specifies for the expression.
- last
num ]
—Displays the last lines to print. The optional
num specifies
the number of lines to print. Range: 0 to 9999.
- less
[-E |
-d ]—Quits at
the end of the file.
- -E —(Optional) Quits at the end of the file.
- -d —(Optional) Specifies a dumb terminal.
- no-more —Turns-off pagination for command output.
- sed
command —Stream Editor
- wc —Counts words, lines, and characters.
- -c —(Optional) Specifies the output character
count.
- -l —(Optional) Specifies the output line count.
- -w —(Optional) Specifies the output word count.
- > —Redirects it to a file.
- | —Pipes command output to filter.
Use this command
to view OBFL data from the system hardware. The OBFL feature is enabled by
default and records operating temperatures, hardware uptime, interrupts, and
other important events and messages that can assist with diagnosing problems
with hardware cards or modules installed in a Cisco router or switch. Data is
logged to files stored in nonvolatile memory. When the onboard hardware is
started up, a first record is made for each area monitored and becomes a base
value for subsequent records.
The OBFL feature
provides a circular updating scheme for collecting continuous records and
archiving older (historical) records, ensuring accurate data about the system.
Data is recorded in one of two formats: continuous information that displays a
snapshot of measurements and samples in a continuous file, and summary
information that provides details about the data being collected. The message
“No historical data to display” is seen when historical data is not available.
Examples
This example
shows how to display the OBFL boot and uptime information:
switch# show logging onboard boot-uptime
----------------------------
OBFL Data for
Module: 0
----------------------------
Sun Dec 16 16:03:39 2012: Boot Record
-------------------------------------------------------------------------------
Boot Time..........: Sun Dec 16 16:03:39 2012
Module Number......: 1
Serial Number......: FOC16191MQ1
Bios Version.......:
Firmware Version...:
Sun Dec 16 16:44:08 2012: Boot Record
-------------------------------------------------------------------------------
Boot Time..........: Sun Dec 16 16:44:07 2012
Module Number......: 0
Serial Number......: FOC16192WJZ
Bios Version.......: v1.2.0(06/09/12)
Firmware Version...: 6.0(2)N1(1) [build 6.0(2)N1(0.365.5P)]
--More--
Table 1 describes
the significant fields shown in the display.
Table 1. show logging
onboard boot-uptime Command Output
Field
|
Description
|
Boot Time
|
Time boot
occurred.
|
Slot
Number
|
Slot
number.
|
Serial
Number
|
Serial
number of the module.
|
Bios
Version
|
Primary
binary input and output system (BIOS) version.
|
Firmware
Version
|
Firmware
version.
|
This example
shows how to display the OBFL logging device information:
switch# show logging onboard device-version
----------------------------
OBFL Data for
Module: 1
----------------------------
Device Version Record
----------------------------------------------------------------------
Timestamp Device Name Instance Hardware Software
Num Version Version
----------------------------------------------------------------------
Sun Nov 3 07:07:00 2008 GATOS 2 2 0
Sun Nov 3 07:07:00 2008 GATOS 3 2 0
Sun Nov 3 07:07:00 2008 GATOS 4 2 0
Sun Nov 3 07:07:00 2008 GATOS 5 2 0
Sun Nov 3 07:07:00 2008 GATOS 6 2 0
Sun Nov 3 07:07:00 2008 GATOS 7 2 0
Sun Nov 3 07:07:00 2008 GATOS 8 2 0
Sun Nov 3 07:07:00 2008 GATOS 9 2 0
Sun Nov 3 07:07:00 2008 GATOS 10 2 0
Sun Nov 3 07:07:00 2008 GATOS 11 2 0
Sun Nov 3 07:07:00 2008 GATOS 12 2 0
Sun Nov 3 07:07:00 2008 GATOS 13 2 0
Mon Nov 4 00:15:08 2008 ALTOS 0 2 0
Mon Nov 4 00:15:08 2008 GATOS 0 2 0
Mon Nov 4 00:15:08 2008 GATOS 1 2 0
Mon Nov 4 00:15:08 2008 GATOS 2 2 0
Table 2 describes
the significant fields shown in the display.
Table 2. show logging
onboard device-version Command Output
Field
|
Description
|
Timestamp
|
Day,
date, and time.
|
Device
Name
|
Device
name.
|
Instance
Num
|
Number of
instances.
|
Hardware
Version
|
Hardware
device version.
|
Software
Version
|
Software
device version.
|
This example
shows how to display the OBFL history information:
switch# show logging onboard obfl-history
The
show
logging
onboard
obfl-history command displays the following
information:
- Timestamp when
OBFL is manually disabled.
- Timestamp when
OBFL is manually enabled.
- Timestamp when
OBFL data is manually cleared.
This example
shows how to display the OBFL kernel stack trace information:
switch# show logging onboard stack-trace
The
show
logging
onboard
stack-trace command displays the following
information:
- Time in
seconds
- Time in
microseconds
- Error
description string
- Current
process name and identification
- Kernel jiffies
- Stack trace