Information About System Message Logging
With the system message logging software, you can save messages in a log file or direct the messages to other devices. By default, the switch logs normal but significant system messages to a log file and sends these messages to the system console. This feature provides you with the following capabilities:
-
Provides logging information for monitoring and troubleshooting
-
Allows you to select the types of captured logging information
-
Allows you to select the destination server to forward the captured logging information properly configured system message logging server.
Note |
When the switch first initializes, the network is not connected until initialization completes. Therefore, messages are not redirected to a system message logging server for a few seconds. |
Log messages are not saved across system reboots. However, a maximum of 100 log messages with a severity level of critical and below (levels 0, 1, and 2) are saved in NVRAM.
Table 1 describes some samples of the facilities supported by the system message logs.
Facility Keyword |
Description |
Standard or Cisco MDS Specific |
---|---|---|
acl |
ACL manager |
Cisco MDS 9000 Family specific |
all |
All facilities |
Cisco MDS 9000 Family specific |
auth |
Authorization system |
Standard |
authpriv |
Authorization (private) system |
Standard |
bootvar |
Bootvar |
Cisco MDS 9000 Family specific |
callhome |
Call Home |
Cisco MDS 9000 Family specific |
cron |
Cron or at facility |
Standard |
daemon |
System daemons |
Standard |
fcc |
FCC |
Cisco MDS 9000 Family specific |
fcdomain |
fcdomain |
Cisco MDS 9000 Family specific |
fcns |
Name server |
Cisco MDS 9000 Family specific |
fcs |
FCS |
Cisco MDS 9000 Family specific |
flogi |
FLOGI |
Cisco MDS 9000 Family specific |
fspf |
FSPF |
Cisco MDS 9000 Family specific |
ftp |
File Transfer Protocol |
Standard |
ipconf |
IP configuration |
Cisco MDS 9000 Family specific |
ipfc |
IPFC |
Cisco MDS 9000 Family specific |
kernel |
Kernel |
Standard |
local0 to local7 |
Locally defined messages |
Standard |
lpr |
Line printer system |
Standard |
|
Mail system |
Standard |
mcast |
Multicast |
Cisco MDS 9000 Family specific |
module |
Switching module |
Cisco MDS 9000 Family specific |
news |
USENET news |
Standard |
ntp |
NTP |
Cisco MDS 9000 Family specific |
platform |
Platform manager |
Cisco MDS 9000 Family specific |
port |
Port |
Cisco MDS 9000 Family specific |
port-channel |
PortChannel |
Cisco MDS 9000 Family specific |
qos |
QoS |
Cisco MDS 9000 Family specific |
rdl |
RDL |
Cisco MDS 9000 Family specific |
rib |
RIB |
Cisco MDS 9000 Family specific |
rscn |
RSCN |
Cisco MDS 9000 Family specific |
securityd |
Security |
Cisco MDS 9000 Family specific |
syslog |
Internal system messages |
Standard |
sysmgr |
System manager |
Cisco MDS 9000 Family specific |
tlport |
TL port |
Cisco MDS 9000 Family specific |
user |
User process |
Standard |
uucp |
UNIX-to-UNIX Copy Program |
Standard |
vhbad |
Virtual host base adapter daemon |
Cisco MDS 9000 Family specific |
vni |
Virtual network interface |
Cisco MDS 9000 Family specific |
vrrp_cfg |
VRRP configuration |
Cisco MDS 9000 Family specific |
vrrp_eng |
VRRP engine |
Cisco MDS 9000 Family specific |
vsan |
VSAN system messages |
Cisco MDS 9000 Family specific |
vshd |
vshd |
Cisco MDS 9000 Family specific |
wwn |
WWN manager |
Cisco MDS 9000 Family specific |
xbar |
Xbar system messages |
Cisco MDS 9000 Family specific |
zone |
Zone server |
Cisco MDS 9000 Family specific |
Table 2 describes the severity levels supported by the system message logs.
Level Keyword |
Level |
Description |
System Message Definition |
---|---|---|---|
emergencies |
0 |
System unusable |
LOG_EMERG |
alerts |
1 |
Immediate action needed |
LOG_ALERT |
critical |
2 |
Critical conditions |
LOG_CRIT |
errors |
3 |
Error conditions |
LOG_ERR |
warnings |
4 |
Warning conditions |
LOG_WARNING |
notifications |
5 |
Normal but significant condition |
LOG_NOTICE |
informational |
6 |
Informational messages only |
LOG_INFO |
debugging |
7 |
Debugging messages |
LOG_DEBUG |
Note |
Refer to the Cisco MDS 9000 Family System Messages Reference for details on the error log message format. |
System Message Logging
The system message logging software saves the messages in a log file or directs the messages to other devices. This feature has the following capabilities:
- Provides logging information for monitoring and troubleshooting.
- Allows the user to select the types of captured logging information.
- Allows the user to select the destination server to forward the captured logging information.
By default, the switch logs normal but significant system messages to a log file and sends these messages to the system console. You can specify which system messages should be saved based on the type of facility and the severity level. Messages are time-stamped to enhance real-time debugging and management.
You can access the logged system messages using the CLI or by saving them to a correctly configured system message logging server. The switch software saves system messages in a file that can save up to 1200 entries. You can monitor system messages remotely by accessing the switch through Telnet, SSH, the console port, or by viewing the logs on a system message logging server.
SFP Diagnostics
The error message related to SFP failures is written to the syslog. You can listen to the syslog for events related to SFP failures. The values, low or high alarm, and the warning are checked for the following parameters:
- TX Power
- RX Power
- Temperature
- Voltage
- Current
The SFP notification trap indicates the current status of the alarm and warning monitoring parameters for all the sensors based on the digital diagnostic monitoring information. This notification is generated whenever there is a change in the status of at least one of the monitoring parameters of the sensors on the transceiver in an interface.
The CISCO-INTERFACE-XCVR-MONITOR-MIB contains the SFP notification trap information. Refer to the Cisco MDS 9000 Family MIB Quick Reference for more information on this MIB.
Outgoing System Message Logging Server Facilities
All system messages have a logging facility and a level. The logging facility can be thought of as where and the level can be thought of as what .
The single system message logging daemon (syslogd) sends the information based on the configured facility option. If no facility is specified, local7 is the default outgoing facility.
The internal facilities are listed in Table 1 and the outgoing logging facilities are listed in Table 1.
Facility Keyword |
Description |
Standard or Cisco MDS Specific |
---|---|---|
auth |
Authorization system |
Standard |
authpriv |
Authorization (private) system |
Standard |
cron |
Cron or at facility |
Standard |
daemon |
System daemons |
Standard |
ftp |
File Transfer Protocol |
Standard |
kernel |
Kernel |
Standard |
local0 to local7 |
Locally defined messages |
Standard (local7 is the default) |
lpr |
Line printer system |
Standard |
|
Mail system |
Standard |
news |
USENET news |
Standard |
syslog |
Internal system messages |
Standard |
user |
User process |
Standard |
uucp |
UNIX-to-UNIX Copy Program |
Standard |
System Message Logging Configuration Distribution
You can enable fabric distribution for all Cisco MDS switches in the fabric. When you perform system message logging configurations, and distribution is enabled, that configuration is distributed to all the switches in the fabric.
You automatically acquire a fabric-wide lock when you issue the first configuration command after you enabled distribution in a switch. The system message logging server uses the effective and pending database model to store or commit the commands based on your configuration. When you commit the configuration changes, the effective database is overwritten by the configuration changes in the pending database and all the switches in the fabric receive the same configuration. After making the configuration changes, you can choose to discard the changes by aborting the changes instead of committing them. In either case, the lock is released. See Using the CFS Infrastructure for more information on the CFS application.
Fabric Lock Override
If you have performed a system message logging task and have forgotten to release the lock by either committing or discarding the changes, an administrator can release the lock from any switch in the fabric. If the administrator performs this task, your changes to the pending database are discarded and the fabric lock is released.
Tip |
The changes are only available in the volatile directory and are subject to being discarded if the switch is restarted. |