10-信息中心命令
本章节下载: 10-信息中心命令 (497.57 KB)
目 录
1.1.3 display diagnostic-logfile summary
1.1.5 display info-center file-server
1.1.6 display info-center filter
1.1.8 display logbuffer summary
1.1.10 display security-logfile summary
1.1.11 display trace-logfile summary
1.1.13 info-center diagnostic-logfile directory
1.1.14 info-center diagnostic-logfile enable
1.1.15 info-center diagnostic-logfile frequency
1.1.16 info-center diagnostic-logfile quota
1.1.18 info-center file-server transport-type
1.1.19 info-center file-server user
1.1.23 info-center logbuffer size
1.1.24 info-center logfile alarm-threshold
1.1.25 info-center logfile directory
1.1.26 info-center logfile enable
1.1.27 info-center logfile frequency
1.1.28 info-center logfile size-quota
1.1.29 info-center logging suppress duplicates
1.1.30 info-center logging suppress module
1.1.32 info-center loghost locate-info with-sn
1.1.33 info-center loghost source
1.1.34 info-center security-logfile alarm-threshold
1.1.35 info-center security-logfile enable
1.1.36 info-center security-logfile frequency
1.1.37 info-center security-logfile size-quota
1.1.39 info-center synchronous
1.1.40 info-center syslog min-age
1.1.41 info-center syslog trap buffersize
1.1.43 info-center timestamp loghost
1.1.44 info-center trace-logfile directory
1.1.45 info-center trace-logfile enable
1.1.46 info-center trace-logfile frequency
1.1.47 info-center trace-logfile quota
1.1.52 snmp-agent trap enable syslog
check logfile命令用来检查日志文件是否被篡改。
【命令】
check logfile file-path
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
file-path:日志文件的绝对路径。日志文件的后缀名必须为.log或.log.gz,否则,命令行执行失败。
【使用指导】
信息中心将日志保存到日志文件时,会使用设备主密钥为该日志文件计算一个摘要,保存在该日志文件中,该摘要用于校验日志文件是否被篡改。关于设备主密钥的相关介绍,请参见“安全配置指导”中的“公钥管理”。
执行本命令后,信息中心会使用设备主密钥重新为日志文件计算一个摘要,如果新计算的摘要和日志文件中保存的摘要一致,则表示日志文件未被篡改;如果新计算的摘要和日志文件中保存的摘要不同,则表示日志文件被篡改。
【举例】
# 检查日志文件flash:/logfile/logfile.log是否被篡改。
<Sysname> check logfile flash:/logfile/logfile.log
The integrity check for the logfile succeeded.
【相关命令】
diagnostic-logfile save命令用来手动将诊断日志文件缓冲区中的内容全部保存到诊断日志文件。
【命令】
diagnostic-logfile save
【视图】
任意视图
【缺省用户角色】
network-admin
【使用指导】
诊断日志文件的保存路径可以通过info-center diagnostic-logfile directory命令配置。
诊断日志文件保存成功后,诊断日志文件缓冲区中的内容会被清空。
如果执行本命令时,诊断日志文件缓冲区中没有日志,本命令会执行成功,但不会创建或更新已有诊断日志文件。
【举例】
# 手动将诊断日志文件缓冲区中的内容保存到诊断日志文件。
<Sysname> diagnostic-logfile save
The contents in the diagnostic log file buffer have been saved to the file flash:/diagfile/diagfile.log.
【相关命令】
· info-center diagnostic-logfile enable
· info-center diagnostic-logfile directory
display diagnostic-logfile summary命令用来显示诊断日志文件的配置。
【命令】
display diagnostic-logfile summary
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【举例】
# 显示诊断日志文件配置。
<Sysname> display diagnostic-logfile summary
Diagnostic log file: Enabled.
Diagnostic log file size quota: 10 MB
Diagnostic log file directory: flash:/diagfile
Writing frequency: 24 hour 0 min 0 sec
表1-1 display logfile summary命令显示信息描述表
字段 |
描述 |
Diagnostic log file |
诊断日志文件当前的状态: · Enabled:表示已开启 · Disabled:表示未开启 |
Diagnostic log file size quota |
单个诊断日志文件最大能占用的存储空间的大小,单位为MB |
Diagnostic log file directory |
诊断日志文件存储的路径 |
Writing frequency |
系统自动保存诊断日志文件的频率 |
display info-center命令用来显示各个输出方向的信息。
【命令】
display info-center
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【举例】
# 显示各个输出方向的信息。
<Sysname> display info-center
Information Center: Enabled
Console: Enabled
Monitor: Enabled
Log host: Enabled
1.1.1.1, log output filter: loghost1
port number: 514, host facility: local7
Log buffer: Enabled
Max buffer size 1024, current buffer size 512,
Current messages 0, dropped messages 0, overwritten messages 0
Log file: Enabled
Security log file: Enabled
Information timestamp format:
Log host: Date
Other output destination: Date
表1-2 display info-center命令显示信息描述表
字段 |
描述 |
Information Center |
信息中心当前的状态: · Enabled:表示已开启 · Disabled:表示未开启 |
Console |
控制台方向当前的状态: · Enabled:表示已开启 · Disabled:表示未开启 |
Monitor |
监视终端方向当前的状态: · Enabled:表示已开启 · Disabled:表示未开启 |
Log host: Enabled 1.1.1.1, log output filter: loghost1 port number: 514, host facility: local7 |
日志主机方向的信息(只有通过info-center loghost命令配置后,才有下面具体的显示内容),包括日志主机的IP地址、关联的日志输出规则名称、日志主机接收日志信息的端口、日志主机的记录工具 |
Log buffer: Enabled Max buffer size 1024, current buffer size 512, Current messages 0, dropped messages 0, overwritten messages 0 |
日志缓冲区方向的信息,包括开启状态、最大容量、当前容量、当前信息数、已丢弃的信息数、被覆盖的信息数 |
Log file |
日志文件方向当前的状态: · Enabled:表示已开启 · Disabled:表示未开启 |
Security log file |
安全日志文件方向当前的状态: · Enabled:表示已开启 · Disabled:表示未开启 |
Information timestamp format: Loghost: Date Other output destination: Date |
信息时间戳配置,包括日志主机输出方向和非日志主机输出方向日志信息的时间戳类型,分为boot、date、iso、none和no-year-date五种 |
display info-center file-server命令用来显示远端服务器的相关配置以及备份记录。
【命令】
display info-center file-server
【视图】
用户视图
【缺省用户角色】
network-admin
network-operator
【使用指导】
当本机向远端服务器备份日志文件时,会记录本次备份操作的相关信息,最多可记录10条信息。使用本命令,可查看设备记录的备份操作信息,以便用户了解备份操作的执行时间和执行结果等信息。
【举例】
# 显示远端服务器的相关配置以及备份记录。
<Sysname> display info-center file-server
Username: test
Protocol: tcp
IP: 1.1.1.1
Port: 22
VPN: vpnname
Directory: /backup
Filename prefix: my_backup
File type: logfile, security-logfile
Backup records:
No. TimeStamp FileName
1 Wed Jan 15 14:20:18 2022 my_backup_20220115142018.log
!2 Wed Jan 15 14:33:10 2022 my_backup_20220115143310.log
3 Wed Jan 15 14:49:37 2022 my_backup_20220115144937.log
The exclamation mark (!) indicates that the backup attempt failed.
表1-3 display info-center file-server命令显示信息描述表
字段 |
描述 |
Username |
登录远端服务器时使用的用户名,未配置时显示为N/A 使用FTP或者SCP协议备份日志文件时,必须配置登录用户名和密码 |
Protocol |
备份日志文件时使用的协议 |
IP |
远端服务器的IP地址 |
Port |
远端服务器的侦听端口号 |
VPN |
远端服务器所属的VPN |
Directory |
远端服务器上日志文件的存储路径 |
Filename prefix |
将日志文件保存到远端服务器上时使用的文件名前缀 |
Backup records |
日志文件的备份记录,记录的内容包括: · No.:备份操作的序列号 · TimeStamp:本机开始备份日志文件时的系统时间 · FileName:日志文件存储在远端服务器上使用的文件名,该文件名由文件名前缀(取值见Filename prefix字段)+时间戳(取值见TimeStamp字段)组成 |
The exclamation mark (!) indicates that the backup attempt failed. |
“!”表示该行描述的日志文件备份失败了 |
【相关命令】
· info-center file-server transport-type
· info-center file-server user
display info-center filter命令用来显示用户创建的日志输出规则的相关信息。
【命令】
display info-center filter [ filtername ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
filter-name:显示指定日志输出规则的相关信息。filter-name表示日志信息输出规则的名称,必须为设备上已创建的日志输出规则。不指定该参数时,显示所有日志输出规则的相关信息。
【举例】
# 显示日志输出规则loghost1的相关信息。
<Sysname> display info-center filter loghost1
Log output filter: loghost1
Module Rule
ARP Debugging
CFGLOG Deny
Default Informational
表1-4 日志主机关联日志输出规则描述表
字段 |
描述 |
Log output filter: |
日志输出规则名 |
Module |
输出规则中的模块 |
Rule |
模块对应的输出规则 |
【相关命令】
· info-center filter
display logbuffer命令用来显示日志缓冲区的状态和日志缓冲区记录的日志信息。
【命令】
display logbuffer [ reverse ] [ level severity | size buffersize | slot slot-number ] *
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
reverse:指定日志的显示顺序为从新到旧。如果不指定该参数,将先显示旧日志,最后显示最新的日志。
level severity:显示日志缓存中指定级别日志的信息,severity表示信息级别,取值范围为0~7。不带该参数时将显示系统日志缓冲区内所有级别的日志信息。
数值 |
信息级别 |
描述 |
0 |
emergency |
表示设备不可用的信息,如系统授权已到期 |
1 |
alert |
表示设备出现重大故障,需要立刻做出反应的信息,如流量超出接口上限 |
2 |
critical |
表示严重信息,如设备温度已经超过预警值,设备电源、风扇出现故障等 |
3 |
error |
表示错误信息,如接口链路状态变化等 |
4 |
warning |
表示警告信息,如接口连接断开,内存耗尽告警等 |
5 |
notification |
表示正常出现但是重要的信息,如通过终端登录设备,设备重启等 |
6 |
informational |
表示需要记录的通知信息,如通过命令行输入命令的记录信息,执行ping命令的日志信息等 |
7 |
debugging |
表示调试过程产生的信息 |
size buffersize:显示日志缓冲区中指定条数的最新日志。buffersize表示要显示的日志缓冲区中最新的日志信息的条数,取值范围为1~1024。不带该参数时将显示系统日志缓冲区内所有的日志信息。
slot slot-number:显示指定单板的日志缓冲区状态及日志缓冲区中记录的日志信息。slot-number表示单板所在的槽位号。如不指定本参数,将显示所有单板的日志缓冲区状态及日志缓冲区中记录的日志信息。
【举例】
# 显示系统日志缓冲区的状态和缓冲区记录的日志信息。
<Sysname> display logbuffer
Log buffer: Enabled
Max buffer size: 1024
Actual buffer size: 512
Dropped messages: 0
Overwritten messages: 718
Current messages: 512
%Jun 17 15:57:09:578 2019 Sysname SYSLOG/7/SYS_RESTART:System restarted --
...
表1-6 display logbuffer命令显示信息描述表
字段 |
描述 |
Log buffer |
是否允许输出到日志缓冲区方向: · Enabled:表示允许 · Disabled:表示不允许 |
Max buffer size |
允许的日志缓冲区可存储的最大信息条数 |
Actual buffer size |
当前配置的日志缓冲区可存储的最大信息条数 |
Dropped messages |
被丢弃的信息数(内存分配失败或分配日志缓冲区过小时丢失的信息数) |
Overwritten messages |
被覆盖的信息数(如果缓冲区存储空间不足,最早收到的信息数会被新的信息覆盖掉) |
Current messages |
当前记录的信息数 |
Failed to obtain the specified data. The following tries to display all data in the log buffer. |
(和设备内部数据库信息交互异常)获取显示信息失败,下面将尝试显示日志缓冲区中的所有数据 |
【相关命令】
· info-center logbuffer
· reset logbuffer
display logbuffer summary命令用来显示系统日志缓冲区的概要信息。
【命令】
display logbuffer summary [ level severity | slot slot-number ] *
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
level severity:显示日志缓存中指定级别日志的概要信息,severity表示信息级别,取值范围为0~7,具体内容请参见表1-5。不带该参数时,将显示系统日志缓冲区内所有级别的日志概要信息。
slot slot-number:显示指定单板的日志缓冲区的概要信息。slot-number表示单板所在的槽位号。如不指定该参数,将显示所有单板的日志缓冲区概要信息。
【举例】
# 显示系统日志缓冲区的概要信息。
<Sysname> display logbuffer summary
Slot EMERG ALERT CRIT ERROR WARN NOTIF INFO DEBUG
1 0 0 0 7 0 34 38 0
表1-7 display logbuffer summary命令显示信息描述表
字段 |
描述 |
EMERG |
emergency级别的信息数,请参见表1-5 |
ALERT |
alert级别的信息数,请参见表1-5 |
CRIT |
critical级别的信息数,请参见表1-5 |
ERROR |
error级别的信息数,请参见表1-5 |
WARN |
warning级别的信息数,请参见表1-5 |
NOTIF |
notification级别的信息数,请参见表1-5 |
INFO |
informational级别的信息数,请参见表1-5 |
DEBUG |
debugging级别的信息数,请参见表1-5 |
display logfile summary命令用来显示日志文件的配置。
【命令】
display logfile summary
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【举例】
# 显示日志文件配置。
<Sysname> display logfile summary
Log file: Enabled.
Log file size quota: 10 MB
Log file directory: flash:/logfile
Writing frequency: 0 hour 1 min 10 sec
表1-8 display logfile summary命令显示信息描述表
字段 |
描述 |
Log file |
是否允许输出到日志文件方向: · Enabled:表示已开启 · Disabled:表示未开启 |
Log file size quota |
单个日志文件最大能占用的存储空间的大小,单位为MB |
Log file directory |
日志文件存储的路径 |
Writing frequency |
系统自动保存日志文件的频率 |
display security-logfile summary命令用来显示安全日志文件的概要信息。
【命令】
display security-logfile summary
【视图】
任意视图
【缺省用户角色】
security-audit
【使用指导】
只有具有安全日志管理员角色的本地用户才能使用本命令。安全日志管理员的配置请参见“安全命令参考”中的“AAA”。
【举例】
# 显示安全日志文件概要信息。
<Sysname> display security-logfile summary
Security log file: Enabled
Security log file size quota: 10 MB
Security log file directory: flash:/seclog
Alarm threshold: 80%
Current usage: 30%
Writing frequency: 1 hour 0 min 0 sec
表1-9 display security-logfile summary命令显示信息描述表
字段 |
描述 |
Security log file |
安全日志文件当前的状态: · Enabled:表示已开启 · Disabled:表示未开启 |
Security log file size quota |
单个安全日志文件最大能占用的存储空间的大小 |
Security log file directory |
安全日志文件存储的路径 |
Alarm threshold |
安全日志文件使用率告警门限 |
Current usage |
当前的安全日志文件使用率 |
Writing frequency |
系统自动保存安全日志文件的频率 |
【相关命令】
· authorization-attribute(安全命令参考/AAA)
display trace-logfile summary命令用来显示调试跟踪日志文件的配置。
【命令】
display trace-logfile summary
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【举例】
# 显示调试跟踪日志文件的配置。
<Sysname> display trace-logfile summary
Trace log file: Enabled.
Trace log file size quota: 1 MB
Trace log file directory: flash:/tracefile
Writing frequency: 24 hour 0 min 0 sec
表1-10 display trace-logfile summary命令显示信息描述表
字段 |
描述 |
Trace log file |
调试跟踪日志同步保存功能开启状态: · Enabled:表示已开启 · Disabled:表示未开启 |
Trace log file size quota |
单个调试跟踪日志文件最大能占用的存储空间的大小,单位为MB |
Trace log file directory |
调试跟踪日志文件存储的路径 |
Writing frequency |
系统自动同步调试跟踪日志的频率 |
enable log updown命令用来允许端口在状态发生改变时生成Link up和Link down的日志信息。
undo enable log updown命令用来禁止端口在状态发生改变时生成Link up和Link down的日志信息。
【命令】
enable log updown
undo enable log updown
【缺省情况】
允许所有端口在状态发生改变时生成端口Link up和Link down的日志信息。
【视图】
接口视图
【缺省用户角色】
network-admin
【举例】
# 禁止端口Ten-GigabitEthernet2/0/0在状态发生改变时生成Link up和Link down的日志信息。
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 2/0/0
[Sysname-Ten-GigabitEthernet2/0/0] undo enable log updown
info-center diagnostic-logfile directory命令用来修改存储诊断日志文件的路径。
【命令】
info-center diagnostic-logfile directory dir-name
【缺省情况】
存储诊断日志文件路径为存储设备根目录下的diagfile文件夹。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
dir-name:诊断日志文件存储的路径,为1~64个字符的字符串。
【使用指导】
在执行该配置前,存储诊断日志文件的文件夹必须为当前已创建的目录。
本命令会在设备重启或主用主控板和备用主控板主备倒换后恢复到缺省情况。
【举例】
# 配置存放诊断日志文件的目录为flash:/test。
<Sysname> mkdir test
Creating directory flash:/test... Done.
<Sysname> system-view
[Sysname] info-center diagnostic-logfile directory flash:/test
info-center diagnostic-logfile enable命令用来开启诊断日志同步保存功能。
undo info-center diagose-logfile enable命令用来关闭诊断日志同步保存功能。
【命令】
info-center diagnostic-logfile enable
undo info-center diagnostic-logfile enable
【缺省情况】
诊断日志同步保存功能处于开启状态。
【视图】
系统视图
【缺省用户角色】
network-admin
【使用指导】
开启诊断日志同步保存功能后,系统将诊断日志进行集中处理:当生成的诊断日志时,系统会将诊断日志信息同步保存到诊断日志文件。这样既实现了诊断日志的集中管理,又有利于用户随时快捷地查看诊断日志,了解设备状态。
【举例】
# 开启诊断日志同步保存功能。
<Sysname> system-view
[Sysname] info-center diagnostic-logfile enable
info-center diagnostic-logfile frequency命令用来配置设备自动保存诊断日志文件的频率。
undo info-center diagnostic-logfile frequency命令用来恢复缺省情况。
【命令】
info-center diagnostic-logfile frequency freq-sec
undo info-center diagnostic-logfile frequency
【缺省情况】
诊断日志自动保存到文件的频率为86400秒。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
freq-sec:系统自动保存诊断日志文件的频率,取值范围为10~86400,单位为秒。
【使用指导】
配置设备自动保存诊断日志文件的频率后,诊断日志会先被输出到诊断日志文件缓冲区(diagnostic-logfile buffer),系统会按照配置中指定的频率将诊断日志文件缓冲区的内容写入诊断日志文件。
【举例】
# 配置诊断日志自动保存到文件的频率为600秒。
<Sysname> system-view
[Sysname] info-center diagnostic-logfile frequency 600
【相关命令】
· info-center diagnostic-logfile enable
info-center diagnostic-logfile quota命令用来配置单个诊断日志文件最大可占用的存储空间的大小。
undo info-center diagnostic-logfile quota命令用来恢复缺省情况。
【命令】
info-center diagnostic-logfile quota size
undo info-center diagnostic-logfile quota
【缺省情况】
单个诊断日志文件最大能占用的存储空间的大小为5MB。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
size:单个诊断日志文件可使用的存储空间的最大值,取值范围为1~10,单位为MB。
【举例】
# 配置单个诊断日志文件最大能占用的存储空间的大小为2MB。
<Sysname> system-view
[Sysname] info-center diagnostic-logfile quota 2
info-center enable命令用来开启信息中心功能。
undo info-center enable命令用来关闭信息中心功能。
【命令】
info-center enable
undo info-center enable
【缺省情况】
信息中心处于开启状态。
【视图】
系统视图
【缺省用户角色】
network-admin
【举例】
# 开启信息中心功能。
<Sysname> system-view
[Sysname] info-center enable
Information center is enabled.
info-center file-server transport-type命令用来配置将日志文件备份到远端服务器。
undo info-center file-server transport-type命令用来恢复缺省情况。
【命令】
info-center file-server transport-type { ftp | scp | tftp } { ipv4-address | ipv6 ipv6-address } [ port port-number ] [ vpn-instance vpn-instance-name ] [ directory directory ] filename-prefix filename-prefix [ file-type { logfile | security-logfile } ]
undo info-center file-server transport-type
【缺省情况】
设备不会将日志文件备份到远端服务器。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
ftp:表示使用FTP协议将日志文件备份到远端服务器。本设备作为FTP客户端。关于FTP功能的详细介绍请参见“基础配置指导”中的“FTP和TFTP”。
scp:表示使用SCP协议将日志文件备份到远端服务器。SCP(Secure Copy)基于SSH2,可提供安全的文件复制功能。本设备作为SCP客户端。关于SCP功能的详细介绍请参见“安全配置指导”中的“SSH”。
tftp:表示使用TFTP协议将日志文件备份到远端服务器。本设备作为TFTP客户端。关于TFTP功能的详细介绍请参见“基础配置指导”中的“FTP和TFTP”。
ipv4-address:远端服务器的IPv4地址,必须和远端服务器侧的配置一致。
ipv6 ipv6-address:远端服务器的IPv6地址,必须和远端服务器侧的配置一致。
port port-number:远端服务器的侦听端口号,必须和远端服务器侧的配置一致。取值范围为1~65535,FTP缺省值为21,SCP缺省值为22,TFTP缺省值为69。
vpn-instance vpn-instance-name:指定远端服务器所属的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称,为1~31个字符的字符串,区分大小写。如果未指定本参数,则表示日志主机位于公网中。
directory directory:远端服务器上存储日志文件的路径,为1~63个字符的字符串,区分大小写。不指定该参数时,表示将日志文件备份到远端服务器的工作路径。使用该参数,可以将日志文件保存到远端服务器工作路径下的子目录(请先在远端服务器上创建子目录,如果指定的路径不存在,会导致备份失败)。对于TFTP和FTP服务器,该路径格式为相对路径;对于SCP服务器,该路径格式为绝对路径。
filename-prefix filename-prefix:远端服务器上存储日志文件时使用的文件名前缀,为1~30个字符的字符串,只能包含字母、数字、“_”和“-”,不区分大小写。
file-type { logfile | security-logfile }:表示将指定类型的日志文件备份。不指定该参数时,表示将对应路径的通用日志文件和安全日志文件均备份。
· logfile表示将info-center logfile directory命令指定的路径下的通用日志文件备份。(该路径下的独立模块日志不备份。)
· security-logfile表示将安全日志文件备份。
【使用指导】
使用本命令可以将普通日志的日志文件和(或)安全日志的日志文件通过FTP、TFTP或者SCP协议备份到远端服务器,以提高日志文件的安全性。
当设备只支持单个日志文件时,日志写到文件尾后,设备会自动将该日志文件备份到远端服务器。
当设备支持多个日志文件时,写满一个日志文件后,设备会自动将该日志文件备份到远端服务器。
多次配置本命令,最新配置生效。
【举例】
# 使用FTP协议将通用日志文件备份到IP地址为1.1.1.1、侦听端口号为8000的FTP服务器,日志存储到FTP服务器上时,使用的日志文件前缀为2-2-2-2。
<Sysname> system-view
[Sysname] info-center file-server transport-type ftp 1.1.1.1 port 8000 filename-prefix 2-2-2-2 file-type logfile
【相关命令】
· display info-center file-server
· info-center file-server user
info-center file-server user命令用来配置登录远端服务器备份日志文件时使用的用户名和密码。
【命令】
info-center file-server user user-name password { cipher | simple } password
undo info-center file-server user
【缺省情况】
未配置登录远端服务器备份日志文件时使用的用户名和密码。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
user-name:登录FTP服务器或SCP服务器备份日志文件时使用的用户名。
password { cipher | simple } password:登录FTP服务器或SCP服务器备份日志文件时使用的密码,区分大小写。
· cipher表示以密文方式设置密码,密文密码为33~117个字符的字符串。
· simple表示以明文方式设置密码,该密码将以密文形式存储,明文密码为1~63个字符的字符串。
【使用指导】
使用FTP或SCP协议将日志文件备份到远端服务器前,请使用本命令配置远端服务器的登录用户名和密码,且本命令配置的参数值必须和远端服务器侧的配置相同。
多次执行本命令,最新配置生效。
【举例】
# 登录FTP服务器或SCP服务器备份日志文件时使用的用户名为ftpuser,密码为ftp123456。
<Sysname> system-view
[Sysname] info-center file-server user ftpuser password simple ftp123456
【相关命令】
· display info-center file-server
· info-center file-server transport-type
info-center filter命令用来创建日志输出规则。
undo info-center filter命令用来删除日志输出规则。
【命令】
info-center filter filter-name { module-name | default } { deny | level severity }
undo info-center filter filter-name [ module-name | default ]
【缺省情况】
未创建日志输出规则。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
filter-name:日志信息输出规则的名称,为1~8个字符的字符串,不区分大小写。
module-name:为指定模块配置日志输出规则,该参数的取值可通过在系统视图下输入info-center filter filter-name ?来获得。
default:对于日志主机输出方向,所有应用模块日志信息的缺省输出规则为允许alert、critical、debugging、emergency、error、informational级别的日志输出。使用本参数,可以将这个缺省输出规则配置为其它值。
deny:禁止输出日志信息。
level severity:指定允许输出的日志信息的最低级别,取值为alert、critical、debugging、emergency、error、informational、notification、warning,具体内容请参见表1-5。例如,本参数配置为warning,则表示配置对emergency、alert、critical、error和warning级别的日志均生效。
【使用指导】
本命令用于配置日志主机输出方向日志的输出规则。用户可以使用module-name参数为应用模块单独配置输出规则,对于未单独配置输出规则的业务模块,则使用default参数配置的输出规则。default的缺省配置为level informational,即允许alert~informational级别的日志输出。
info-center source命令也可以配置日志输出规则。对于日志主机输出方向,本命令配置的输出规则优先于info-center source命令配置的输出规则。
多次执行本命令:
· 可以创建多个输出规则,将输出规则和日志主机绑定,可以为不同的日志主机指定不同的输出规则。
· 如果指定的filter-name和module-name相同,则最后一次执行的命令生效。
· 如果均指定default参数,且filter-name相同,则最后一次执行的命令生效。
如果指定default参数,且severity指定为informational,命令行会执行失败。因为配置的规则同缺省输出规则,无需额外配置。
给应用模块单独配置输出规则后,必须使用module-name参数来修改或删除该规则,使用default参数进行的配置对该模块不生效。
【举例】
# 配置日志输出规则,并和日志主机绑定。
<Sysname> system-view
[Sysname] info-center filter f1 ACL level error
[Sysname] info-center loghost 1.1.1.1 filter f1
【相关命令】
· display info-center filter
· info-center loghost
· info-center source
info-center format命令用来配置发往日志主机的日志信息的输出格式。
undo info-center format命令用来恢复缺省情况。
【命令】
info-center format { cmcc | unicom }
undo info-center format
【缺省情况】
发往日志主机的日志信息的格式为非定制格式。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
cmcc:配置发往日志主机的日志信息的输出格式为中国移动格式。
unicom:配置发往日志主机的日志信息的输出格式为中国联通格式。
【使用指导】
发往日志主机的日志信息有三种格式:非定制格式、中国联通格式和中国移动格式。有关日志信息格式的详细介绍请参见“网络管理和监控配置指导”中的“信息中心”。
本命令配置的日志格式对所有日志主机生效,info-center loghost命令中指定的日志格式对指定日志主机生效。对于同一日志主机,优先使用info-center loghost命令中指定的日志格式。
【举例】
# 配置发往日志主机的日志信息的格式为中国联通格式。
<Sysname> system-view
[Sysname] info-center format unicom
【相关命令】
· info-center loghost
info-center logbuffer命令用来允许日志信息输出到日志缓冲区。
undo info-center logbuffer命令用来禁止日志信息输出日志缓冲区。
【命令】
info-center logbuffer
undo info-center logbuffer
【缺省情况】
允许日志信息输出到日志缓冲区。
【视图】
系统视图
【缺省用户角色】
network-admin
【举例】
# 配置允许日志信息输出到日志缓冲区。
<Sysname> system-view
[Sysname] info-center logbuffer
【相关命令】
· display logbuffer
· info-center enable
info-center logbuffer size命令用来配置日志缓冲区可存储的信息条数。
undo info-center logbuffer size命令用来恢复缺省情况。
【命令】
info-center logbuffer size buffersize
undo info-center logbuffer size
【缺省情况】
日志缓冲区可存储512条信息。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
buffersize:日志缓冲区可存储的信息条数,缺省值为512,取值范围为0~1024。
【举例】
# 配置日志缓冲区可存储的信息条数为50。
<Sysname> system-view
[Sysname] info-center logbuffer size 50
# 恢复日志缓冲区可存储的信息条数为512。
<Sysname> system-view
[Sysname] undo info-center logbuffer size
【相关命令】
· display logbuffer
· info-center enable
info-center logfile alarm-threshold命令用来配置单个日志文件使用率的告警门限。
undo info-center logfile alarm-threshold命令用来恢复缺省情况。
【命令】
info-center logfile alarm-threshold usage
undo info-center logfile alarm-threshold
【缺省情况】
单个日志文件使用率的告警门限是80。即当单个日志文件使用率达到80%时,系统会提醒用户。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
usage:表示日志文件使用率的告警门限,取值范围为0~100。取值为0时,表示关闭日志文件使用率告警功能。
【使用指导】
用户可以使用本命令配置单个日志文件使用率的告警门限。当设备正在操作的日志文件的使用率超过告警门限时,系统会生成日志提醒用户,此时,用户可以将该日志文件进行备份,以防历史数据丢失。
【举例】
# 当通用模块的日志文件使用率达到90%时进行告警。
<Sysname> system-view
[Sysname] info-center logfile alarm-threshold 90
info-center logfile directory命令用来配置存储日志文件的目录。
【命令】
info-center logfile directory dir-name
【缺省情况】
存储日志文件目录为存储设备根目录下的logfile目录。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
dir-name:存储日志文件的路径,为1~64个字符的字符串。
【使用指导】
在执行该配置前,存储日志文件的目录必须为当前已创建的目录。
生成的日志文件的后缀名为.log,当缺省的存储器已满时,可以配置一个新的目录来存放新的日志信息。
本命令会在设备重启或主用主控板和备用主控板主备倒换后恢复到缺省情况。
【举例】
# 配置存放日志文件的目录为flash:/test。
<Sysname> mkdir test
Creating directory flash:/test... Done.
<Sysname> system-view
[Sysname] info-center logfile directory flash:/test
【相关命令】
· info-center logfile enable
info-center logfile enable命令用来允许日志信息输出到日志文件。
undo info-center logfile enable命令用来禁止日志信息输出到日志文件。
【命令】
info-center logfile enable
undo info-center logfile enable
【缺省情况】
允许日志信息输出到日志文件。
【视图】
系统视图
【缺省用户角色】
network-admin
【举例】
# 配置允许日志信息输出到日志文件。
<Sysname> system-view
[Sysname] info-center logfile enable
info-center logfile frequency命令用来配置系统自动保存日志文件的频率。
undo info-center logfile frequency命令用来恢复缺省情况。
【命令】
info-center logfile frequency freq-sec
undo info-center logfile frequency
【缺省情况】
系统自动保存日志文件的频率为86400秒。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
freq-sec:系统自动保存日志文件的频率,取值范围为1~86400,单位为秒。
【使用指导】
配置系统自动保存日志文件的频率后,系统会按照指定的频率将日志文件缓冲区的内容写入日志文件。
【举例】
# 配置设备自动保存日志文件的频率为60000秒。
<Sysname> system-view
[Sysname] info-center logfile frequency 60000
【相关命令】
· info-center logfile enable
info-center logfile size-quota命令用来配置单个日志文件最大能占用的存储空间的大小。
undo info-center logfile size-quota命令用来恢复缺省情况。
【命令】
info-center logfile size-quota size
undo info-center logfile size-quota
【缺省情况】
单个日志文件最大能占用的存储空间的大小为5MB。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
size:单个日志文件可使用的存储空间的最大值,取值范围为1~5,单位为MB。
【举例】
# 配置单个日志文件最大能占用的存储空间的大小为2MB。
<Sysname> system-view
[Sysname] info-center logfile size-quota 2
【相关命令】
· info-center logfile enable
info-center logging suppress duplicates命令用来开启抑制重复日志输出功能。
undo info-center logging suppress duplicate命令用关闭抑制重复日志输出功能。
【命令】
info-center logging suppress duplicates
undo info-center logging suppress duplicates
【缺省情况】
抑制重复日志输出功能处于关闭状态。
【视图】
系统视图
【缺省用户角色】
network-admin
【使用指导】
当设备持续向某个方向发送同一条日志信息时(发送间隔小于30秒),大量重复的信息会浪费设备资源和网络资源,并导致有用的信息被淹没,不利于设备的维护。为了避免此问题,可开启重复日志抑制功能。
开启重复日志抑制功能后,设备每产生一条新日志信息,在输出该日志信息的同时会启动该日志的抑制周期:
· 该日志抑制周期内:如果设备后续连续生成的日志信息均与该日志信息相同(要求日志信息的如下字段均完全相同:模块名、信息等级、日志助记符、定位信息和信息文本),则系统会认为后续生成的日志是该日志的相同日志,后续生成的日志信息不再输出。
· 该日志抑制周期结束后:如果设备后续仍连续生成该日志,系统输出被抑制的日志信息以及被抑制的数量,并启动下一个日志抑制周期。日志信息的第一个抑制周期为30秒,第二个抑制周期为2分钟,以后的抑制周期都是10分钟。
· 如果在日志抑制周期内有其它新日志信息产生:系统会先输出被抑制的日志信息以及被抑制的数量,再输出新的日志信息,并开始新日志的抑制周期。
【举例】
# 开启抑制重复日志输出功能。
· 假设设备上Ten-GigabitEthernet2/0/0的IP地址和网络中某设备的IP地址冲突,设备会频繁输出如下日志信息。
%Jan 1 07:27:48:636 2000 Sysname ARP/6/DUPIFIP:
Duplicate address 172.16.0.1 on interface Ten-GigabitEthernet2/0/0, sourced from 00e0-0058-123d
· 开启抑制重复日志输出功能。
<Sysname> system-view
[Sysname] info-center logging suppress duplicates
· 设备会继续输出如下日志。
%Jan 1 07:27:48:636 2000 Sysname ARP/6/DUPIFIP:
Duplicate address 172.16.0.1 on interface Ten-GigabitEthernet2/0/0, sourced from 00e0-0058-123d
%Jan 1 07:28:19:639 2000 Sysname ARP/6/DUPIFIP:
Duplicate address 172.16.0.1 on interface Ten-GigabitEthernet2/0/0, sourced from 00e0-0058-123d
This message repeated 4 times in last 30 seconds.
以上显示信息表明:开启抑制重复日志输出功能后,设备生成了一条IP地址冲突的日志,第一个抑制周期为30秒。
%Jan 1 07:30:19:643 2000 Sysname ARP/6/DUPIFIP:
Duplicate address 172.16.0.1 on interface Ten-GigabitEthernet2/0/0, sourced from 00e0-0058-123d
This message repeated 20 times in last 2 minutes.
以上显示信息表明抑制周期延长为120秒。
%Jan 1 07:30:20:541 2000 Sysname ARP/6/DUPIFIP:
Duplicate address 172.16.0.1 on interface Ten-GigabitEthernet2/0/0, sourced from 00e0-0058-123d
This message repeated 1 times in last 1 second.
%Jan 1 07:30:19:542 2000 Sysname CFGMAN/5/CFGMAN_CFGCHANGED: -EventIndex=[12]-CommandSource=[2]-ConfigSource=[4]-ConfigDestination=[2]; Configuration is changed.
以上显示信息表明在抑制周期内有新的日志产生。
%Jan 1 07:30:24:643 2000 Sysname ARP/6/DUPIFIP:
Duplicate address 172.16.0.1 on interface Ten-GigabitEthernet2/0/0, sourced from 00e0-0058-123d
%Jan 1 07:30:55:645 2000 Sysname ARP/6/DUPIFIP:
Duplicate address 172.16.0.1 on interface Ten-GigabitEthernet2/0/0, sourced from 00e0-0058-123d
This message repeated 4 times in last 30 seconds.
以上显示信息表明开始新一轮抑制。
info-center logging suppress module命令用来禁止指定模块日志的输出。
undo info-center logging suppress module命令用来取消对指定模块日志输出的限制。
【命令】
info-center logging suppress module module-name mnemonic { all | mnemonic-value }
undo info-center logging suppress module module-name mnemonic { all | mnemonic-value }
【缺省情况】
未禁止指定模块日志的输出。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
module-name:指定需要被过滤的应用模块的名称,为1~8个字符的字符串,不区分大小写。执行info-center logging suppress module ?命令,设备会自动显示可配置的模块名称。
mnemonic { all | mnemonic-value }:表示需要被过滤的应用模块的助记符。其中:
· all:表示过滤该模块的所有日志。
· mnemonic-value:表示助记符的全部内容,为1~32个字符的字符串,不区分大小写。如果输入的是助记符的部分内容,则不会禁止输出该助记符对应的日志。
【使用指导】
当系统日志较多时,对于用户不关心的日志,可以使用该命令,禁止指定模块日志的输出,或者禁止指定模块特定助记符的日志输出。
【举例】
# 禁止输出SHELL模块助记符为SHELL_LOGIN的日志。
<Sysname> system-view
[Sysname] info-center logging suppress module shell mnemonic shell_login
【相关命令】
· info-center source
info-center loghost命令用来配置日志主机及相关参数。
undo info-center loghost命令用来取消日志主机及相关参数的配置。
【命令】
info-center loghost [ vpn-instance vpn-instance-name ] { hostname | ipv4-address | ipv6 ipv6-address } [ facility local-number | filter filter-name | format { cmcc | default | unicom } | port port-number | source-ip source-ip-address ] * [ tcp [ ssl-client-policy policy-name ] ]
undo info-center loghost [ vpn-instance vpn-instance-name ] { hostname | ipv4-address | ipv6 ipv6-address }
【缺省情况】
未配置日志主机及相关参数。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
vpn-instance vpn-instance-name:指定日志主机所属的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称,为1~31个字符的字符串,区分大小写。如果未指定本参数,则表示日志主机位于公网中。
hostname:指定日志的主机名,为1~253个字符的字符串,不区分大小写,字符串中可以包含字母、数字、“-”、“_”和“.”。
ipv4-address:指定日志主机的IPv4地址。
ipv6 ipv6-address:指定日志主机的IPv6地址。
facility local-number:配置日志主机的记录工具。取值范围为local0~local7,缺省值为local7。主要用于在日志主机端标志不同的日志来源,查找、过滤对应日志源的日志。
filter filter-name:指定日志主机关联的日志输出规则的名称,只有符合规则的日志才能输出到对应的日志主机。filter-name表示日志信息输出规则的名称,为1~8个字符的字符串,不区分大小写。不指定该参数时,则采用info-center source命令日志主机方向的配置作为日志输出规则。
format:配置发往指定日志主机的日志信息中使用的日志格式。不指定该参数时,使用info-center format命令中配置的日志格式。用户可配置的日志格式包括:
· cmcc:配置发往日志主机的日志信息的输出格式为中国移动格式。
· default:配置发往日志主机的日志信息的输出格式为非定制格式。
· unicom:配置发往日志主机的日志信息的输出格式为中国联通格式。
port port-number:指定日志主机接收日志信息的端口号,取值范围为1~65535,缺省值为514。该参数的值需要和日志主机侧的配置一致,否则日志主机接收不到日志信息。
source-ip source-ip-address:配置发往指定日志主机的日志信息中使用的源IP地址。不指定该参数时,使用info-center loghost source命令中配置的源IP地址。
tcp:配置使用TCP协议发送日志。缺省使用UDP协议发送日志。
ssl-client-policy policy-name:配置使用基于TCP协议的SSL加密方式发送日志。policy-name表示SSL客户端策略名称,为1~31个字符的字符串,不区分大小写。不指定该参数时,表示使用非加密方式发送日志。
【使用指导】
用户只有使用info-center enable命令开启了信息中心功能,配置info-center loghost命令才会生效。
多次执行本命令,最多可以指定20台不同主机同时接收设备产生的日志信息。
如果要使用SSL加密方式发送日志,请先完成SSL客户端策略的相关配置,否则,SSL连接无法建立,会导致日志无法发送给日志主机。关于SSL客户端策略的相关配置请参见“安全配置指导”中的“SSL”。
【举例】
# 配置系统向IP地址为1.1.1.1的日志主机发送日志信息。
<Sysname> system-view
[Sysname] info-center loghost 1.1.1.1
# 配置系统向IP地址为1.1.1.1的日志主机,并关联filter,配置ACL模块日志输出规则。
<Sysname> system-view
[Sysname] info-center filter f1 acl level debugging
[Sysname] info-center loghost 1.1.1.1 filter f1
【相关命令】
· info-center filter
· info-center format
· info-center source
· ssl client-policy(安全命令参考/SSL)
info-center loghost locate-info with-sn命令用来配置向日志主机方向发送日志时,在日志定位信息中携带设备序列号。
undo info-center loghost locate-info with-sn命令用来恢复缺省情况。
【命令】
info-center loghost locate-info with-sn
undo info-center loghost locate-info with-sn
【缺省情况】
向日志主机方向发送日志时,日志定位信息中未携带设备序列号。
【视图】
系统视图
【缺省用户角色】
network-admin
【举例】
# 配置向日志主机方向发送日志时,在日志定位信息中携带设备序列号。
<Sysname> system-view
[Sysname] info-center loghost locate-info with-sn
info-center loghost source命令用来配置发送的日志信息的源IP地址。
undo info-center loghost source命令用来恢复缺省情况。
【命令】
info-center loghost source interface-type interface-number
undo info-center loghost source
【缺省情况】
使用出接口的主IP地址作为发送的日志信息的源IP地址。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
interface-type interface-number:指定发送日志信息的源IP地址对应的出接口的类型和编号。
【使用指导】
配置日志信息的源IP地址后,不管实际使用哪个物理接口发送日志信息,日志信息的源IP地址均为指定接口的主IP地址。
用户只有使用info-center enable命令开启了信息中心功能,配置info-center loghost source命令才会生效。
本命令配置的日志源IP地址对所有日志主机生效,info-center loghost命令中指定的日志源IP地址对指定日志主机生效。对于同一日志主机,优先使用info-center loghost命令中指定的日志源IP地址。
【举例】
# 配置使用Loopback0的IP地址作为发送的日志信息的源IP地址。
<Sysname> system-view
[Sysname] interface loopback 0
[Sysname-LoopBack0] ip address 2.2.2.2 32
[Sysname-LoopBack0] quit
[Sysname] info-center loghost source loopback 0
【相关命令】
· info-center loghost
info-center security-logfile alarm-threshold命令用来配置安全日志文件使用率的告警门限。
undo info-center security-logfile alarm-threshold命令用来恢复缺省情况。
【命令】
info-center security-logfile alarm-threshold usage
undo info-center security-logfile alarm-threshold
【缺省情况】
安全日志文件使用率的告警门限是80(即当安全日志文件使用率达到80%时,系统会提醒用户)。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
usage:安全日志文件使用率的告警门限,取值范围为1~100的整数。
【使用指导】
当安全日志文件大小达到上限时,新的安全日志会覆盖旧的安全日志,从而导致安全日志丢失。为防止这种情况发生,用户可以使用本命令配置安全日志文件使用率的告警门限。当使用率超过此门限值时,系统会发出日志提醒用户,此时,用户可以将安全日志文件进行备份,以防重要历史数据丢失。
【举例】
# 配置当安全日志文件使用率达到90%时进行告警。
<Sysname> system-view
[Sysname] info-center security-logfile alarm-threshold 90
【相关命令】
· info-center security-logfile size-quota
info-center security-logfile enable命令用来开启安全日志同步保存功能。
undo info-center security-logfile enable命令用来关闭安全日志同步保存功能。
【命令】
info-center security-logfile enable
undo info-center security-logfile enable
【缺省情况】
安全日志同步保存功能处于关闭状态。
【视图】
系统视图
【缺省用户角色】
network-admin
【使用指导】
开启安全日志同步保存功能后,系统将安全日志进行集中处理:当生成的日志信息中有安全日志,在不影响日志信息现有输出规则的前提下,系统会将安全日志信息同步保存到专用的安全日志文件。这样既实现了安全日志的集中管理,又有利于用户随时快捷地查看安全日志,了解设备状态。
【举例】
# 开启安全日志同步保存功能。
<Sysname> system-view
[Sysname] info-center security-logfile enable
info-center security-logfile frequency命令用来配置设备自动保存安全日志文件的频率。
undo info-center security-logfile frequency命令用来恢复缺省情况。
【命令】
info-center security-logfile frequency freq-sec
undo info-center security-logfile frequency
【缺省情况】
设备自动保存安全日志文件的频率为86400秒。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
freq-sec:系统自动保存安全日志文件的频率,取值范围为10~86400,单位为秒。
【使用指导】
配置设备自动保存安全日志文件的频率后,安全日志会先被输出到安全日志文件缓冲区(security-logfile buffer),系统会按照配置中指定的频率将安全日志文件缓冲区的内容写入安全日志文件。
【举例】
# 配置安全日志自动保存到文件的频率为600秒。
<Sysname> system-view
[Sysname] info-center security-logfile frequency 600
【相关命令】
· info-center security-logfile enable
info-center security-logfile size-quota命令用来配置单个安全日志文件最大能占用的存储空间的大小。
undo info-center security-logfile size-quota命令用来恢复缺省情况。
【命令】
info-center security-logfile size-quota size
undo info-center security-logfile size-quota
【缺省情况】
单个安全日志文件最大能占用的存储空间的大小为10MB。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
size:单个安全日志文件可使用的存储空间的最大值,取值范围为1~10,单位为MB。
【举例】
# 配置单个安全日志文件最大能占用的存储空间的大小为6MB。
<Sysname> system-view
[Sysname] info-center security-logfile size-quota 6
【相关命令】
· info-center security-logfile alarm-threshold
info-center source命令用来配置日志信息的输出规则。
undo info-center source命令用来恢复缺省情况。
【命令】
info-center source { module-name | default } { console | logbuffer | logfile | loghost | monitor } { deny | level severity }
undo info-center source { module-name | default } { console | logbuffer | logfile | loghost | monitor }
【缺省情况】
日志信息的输出规则请参见表1-11。
输出方向 |
日志信息来源 |
开关 |
等级 |
控制台 |
所有支持的模块 |
开 |
debugging |
监视终端 |
所有支持的模块 |
关 |
debugging |
日志主机 |
所有支持的模块 |
开 |
informational |
日志缓冲区 |
所有支持的模块 |
开 |
informational |
日志文件 |
所有支持的模块 |
开 |
informational |
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
module-name:配置指定应用模块日志信息的输出规则。系统支持的来源模块可以通过在系统视图下输入info-center source ?进行查看。
default:配置所有应用模块日志信息的缺省输出规则。
console:输出到控制台。
logbuffer:输出到日志缓冲区。
logfile:输出到日志文件。
loghost:输出到日志主机。
monitor:输出到监视终端。
deny:禁止输出信息。
level severity:指定允许输出的日志信息的最低级别,取值为alert、critical、debugging、emergency、error、informational、notification、warning,具体内容请参见表1-5。例如,本参数配置为warning,则表示配置对emergency、alert、critical、error和warning级别的日志均生效。
【使用指导】
如果没有使用module-name参数为应用模块单独配置输出规则,则该模块使用default参数配置的输出规则。如果未使用default参数配置输出规则,则使用缺省输出规则。
给应用模块单独配置输出规则后,必须使用module-name参数来修改或删除该规则,使用default参数进行的新配置对该模块不生效。
多次使用module-name参数为同一应用模块配置输出规则,最后一次执行的命令生效;多次使用default参数配置缺省输出规则,最后一次执行的命令生效。
【举例】
# 只允许ARP模块的信息输出控制台,且输出信息的级别为emergency的日志信息。
<Sysname> system-view
[Sysname] info-center source default console deny
[Sysname] info-center source arp console level emergency
# 在前面例子基础上撤销控制台方向上ARP模块的输出(即全部信息不在控制台显示)。
<Sysname> system-view
[Sysname] undo info-center source arp console
info-center synchronous命令用来开启命令行输入回显功能。
undo info-center synchronous命令用来关闭命令行输入回显功能。
【命令】
info-center synchronous
undo info-center synchronous
【缺省情况】
命令行输入回显功能处于关闭状态。
【视图】
系统视图
【缺省用户角色】
network-admin
【使用指导】
当用户进行命令行、参数或者Y/N确认信息输入时,如果被大量的日志信息打断,用户可能记不清已经输入了哪些字符串,还需要输入哪些字符串。使用命令行输入回显功能,能够协助用户配置。系统会在日志信息输出完毕后回显用户已有的输入或者Y/N确认信息,以便用户继续执行配置。
【举例】
# 开启设备命令行输入回显功能,输入display current-configuration命令查看设备当前配置。
<Sysname> system-view
[Sysname] info-center synchronous
Info-center synchronous output is on
[Sysname] display current-
此时,收到日志报文,则系统在所有的日志报文显示完以后,附加显示用户的输入(此例为“display current-”)。
%May 21 14:33:19:425 2007 Sysname SHELL/5/SHELL_LOGIN: VTY logged in from 192.168.1.44
[Sysname] display current-
此时,用户可以继续输入configuration(完成命令display current-configuration的完整输入),回车,即可执行该命令。
# 开启设备命令行输入回显功能,保存当前配置(输入交互信息)。
<Sysname> system-view
[Sysname] info-center synchronous
Info-center synchronous output is on
[Sysname] save
The current configuration will be written to the device. Are you sure? [Y/N]:
此时,收到日志信息,则系统会在所有的日志报文显示完以后,附加显示[Y/N]:。
%May 21 14:33:19:425 2007 Sysname SHELL/5/SHELL_LOGIN: VTY logged in from 192.168.1.44
[Y/N]:
此时,用户可以输入Y或者N,继续日志信息输出前的操作。
info-center syslog min-age命令用来配置日志信息和日志文件的最短保存时间。
undo info-center syslog min-age命令用来恢复缺省情况。
【命令】
info-center syslog min-age min-age
undo info-center syslog min-age
【缺省情况】
未配置日志信息和日志文件的最短保存时间。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
min-age:表示日志信息和日志文件的最短保存时间,取值范围为1~8760,单位为小时。
【举例】
# 将日志信息和日志文件的最短保存时间配置为168小时。
<Sysname> system-view
[Sysname] info-center syslog min-age 168
info-center syslog trap命令用来配置日志告警缓冲区的大小。
undo info-center syslog trap命令用来恢复缺省情况。
【命令】
info-center syslog trap buffersize buffersize
undo info-center syslog trap buffersize
【缺省情况】
日志告警缓冲区的大小为1024条。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
buffersize:表示日志告警缓冲区的大小,取值范围为0~65535,单位为条。当取值为0时,表示不缓存日志告警。
【使用指导】
配置snmp-agent trap enable syslog命令后,设备会将日志封装成告警信息,存储在日志告警缓冲区。用户通过访问“日志告警缓冲区对应的MIB节点”,就可以直接读取日志告警。
通常情况下,日志告警缓冲区的大小采用缺省值即可。当日志告警缓冲区内存储的信息达到上限,且还需要存储信息时,新信息会覆盖旧信息。
【举例】
# 配置日志告警缓冲区的大小为2048条。
<Sysname> system-view
[Sysname] info-center syslog trap buffersize 2048
【相关命令】
· snmp-agent trap enable syslog
info-center timestamp命令用来配置发往控制台、监视终端、日志缓冲区和日志文件方向的日志信息的时间戳输出格式。
undo info-center timestamp命令用来恢复缺省情况。
【命令】
info-center timestamp { boot | date | none }
undo info-center timestamp
【缺省情况】
时间戳输出格式为date格式。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
boot:系统启动后经历的时间,格式为:xxx.yyy,其中xxx是系统自启动后经历时间的毫秒数高32位,yyy是低32位,形如0.21990989(等效于Jun 25 14:09:26:881 2007)。
date:系统当前的日期和时间,格式为“MMM DD hh:mm:ss:xxx YYYY”,形如Dec 8 10:12:21:708 2007。
· “MMM”为英语月份的缩写,具体取值如下:Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec。
· “DD”表示日期,如果日期的值小于10,则格式为“空格+日期”,如“ 7”。
· “hh:mm:ss:xxx”表示本地时间,hh的取值范围为00~23,mm和ss的取值范围均为00~59,xxx的取值范围为0~999。
· “YYYY”表示年份。
none:不带时间信息。
【举例】
# 配置日志信息时间戳输出格式为boot格式。
<Sysname> system-view
[Sysname] info-center timestamp boot
【相关命令】
· info-center timestamp loghost
info-center timestamp loghost命令用来配置发往日志主机的日志信息的时间戳输出格式。
undo info-center timestamp loghost命令用来恢复缺省情况。
【命令】
info-center timestamp loghost { date | iso | no-year-date | none }
undo info-center timestamp loghost
【缺省情况】
发往日志主机的日志信息的时间戳输出格式为date格式。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
date:系统当前日期和时间,格式为:mmm dd hh:mm:ss yyyy,形如Dec 8 10:12:21 2007,但最终显示格式由日志主机决定。
iso:配置时间戳采用ISO 8601标准格式,形如:2009-09-21T15:32:55。
no-year-date:系统当前日期和时间,但不包含年份信息。
none:不带时间信息。
【举例】
# 配置发往日志主机的日志信息的时间戳为no-year-date格式。
<Sysname> system-view
[Sysname] info-center timestamp loghost no-year-date
【相关命令】
· info-center timestamp
info-center trace-logfile directory命令用来修改调试跟踪日志文件的路径。
【命令】
info-center trace-logfile directory dir-name
【缺省情况】
调试跟踪日志文件路径为存储设备根目录下的tracefile文件夹。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
dir-name:调试跟踪日志文件存储的路径,为1~64个字符的字符串。该路径必须为当前已存在或创建的目录。
【使用指导】
本命令会在设备重启或主用主控板和备用主控板主备倒换后恢复到缺省情况。
【举例】
# 修改调试跟踪日志文件的路径为flash:/test。
<Sysname> mkdir test
Creating directory flash:/test... Done.
<Sysname> system-view
[Sysname] info-center trace-logfile directory flash:/test
【相关命令】
· info-center trace-logfile enable
· trace-logfile save
info-center trace-logfile enable命令用来开启调试跟踪日志同步保存功能。
undo info-center trace-logfile enable命令用来关闭调试跟踪日志同步保存功能。
【命令】
info-center trace-logfile enable
undo info-center trace-logfile enable
【缺省情况】
调试跟踪日志同步保存功能处于开启状态。
【视图】
系统视图
【缺省用户角色】
network-admin
【使用指导】
调试跟踪日志同步保存功能处于关闭状态时,设备会将生成的调试跟踪日志保存在内存中,用户不能查看。
开启调试跟踪日志同步保存功能后,设备将调试跟踪日志保存在内存的同时,会将重要的调试跟踪日志(0~3级)保存到存储介质的调试跟踪日志文件中。这样既实现了调试跟踪日志的集中管理,又有利于用户随时快捷地查看调试跟踪日志,了解设备状态。
【举例】
# 开启调试跟踪日志同步保存功能。
<Sysname> system-view
[Sysname] info-center trace-logfile enable
【相关命令】
· info-center trace-logfile directory
· info-center trace-logfile frequency
· info-center trace-logfile quota
· trace-logfile save
info-center trace-logfile frequency命令用来配置设备自动保存调试跟踪日志文件的频率。
undo info-center trace-logfile frequency命令用来恢复缺省情况。
【命令】
info-center trace-logfile frequency freq-sec
undo info-center trace-logfile frequency
【缺省情况】
设备自动保存调试跟踪日志文件的频率为86400秒。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
freq-sec:系统自动保存调试跟踪日志文件的频率,取值范围为10~86400,单位为秒。
【使用指导】
开启调试跟踪日志同步保存功能后,设备会先将需要同步保存的调试跟踪日志输出到调试跟踪日志文件缓冲区(trace-logfile buffer),再按照指定的频率将调试跟踪日志文件缓冲区的内容写入调试跟踪日志文件。
【举例】
# 配置设备自动保存调试跟踪日志文件的频率为600秒。
<Sysname> system-view
[Sysname] info-center trace-logfile frequency 600
【相关命令】
· info-center trace-logfile enable
info-center trace-logfile quota命令用来配置调试跟踪日志文件最大能占用的存储空间的大小。
undo info-center trace-logfile quota命令用来恢复缺省情况。
【命令】
info-center trace-logfile quota size
undo info-center trace-logfile quota
【缺省情况】
调试跟踪日志文件最大能占用的存储空间的大小为10MB。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
size:调试跟踪日志文件最大能占用的存储空间的大小,取值范围为1~10,单位为MB。
【使用指导】
本命令用来配置保存在存储介质上的单个调试跟踪日志文件最大可占用的存储空间的大小以及内存中调试跟踪日志文件最大可占用的存储空间的大小。
【举例】
# 配置调试跟踪日志文件最大能占用的存储空间的大小为6MB。
<Sysname> system-view
[Sysname] info-center trace-logfile quota 6
logfile save命令用来手动将日志文件缓冲区中的内容全部保存到日志文件。
【命令】
logfile save
【视图】
任意视图
【缺省用户角色】
network-admin
【使用指导】
日志文件的保存路径可以通过info-center logfile directory命令配置。
日志文件保存成功后,日志文件缓冲区中的内容会被清空。
如果执行本命令时,日志文件缓冲区中没有日志,本命令会执行成功,但不会创建或更新已有日志文件。
【举例】
# 手动将日志文件缓冲区中的内容保存到日志文件。
<Sysname> logfile save
The contents in the log file buffer have been saved to the file flash:/logfile/logfile.log.
【相关命令】
· info-center logfile enable
· info-center logfile directory
reset logbuffer命令用来清除日志缓冲区中的信息。
【命令】
reset logbuffer
【视图】
用户视图
【缺省用户角色】
network-admin
【举例】
# 清除日志缓冲区中的信息。
<Sysname> reset logbuffer
【相关命令】
· display logbuffer
security-logfile save命令用来手动将安全日志文件缓冲区中的内容全部保存到安全日志文件。
【命令】
security-logfile save
【视图】
任意视图
【缺省用户角色】
security-audit
【使用指导】
安全日志文件保存成功后,安全日志文件缓冲区中的内容会被立即清空。
需要注意的是,只有具有安全日志管理员角色的本地用户才能使用本命令。安全日志管理员的配置请参见“安全命令参考”中的“AAA”。
如果执行本命令时,安全日志文件缓冲区中没有日志,本命令会执行成功,但不会创建或更新已有安全日志文件。
【举例】
# 手动将安全日志缓冲区中的内容保存到安全日志文件。
<Sysname> security-logfile save
The contents in the security log file buffer have been saved to the file flash:/seclog/seclog.log.
【相关命令】
· authorization-attribute(安全命令参考/AAA)
simulate syslog命令用来模拟生成指定的系统日志。
【命令】
simulate syslog { module module-name level level mnemonic mnemonic-value content TEXT | raw TEXT }
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
module module-name:表示需要生成的日志信息所属业务模块的名称,为1~8个字符的字符串,不区分大小写,输出日志时,系统会统一会将该字段值转换成大写字符。
level severity:表示需要生成的日志信息的级别,取值范围为0~7。
mnemonic mnemonic-value:表示需要生成的日志信息的助记符的全部内容,为1~32个字符的字符串,不区分大小写,输出日志时,系统会统一会将该字段值转换成大写字符。
content TEXT:表示需要生成的日志信息的内容。
raw TEXT:表示以纯文本的方式配置需要生成的日志。
【使用指导】
设备在达到触发条件时,会自动生成日志,来记录设备当前的状态或者设备上发生的重要事件。本命令用于在设备未达到触发条件时,模拟生成指定日志,并发送给信息中心业务模块输出,以此测试设备日志功能是否正常以及日志输出参数配置是否正确。
本命令指定的日志必须遵循以下格式:Module/Level/Mnemonic: Content,其中,各字段的含义和要求如下:
· Module表示模块名。该字段的取值可以为用户任意指定的字符串,也可以为设备当前支持的业务模块的名称。执行simulate syslog module ?命令,通过帮助信息可获取设备支持的业务模块的名称。
· Level表示日志信息的级别。
· Mnemonic表示日志信息的助记符的全部内容。该字段的取值可以为用户任意指定的字符串,也可以为设备当前支持的助记符。
· Content表示日志的内容,字符串中允许包含空格。
用户可以使用以下两种方式来配置需要生成的模拟日志:
· 基于字段的配置方式。
用module、level、mnemonic、content参数分别配置Module、Level、Mnemonic、Content字段的值,设备会自动将这些字段组装成Module/Level/Mnemonic: Content格式。
· 整体输入的配置方式。
¡ 用raw参数直接配置Module/Level/Mnemonic: Content,Module/Level/Mnemonic: Content作为一个参数整体输入。
¡ Module、Level和Mnemonic字段的取值中不能包含空格。
¡ 除了用于分隔Module、Level和Mnemonic字段的“/”外,不建议输入额外的“/”,以免影响最终的日志输出结果。
¡ 如果“Module/Level/Mnemonic: Content”前面有空格,空格前还有其它字符,则其它字符和空格不会作为日志输出。例如配置了simulate syslog raw %Jan 1 07:27:48:636 2000 Sysname ARP/6/DUPIFIP:Duplicate address 172.16.0.1 on interface Vlan-interface100, sourced from 00e0-0058-123d.,则只有“ARP/6/DUPIFIP:Duplicate address 172.16.0.1 on interface Vlan-interface100, sourced from 00e0-0058-123d.”作为日志内容输出,“%Jan 1 07:27:48:636 2000 Sysname ”不会输出。
本命令触发生成的日志信息将被发送到设备的信息中心模块,通过设置信息中心的参数,决定日志信息的输出规则(即是否允许输出以及输出方向)。
通过信息中心的配置,您可以在控制台、监控终端、日志缓冲区、日志文件方向看到该日志,如果配置了日志主机,还可以在日志主机上收到该日志。
【举例】
# 以基于字段的配置方式模拟生成指定的系统日志。日志的模块名为acl,级别为4,助记符为acl_accelerate_no_res,日志内容为Failed to accelerate IPv6 ACL 2001. The resources are insufficient.。
<Sysname> system-view
[Sysname] simulate syslog module acl level 4 mnemonic acl_accelerate_no_res content Failed to accelerate IPv6 ACL 2001. The resources are insufficient.
完成以上配置后,您可以在控制台看到如下日志(其中“*Jan 1 07:27:48:636 2022”为系统自动添加的日志的生成时间,“Sysname”为系统自动添加的设备名称):
*Jan 1 07:27:48:636 2022 Sysname ACL/4/ACL_ACCELERATE_NO_RES: Failed to accelerate IPv6 ACL 2001. The resources are insufficient.
# 以整体输入的配置方式模拟生成指定的系统日志。日志的模块名为acl,级别为4,助记符为acl_accelerate_no_res,日志内容为Failed to accelerate IPv6 ACL 2001. The resources are insufficient.。
<Sysname> system-view
[Sysname] simulate syslog raw ACL/4/ACL_ACCELERATE_NO_RES: Failed to accelerate IPv6 ACL 2001. The resources are insufficient.
完成以上配置后,您可以在控制台看到如下日志(其中“*Jan 1 07:27:48:636 2022”为系统自动添加的日志的生成时间,“Sysname”为系统自动添加的设备名称):
*Jan 1 07:27:48:636 2022 Sysname ACL/4/ACL_ACCELERATE_NO_RES: Failed to accelerate IPv6 ACL 2001. The resources are insufficient.
snmp-agent trap enable syslog命令用来将系统日志封装成告警信息发送。
undo snmp-agent trap enable syslog命令用来恢复缺省情况。
【命令】
snmp-agent trap enable syslog
undo snmp-agent trap enable syslog
【缺省情况】
系统日志不会封装成告警信息发送。
【视图】
系统视图
【缺省用户角色】
network-admin
【使用指导】
配置该命令后,设备除了根据输出规则将日志输出到各方向外,还会将日志信息封装成告警信息,发送到SNMP模块和日志告警缓冲区。
· 发送到SNMP模块后,是否输出到目的主机,以Trap还是Inform形式发送,由SNMP模块的配置决定,关于告警信息以及SNMP配置的详细介绍请参见“网络管理和监控配置指导”中的“SNMP”。
· 发送到日志告警缓冲区后,用户可通过“日志告警缓冲区对应的MIB节点”来直接读取日志信息封装成的告警信息。用户还可通过info-center syslog trap buffersize命令来配置日志告警缓冲区的大小。
【举例】
# 将系统日志封装成告警信息发送。
<Sysname> system-view
[Sysname] snmp-agent trap enable syslog
【相关命令】
· info-center syslog trap buffersize
terminal debugging命令用来允许调试信息输出到当前终端。
undo terminal debugging命令用来禁止调试信息输出到当前终端。
【命令】
terminal debugging
undo terminal debugging
【缺省情况】
不允许调试信息输出到当前终端。
【视图】
用户视图
【缺省用户角色】
network-admin
【使用指导】
调试信息指的是打开业务模块的调试信息开关后,业务模块生成的debugging级别的日志信息。
如果需要在控制台显示调试信息,请先配置terminal debugging命令,再使能信息中心功能(信息中心功能缺省处于使能状态),最后使用debugging命令打开功能模块的调试信息开关。
如果需要在监视终端上显示调试信息,请先配置terminal monitor和terminal debugging命令,再使能信息中心功能(信息中心功能缺省处于使能状态),最后使用debugging命令打开功能模块的调试信息开关。
需要注意的是,本命令只对当前连接有效。当终端与设备重新建立连接后,本命令会恢复到缺省情况。
执行terminal logging level 7命令或terminal debugging命令,都可以开启当前终端对调试信息的显示功能,但两条命令有如下区别:
· 执行terminal logging level 7命令,当前终端允许输出级别为0~7的所有日志。
· 执行terminal debugging命令,当前终端仅输出terminal logging level命令配置的日志信息和级别为7的调试信息。
【举例】
# 允许调试信息输出到当前终端。
<Sysname> terminal debugging
The current terminal is enabled to display debugging information.
【相关命令】
· terminal logging level
· terminal monitor
terminal logging level命令用来配置当前终端允许输出的日志信息的最低级别。
undo terminal logging level命令用来恢复缺省情况。
【命令】
terminal logging level severity
undo terminal logging level
【缺省情况】
当前终端允许输出的日志信息的最低级别均为6(Informational)。
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
severity:当前终端允许输出的日志信息的最低级别,取值为0~7的整数或者alert、critical、debugging、emergency、error、informational、notification、warning。
【使用指导】
在配置了当前终端允许输出的日志信息的最低级别后,当系统输出信息时,所有信息等级高于或等于配置等级的信息都会被输出。例如,当配置的允许输出的日志信息的最低级别6(informational)时,等级0~6的信息均会被输出。
本命令配置的显示属性只对当前连接有效,当终端与设备的连接超时、重新建立连接后,显示属性将恢复到缺省情况。
【举例】
# 配置当前终端监控的最低日志级别为debugging。
<Sysname> terminal logging level 7
terminal monitor命令用来允许日志信息输出到当前终端。
undo terminal monitor命令用来禁止日志信息输出到当前终端。
【命令】
terminal monitor
undo terminal monitor
【缺省情况】
允许日志信息输出到控制台,不允许日志信息输出到监视终端。
【视图】
用户视图
【缺省用户角色】
network-admin
【使用指导】
本命令只对当前连接有效。当终端与设备重新建立连接后,本命令会恢复到缺省情况。
【举例】
# 允许日志信息输出到当前终端。
<Sysname> terminal monitor
The current terminal is enabled to display logs.
trace-logfile save命令用来手动将调试跟踪日志文件缓冲区中的内容全部保存到调试跟踪日志文件。
【命令】
trace-logfile save
【视图】
任意视图
【缺省用户角色】
network-admin
【使用指导】
当设备自动保存调试跟踪日志文件的频率还未达到,使用本命令,可以立即将调试跟踪日志文件缓冲区中的内容全部保存到调试跟踪日志文件。
调试跟踪日志文件保存成功后,调试跟踪日志文件缓冲区中的内容会被清空。
如果执行本命令时,调试跟踪日志文件缓冲区中没有日志,本命令会执行成功,但不会创建或更新已有调试跟踪日志文件。
【举例】
# 手动将调试跟踪日志文件缓冲区中的内容全部保存到调试跟踪日志文件。
<Sysname> trace-logfile save
The contents in the trace log file buffer have been saved to the file flash:/tracefile/tracefile.log.
【相关命令】
· info-center trace-logfile enable
· info-center trace-logfile directory
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!