04-信息中心命令
本章节下载: 04-信息中心命令 (574.15 KB)
目 录
1.1.4 display diagnostic-logfile summary
1.1.6 display info-center class
1.1.7 display info-center file-server
1.1.8 display info-center filter
1.1.9 display info-center source
1.1.11 display logbuffer summary
1.1.13 display logfile summary
1.1.14 display security-logfile buffer
1.1.15 display security-logfile summary
1.1.18 info-center diagnostic-logfile directory
1.1.19 info-center diagnostic-logfile enable
1.1.20 info-center diagnostic-logfile frequency
1.1.21 info-center diagnostic-logfile quota
1.1.23 info-center file-server transport-type
1.1.24 info-center file-server user
1.1.28 info-center logbuffer size
1.1.29 info-center logfile directory
1.1.30 info-center logfile enable
1.1.31 info-center logfile frequency
1.1.32 info-center logfile size-quota
1.1.33 info-center logging suppress duplicates
1.1.34 info-center logging suppress module
1.1.36 info-center loghost loadbalance-group
1.1.37 info-center loghost locate-info with-sn
1.1.38 info-center loghost source
1.1.39 info-center output-profile
1.1.40 info-center security-logfile alarm-threshold
1.1.41 info-center security-logfile directory
1.1.42 info-center security-logfile enable
1.1.43 info-center security-logfile frequency
1.1.44 info-center security-logfile size-quota
1.1.46 info-center synchronous
1.1.47 info-center syslog min-age
1.1.48 info-center syslog trap buffersize
1.1.49 info-center syslog utf-8 enable
1.1.51 info-center timestamp loghost
1.1.52 info-center trace-logfile quota
1.1.58 snmp-agent trap enable syslog
character-set命令用来配置日志的编码方式。
undo character-set命令用来恢复缺省配置。
【命令】
character-set { gb18030 | utf-8 }
undo character-set
【缺省情况】
日志的编码方式为GB18030。
【视图】
日志输出模板视图
【缺省用户角色】
network-admin
【参数】
gb18030:配置日志使用GB18030编码方式。
utf-8:配置日志使用UTF-8编码方式。
【使用指导】
当用户使用登录软件登录设备,且设备往登录软件发送的信息中包含中文字符时,如果登录软件和设备使用的中文字符集编码不同,可能会出现中文字符在登录软件上显示为乱码的情况。
使用本命令可以将信息中心发送日志信息时使用的字符集编码配置为UTF-8或者GB18030。
info-center syslog utf-8 enable命令配置的编码方式对除Logbuf方向外的其它所有输出方向输出的日志生效。如果某日志主机引用了日志输出模板,且日志输出模板下配置了character-set命令,则发往该日志主机的日志使用character-set命令配置的编码方式。即character-set命令的配置优先级高于info-center syslog utf-8 enable命令的配置。
【举例】
# 配置日志输出模板profile1使用UTF-8编码方式。
<sysname> system-view
[sysname] info-center output-profile profile1
[sysname-ic-profile-profile1] character-set utf-8
【相关命令】
· info-center syslog utf-8 enable
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
192.168.0.1, log output filter: loghost1,
port number: 5000, DSCP value:0, 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
Operation 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 192.168.0.1, log output filter: loghost1, port number: 5000, DSCP value:0, host facility: local7 |
日志主机方向的信息: · Enabled:表示允许向日志主机输出日志。允许向日志主机输出日志后,根据用户的配置,还可能显示以下信息: ¡ 日志主机的IP地址 ¡ 关联的日志输出规则名称 ¡ 日志主机接收日志信息的端口 ¡ 日志消息的DSCP优先级 ¡ 日志主机的记录工具 · Disabled:表示禁止向日志主机输出日志 |
Log buffer: Enabled Max buffer size 1024, current buffer size 512, Current messages 0, dropped messages 0, overwritten messages 0 |
日志缓冲区方向的信息,包括开启状态、最大容量、当前容量、当前信息数、已丢弃的信息数、被覆盖的信息数 |
Log file |
日志文件方向当前的状态: · Enabled:表示允许向日志文件输出日志 · Disabled:表示禁止向日志文件输出日志 |
Operation 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 class命令用来显示日志分类下的模块信息。
【命令】
display info-center class [ class-name [ sub-class sub-class-name ] ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
class-name:显示指定日志分类下包含的子分类以及子分类下包含的业务模块信息。执行display info-center class ?命令可以获取该参数的取值,输入时不区分大小写。不指定该参数时,表示所有分类。
sub-class sub-class-name:显示指定日志子分类下包含的业务模块信息。执行display info-center class class-name sub-class ?命令可以获取该参数的取值,输入时不区分大小写。不指定该参数时,表示当前日志分类下的所有子分类。
【使用指导】
为方便用户管理日志,设备将生成的日志分为几个大类,每个大类下又细分子类,子类中可能包含多个业务模块。用户可以使用info-center filter命令配置允许/禁止指定分类、子类的日志输出,则设备只允许/禁止分类、子类包含的业务模块的日志输出。
使用本命令可以查询分类、子类下包含的业务模块的名称,以便协助用户配置info-center filter命令。
· 当不指定clas-name等参数时,显示所有日志分类下的模块列表。
· 当指定sub-class sub-class-name参数时,显示指定日志分类下的模块会由于服务未启动而模块名显示不全。
· 当指定class为system-log且sub-class为system-log时,只显示划分到system-log子类,且当前处于运行状态的业务模块的名称,未运行的业务模块的名称不显示。
【举例】
# 显示system-log分类ha子分类下的模块。
<Sysname> display info-center class system-log sub-class ha
Log class [ID]: system-log [0]
Sub-class [ID]: HA [5]
Included modules: HA, TRACK
表1-3 display info-center class命令显示信息描述表
字段 |
描述 |
Log class [ID] |
日志分类的名称[日志分类的编号] |
Sub-class [ID] |
日志子分类的名称[日志子分类的编号] |
Included modules |
日志分类/日志子分类中包含的业务模块名称 |
【相关命令】
· info-center filter
display info-center file-server命令用来显示远端服务器的相关配置以及备份记录。
【命令】
display info-center file-server
【视图】
用户视图
【缺省用户角色】
network-admin
network-operator
【使用指导】
当本机向远端服务器备份日志文件时,会记录本次备份操作的相关信息,最多可记录10条信息。使用本命令,可查看设备记录的备份操作信息,以便用户了解备份操作的执行时间和执行结果等信息。
【举例】
# 显示远端服务器的相关配置以及备份记录。
<Sysname> display info-center file-server
Username: test
Protocol: ftp
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 [ filter-name ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
filter-name:显示指定日志输出规则。filter-name表示日志信息输出规则的名称,必须为设备上已创建的日志输出规则。不指定该参数时,显示所有日志输出规则。
【举例】
# 显示用户创建的日志输出规则loghost1。
<Sysname> display info-center filter loghost1
Log output filter: loghost1
Module Mnemonic Rule
ARP INFO Debugging
CFGLOG cfg Deny
Default Informational
表1-4 display info-center filter命令显示信息描述表
字段 |
描述 |
Log output filter: |
日志输出规则名 |
Module |
输出规则中的模块 |
Mnemonic |
日志助记符的完整内容 |
Rule |
模块、大类/子类对应的输出规则,取值包括: · 日志等级:允许高于、等于该日志等级的日志输出 · Deny:不允许当前模块、大类/子类的日志输出 · Permit:允许当前大类/子类的日志输出 |
Log-Class |
输出规则中指定的日志大类 |
Log-SubClass |
输出规则中指定的日志子类 |
【相关命令】
· info-center filter
display info-center source命令用来显示日志信息的输出规则。
【命令】
display info-center source [ module module-name ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
module module-name:显示指定模块日志信息的输出规则。module-name表示模块的名称,配置时需要完整输入,不区分大小写,执行display info-center source module ?命令,通过帮助信息可获得该参数的取值。不指定该参数时,表示显示所有模块日志信息的输出规则。
【使用指导】
日志在各输出方向都有缺省输出规则,缺省输出规则请参见表1-5,用户也可以通过info-center source命令用来配置日志信息的输出规则,display info-center source命令显示的是日志信息当前的实际输出规则。
输出方向 |
日志信息来源 |
开关 |
等级 |
控制台 |
所有支持的模块 |
开 |
debugging |
监视终端 |
所有支持的模块 |
关 |
debugging |
日志主机 |
所有支持的模块 |
开 |
informational |
日志缓冲区 |
所有支持的模块 |
开 |
informational |
日志文件 |
所有支持的模块 |
开 |
informational |
【举例】
# 显示所有模块日志信息的输出规则。
<Sysname> display info-center source
Module Console Monitor Loghost Logbuffer Logfile Logtrap
AAA DEBUG DEBUG INFO INFO INFO INFO
ACL DEBUG DEBUG INFO INFO INFO INFO
ADJ4 DEBUG DEBUG INFO INFO INFO INFO
...
# 显示SYSLOG模块日志信息的输出规则。
<Sysname> display info-center source module syslog
Module Console Monitor Loghost Logbuffer Logfile Logtrap
SYSLOG DEBUG DEBUG INFO INFO INFO INFO
表1-6 display info-center source命令显示信息描述表
字段 |
描述 |
|
Module |
模块名称 |
|
Console |
在控制台的输出规则,若取值为deny则代表日志不允许在该方向输出 |
|
Monitor |
在监控终端的输出规则,若取值为deny则代表日志不允许在该方向输出 |
|
Loghost |
在日志主机的输出规则,若取值为deny则代表日志不允许在该方向输出 |
|
Logbuffer |
在日志缓冲区的输出规则,若取值为deny则代表日志不允许在该方向输出 |
|
Logfile |
在日志文件的输出规则,若取值为deny则代表日志不允许在该方向输出 |
|
Logtrap |
日志转换成SNMP告警输出的输出规则,若取值为deny则代表日志不允许在该方向输出 |
|
【相关命令】
· info-center source
display logbuffer命令用来显示日志缓冲区的状态和日志缓冲区记录的日志信息。
【命令】
display logbuffer [ reverse ] [ digest digest-info | level severity | size buffersize | slot slot-number ] * [ last-mins mins ] [ start-time time date ] [ end-time time date ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
reverse:指定日志的显示顺序为从新到旧。如果不指定该参数,将先显示旧日志,最后显示最新的日志。
digest digest-info:显示日志缓冲区中指定助记符的日志信息。不带该参数时将显示系统日志缓冲区内所有助记符的日志信息。
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表示单板所在的槽位号。如不指定本参数,将显示所有单板的日志缓冲区状态及日志缓冲区中记录的日志信息。对于本产品,slot-number只能为固定取值,无论是否指定本参数,均表示整台设备。
last-mins mins:指定显示最近一段时间日志缓冲区状态及日志缓冲区中记录的日志信息,取值范围为1~43200,单位为分钟。不指定该参数时,不对显示信息进行时间长度的限制。
start-time:显示日志缓冲区中生成时间为指定时间及之后的日志。不指定该参数时,表示不对日志生成的起始时间进行限制。
end-time:显示日志缓冲区中生成时间为指定时间及之前的日志。不指定该参数时,表示执行本命令时间及之前的日志。
time:表示时间,格式为HH:MM:SS(小时:分钟:秒),HH取值范围为0~23,MM和SS取值范围为0~59。如果要配置成整分,则可以不输入秒;如果要配置成整点,则可以不输入分和秒。比如将time参数配置为0表示零点。
date:表示日期,格式为MM/DD/YYYY(月/日/年)或者YYYY/MM/DD(年/月/日),MM的取值范围为1~12,DD的取值范围与月份有关,YYYY的取值范围为2000~2035。
【举例】
# 显示系统日志缓冲区的状态和缓冲区记录的日志信息。
<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 --
...
# 显示最近5分钟的日志缓冲区状态及日志缓冲区中记录的日志信息。
<Sysname> display logbuffer last-mins 5
Log buffer: Enabled
Max buffer size: 1024
Actual buffer size: 512
Dropped messages: 0
Overwritten messages: 0
Current messages: 191
%Jan 1 01:00:06:784 2019 Sysname SHELL/6/SHELL_CMD: -Line=vty0-IPAddr=192.168.1.242-User=**; Command is display current-configuration
%Jan 1 01:03:19:691 2019 Sysname SHELL/5/SHELL_LOGIN: VTY logged in from 192.168.1.33.
%Jan 1 01:03:21:269 2019 Sysname SHELL/6/SHELL_CMD: -Line=vty1-IPAddr=192.168.1.33-User=**; Command is display logbuffer last-mins 5
# 显示日志缓冲区中2023年1月1日1点及之后时间生成的日志。
<Sysname> display logbuffer start-time 01:00:0 1/1/2023
Log buffer: Enabled
Max buffer size: 1024
Actual buffer size: 512
Dropped messages: 0
Overwritten messages: 0
Current messages: 191
%Jan 1 01:00:06:784 2023 Sysname SHELL/6/SHELL_CMD: -Line=vty0-IPAddr=192.168.1.242-User=**; Command is display current-configuration
%Jan 1 01:03:19:691 2023 Sysname SHELL/5/SHELL_LOGIN: VTY logged in from 192.168.1.33.
%Jan 1 01:03:21:269 2023 Sysname SHELL/6/SHELL_CMD: -Line=vty1-IPAddr=192.168.1.33-User=**; Command is display logbuffer last-mins 5
表1-8 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-9。不带该参数时,将显示系统日志缓冲区内所有级别的日志概要信息。
数值 |
信息级别 |
描述 |
0 |
emergency |
表示设备不可用的信息,如系统授权已到期 |
1 |
alert |
表示设备出现重大故障,需要立刻做出反应的信息,如流量超出接口上限 |
2 |
critical |
表示严重信息,如设备温度已经超过预警值,设备电源、风扇出现故障等 |
3 |
error |
表示错误信息,如接口链路状态变化等 |
4 |
warning |
表示警告信息,如接口连接断开,内存耗尽告警等 |
5 |
notification |
表示正常出现但是重要的信息,如通过终端登录设备,设备重启等 |
6 |
informational |
表示需要记录的通知信息,如通过命令行输入命令的记录信息,执行ping命令的日志信息等 |
7 |
debugging |
表示调试过程产生的信息 |
slot slot-number:显示指定单板的日志缓冲区的概要信息。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
Slot EMERG ALERT CRIT ERROR WARN NOTIF INFO DEBUG
0 0 0 0 7 0 34 38 0
表1-10 display logbuffer summary命令显示信息描述表
字段 |
描述 |
EMERG |
emergency级别的信息数,请参见表1-9 |
ALERT |
alert级别的信息数,请参见表1-9 |
CRIT |
critical级别的信息数,请参见表1-9 |
ERROR |
error级别的信息数,请参见表1-9 |
WARN |
warning级别的信息数,请参见表1-9 |
NOTIF |
notification级别的信息数,请参见表1-9 |
INFO |
informational级别的信息数,请参见表1-9 |
DEBUG |
debugging级别的信息数,请参见表1-9 |
display logfile buffer命令用来显示日志文件缓冲区的内容。
【命令】
display logfile buffer
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【使用指导】
日志在保存到日志文件前,会先暂时缓存到日志文件缓冲区。当自动或者手动触发日志保存操作,系统才会将日志文件缓冲区中的内容保存到日志文件。保存成功后,日志文件缓冲区中的内容会被清空。
【举例】
# 显示日志文件缓冲区的内容。
<Sysname> display logfile buffer
%@356%Dec 13 16:53:45:495 2019 H3C SHELL/6/SHELL_CMD: -Line=con0-IPAddr=**-User=**; Command is logfile save.
【相关命令】
· info-center logfile frequency
· logfile save
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: 24 hour 0 min 10 sec
表1-11 display logfile summary命令显示信息描述表
字段 |
描述 |
Log file |
是否允许输出到日志文件方向: · Enabled:表示已开启 · Disabled:表示未开启 |
Log file size quota |
单个日志文件最大能占用的存储空间的大小,单位为MB |
Log file directory |
日志文件存储的路径 |
Writing frequency |
系统自动保存日志文件的频率 |
display security-logfile buffer命令用来显示安全日志文件缓冲区的内容。
【命令】
display security-logfile buffer
【视图】
任意视图
【缺省用户角色】
security-audit
【使用指导】
安全日志在保存到安全日志文件前,会先暂时缓存到安全日志缓冲区。当自动或者手动触发安全日志保存操作,系统才会将安全日志缓冲区中的内容保存到安全日志文件。保存成功后,安全日志缓冲区中的内容会被清空。
只有具有安全日志管理员角色的本地用户才能使用本命令。安全日志管理员的配置请参见“用户接入与认证配置指导”中的“AAA”。
【举例】
# 显示安全日志文件缓冲区的内容。
<Sysname> display security-logfile buffer
%@1%Sep 17 11:13:16:609 2019 Sysname SHELL/5/SHELL_LOGIN: Console logged in from con0.
【相关命令】
· info-center security-logfile frequency
· security-logfile save
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: 24 hour 0 min 0 sec
表1-12 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)
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
【举例】
# 禁止端口GigabitEthernet0/0/1在状态发生改变时生成Link up和Link down的日志信息。
<Sysname> system-view
[Sysname] interface gigabitethernet 0/0/1
[Sysname-GigabitEthernet0/0/1] undo enable log updown
format命令用来指定日志的格式。
undo format命令恢复缺省情况。
【命令】
format { binary-v1 | binary-v3 | binary-v7| cmcc | telecom | unicom }
undo format
【缺省情况】
日志信息的格式为非定制格式。
【视图】
日志输出模板视图
【缺省用户角色】
network-admin
【参数】
binary-v1:配置日志信息的输出格式为二进制v1格式。
binary-v3:配置日志信息的输出格式为二进制v3格式。
binary-v7:配置日志信息的输出格式为二进制v7格式。
cmcc:配置日志信息的输出格式为中国移动格式。
telecom:配置日志信息的输出格式为中国电信格式。
unicom:配置日志信息的输出格式为中国联通格式。
【使用指导】
本命令用来配置使用当前日志模板输出系统日志时,使用的日志格式。其中:
· binary-v1、binary-v3、binary-v7格式只有traffic-log日志子类或者traffic-log日志子类中包含的业务模块/子模块支持。这三种格式的差别为从binary-v1到binary-v3到binary-v7日志中包含的字段越来越多(携带的信息越来越丰富)。对于traffic-log日志,使用binary-v1、binary-v3、binary-v7格式发送,比使用cmcc、telecom、unicom、缺省格式发送,发送的速度更快。
· cmcc、telecom、unicom均为针对特定场景定制的格式,设备会按照用户定制的格式和内容输出日志到日志主机。
哪些业务模块的日志支持使用哪种日志格式输出,请参考下表:
格式 |
支持使用该格式输出日志的业务模块[子业务模块] |
binary-v1 |
· AFT · lb[dns-proxy]、lb[gslb]、lb[inbound]、lb[outbound]、lb[slb] · nat[sessionlog]、nat[port-block] · SESSION |
binary-v3 |
· AFT · lb[dns-proxy]、lb[gslb]、lb[inbound]、lb[outbound]、lb[slb] · nat[sessionlog]、nat[port-block] · SESSION |
binary-v7 |
· AFT · lb[dns-proxy]、lb[gslb]、lb[inbound]、lb[outbound]、lb[slb] · nat[sessionlog]、nat[port-block] · SESSION |
cmcc |
所有业务模块[子业务模块] |
telecom |
所有业务模块[子业务模块] |
unicom |
所有业务模块[子业务模块] |
缺省格式 |
所有业务模块[子业务模块] |
只有日志分类为traffic-log的日志支持binary-v1、binary-v3、binary-v7格式。info-center loghost命令配置的日志主机所关联的日志输出filter允许traffic-log类别的日志输出,binary-v1、binary-v3、binary-v7和telecom格式配置才会生效。
【举例】
# 配置日志输出模板profile1的日志格式是中国移动格式。
<sysname> system-view
[sysname] info-center output-profile profile1
[sysname-ic-profile-profile1] format cmcc
【相关命令】
· info-center format
· info-center loghost
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
【缺省情况】
单个诊断日志文件最大能占用的存储空间为10MB。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
size:单个诊断日志文件可使用的存储空间的最大值,取值范围为1~10,单位为MB。
【举例】
# 配置单个诊断日志文件最大能占用的存储空间的大小为6MB。
<Sysname> system-view
[Sysname] info-center diagnostic-logfile quota 6
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个字符的字符串,区分大小写。例如可以使用设备的IP地址作为文件名前缀,用来标识日志文件的生成设备。
file-type { logfile | security-logfile }:表示将指定类型的日志文件备份。
· logfile表示将info-center logfile directory命令指定的路径下的普通日志文件备份;
· security-logfile表示将info-center security-logfile directory命令指定的路径下的安全日志文件备份。不指定该参数时,表示将对应路径的普通日志文件和安全日志文件均备份。
【使用指导】
使用本命令可以将普通日志的日志文件和(或)安全日志的日志文件通过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服务器备份日志文件时使用的用户名,为1~63个字符的字符串,区分大小写。
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命令用来创建日志输出规则。
【命令】
info-center filter filter-name { { module-name [ mnemonic mnemonic-value ] | default } { deny | level severity } | class class-name [ sub-class sub-class-name ] permit }
undo info-center filter filter-name [ module-name [ mnemonic mnemonic-value ] | default | class class-name [ sub-class sub-class-name ] permit ]
【缺省情况】
未创建日志输出规则。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
filter-name:日志信息输出规则的名称,为1~8个字符的字符串,不区分大小写。
module-name:为指定模块配置日志输出规则,该参数的取值可通过在系统视图下输入info-center filter filter-name ?来获取。
mnemonic mnemonic-value:按照日志助记符对日志进行过滤。mnemonic-value表示助记符的全部内容,为1~32个字符的字符串,不区分大小写。如果输入的是助记符的部分内容,将过滤失败。不指定该参数时,表示仅按照模块名对日志进行过滤。
default:配置所有业务模块日志信息的缺省输出规则。
deny:禁止输出日志信息。
level severity:指定允许输出的日志信息的最低级别,取值为alert、critical、debugging、emergency、error、informational、notification、warning,各参数的含义请参见表1-13。例如,本参数配置为warning,则表示配置对emergency、alert、critical、error和warning级别的日志均生效。
数值 |
信息级别 |
描述 |
0 |
emergency |
表示设备不可用的信息,如系统授权已到期 |
1 |
alert |
表示设备出现重大故障,需要立刻做出反应的信息,如流量超出接口上限 |
2 |
critical |
表示严重信息,如设备温度已经超过预警值,设备电源、风扇出现故障等 |
3 |
error |
表示错误信息,如接口链路状态变化等 |
4 |
warning |
表示警告信息,如接口连接断开,内存耗尽告警等 |
5 |
notification |
表示正常出现但是重要的信息,如通过终端登录设备,设备重启等 |
6 |
informational |
表示需要记录的通知信息,如通过命令行输入命令的记录信息,执行ping命令的日志信息等 |
7 |
debugging |
表示调试过程产生的信息 |
class class-name [ sub-class sub-class-name ] permit:允许指定日志大类/子类的日志输出。其中:
· class-name表示日志大类的名称,为1~64个字符的字符串,不区分大小写,该参数的取值可通过在系统视图下输入info-center filter filter-name class ?来获取。未指定该参数时,表示不按照分类来过滤输出日志。
· sub-class-name表示日志子类的名称,为1~64个字符的字符串,不区分大小写,该参数的取值可通过在系统视图下输入info-center filter filter-name class class-name sub-class ?来获取。未指定该参数时,表示日志大类下的所有子类。
【使用指导】
当向日志主机发送日志时,可以使用本命令配置日志输出规则,来过滤发往日志主机的日志,以便设备只将用户关注的日志发往日志主机。
设备支持两种粒度定制日志输出规则:
· 模块粒度:按照生成日志的模块、日志的助记符来过滤日志。设备会将用户指定模块或者指定日志发往或者不发往日志主机。
· 分类粒度:为方便用户配置,设备将相关性较大的业务模块分类,用户注定允许指定日志大类/子类的日志发送给日志主机,设备会将这些大类/子类中包含的业务模块的日志都发送给日志主机,其效果等同于多次使用模块粒度配置。日志大类/子类中包含的业务模块可通过display info-center class命令查看。
多次执行本命令如果指定的filter-name参数取值相同,则配置结果为多次配置参数的合集。一条日志输出规则可以仅按照一种粒度配置,也可以配置两种粒度。
配置本命令时:
· 用户可以使用module-name参数为业务模块单独配置输出规则,对于未单独配置业务模块则使用default参数配置的缺省输出规则,这两种配置可以同时存在。
· 给业务模块单独配置输出规则后,必须使用module-name参数来修改或删除该规则。
· 如果配置了带module-name参数的命令,未配置带default参数的命令行,则未单独配置输出规则的业务模块允许alert~informational级别的日志输出。
· 多次使用module-name参数为同一业务模块配置输出规则时,最后一次执行的命令生效;多次使用default参数配置缺省输出规则时,最后一次执行的命令生效。
多次执行本命令可以创建多个输出规则,将输出规则和日志主机绑定,可以为不同的日志主机指定不同的输出规则。
info-center filter命令和info-center source命令都用来配置日志输出规则,两者区别在于:info-center filter命令配置的输出规则目前只支持应用到日志主机输出方向,info-center source命令配置的日志输出规则适用于所有输出方向。对于日志主机输出方向,info-center filter命令配置的输出规则优先于info-center source命令配置的输出规则。
· 当使用日志信息输出规则过滤发往日志邮件服务器的日志时,请不要指定class参数,如果指定class参数,该日志信息输出规则将不能生效。指定class参数的日志信息输出规则只能应用于日志主机方向。
· 大类的使能配置优先于子类的使能配置。例如,允许traffic-log大类的日志输出,然后又配置了禁止traffic-log大类下的NAT-AFT子类的日志输出,则按照大类配置优先于子类配置的原则,设备会允许输出NAT-AFT子类的日志。
<Sysname> system-view
[Sysname] info-center filter f1 class traffic-log permit
[Sysname] undo info-center filter f1 class traffic-log sub-clas nat-aft permit
【举例】
# 配置名称为loghost1的输出规则,用来允许ARP模块alert~notification级别的日志信息输出,其他模块的日志信息禁止输出。
<Sysname> system-view
[Sysname] info-center filter loghost1 arp level notification
[Sysname] info-center filter loghost1 default deny
【相关命令】
· 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 format和format命令均可用来配置向日志主机方向发送日志时日志的格式。其中:
· 系统视图下info-center format命令对所有日志主机生效。
· 日志输出模板视图下的format命令仅对引用该日志输出模板的日志主机生效。
日志输出模板视图下的配置优先于系统视图下的配置。如果日志主机绑定了日志输出模板,则设备给日志主机发送日志时使用日志输出模板中的配置,系统视图下的配置对该日志主机不生效。
【举例】
# 配置发往日志主机的日志信息的格式为中国联通格式。
<Sysname> system-view
[Sysname] info-center format unicom
【相关命令】
· format
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:日志缓冲区可存储的信息条数,取值范围为0~10240,缺省值为512。
【举例】
# 配置日志缓冲区可存储的信息条数为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 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
【使用指导】
配置本命令后,设备会将业务模块生成的日志保存到日志文件。其中,设备会为一些业务模块(例如会话、攻击防御等)创建单独的日志文件,用来分别存储这些业务模块的日志,其它业务模块的日志会统一存储到通用日志文件中。模块日志文件以模块名和“.log”后缀为文件名,形如:session.log等。
设备在出厂时已经确定了可以单独存储日志的业务模块的名称,用户不能修改。
【举例】
# 配置允许日志信息输出到日志文件。
<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
【缺省情况】
单个日志文件最大能占用的存储空间为10MB。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
size:单个日志文件可使用的存储空间的最大值,取值范围为1~10,单位为MB。
【举例】
# 配置单个日志文件最大能占用的存储空间的大小为6MB。
<Sysname> system-view
[Sysname] info-center logfile size-quota 6
【相关命令】
· info-center logfile enable
info-center logging suppress duplicates命令用来开启抑制重复日志输出功能。
undo info-center logging suppress duplicates命令用关闭抑制重复日志输出功能。
【命令】
info-center logging suppress duplicates
undo info-center logging suppress duplicates
【缺省情况】
抑制重复日志输出功能处于关闭状态。
【视图】
系统视图
【缺省用户角色】
network-admin
【使用指导】
当设备持续生成相同的日志,大量重复的信息会浪费设备资源和网络资源,并导致有用的信息被淹没,不利于设备的维护。为了避免此问题,可开启重复日志抑制功能。
【举例】
# 开启抑制重复日志输出功能。
<Sysname> system-view
[Sysname] info-center logging suppress duplicates
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 } [ port port-number ] [ dscp dscp-value ] [ facility local-number ] [ filter filter-name ] [ output-profile profile-name ] [ tcp [ ssl-client-policy policy-name ] [ source-ip source-address ]
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个字符的字符串,不区分大小写。字符串中只能包含字母、数字、“-”、“_”和“.”,且需满足以下要求:
· 主机名以“.”字符分割成多个字符串,单个字符串的长度不超过63个字符。
· 主机名不能以“.”字符开头或结尾。
· 主机名不能包含两个连续的“.”字符。
ipv4-address:指定日志主机的IPv4地址。
ipv6 ipv6-address:指定日志主机的IPv6地址。
port port-number:指定日志主机接收日志信息的端口号,取值范围为1~65535,缺省值为514。该参数的值需要和日志主机侧的配置一致,否则日志主机接收不到日志信息。
dscp dscp-value:指定日志消息的DSCP(Differentiated Services Code Point,差分服务代码点)优先级,取值范围为0~63,缺省值为0。值越大表示优先级越高。DSCP优先级封装在IP报文中的ToS字段,用来表示报文自身的优先级,设备可根据该优先级决定报文传输的优先程度。
facility local-number:配置日志主机的记录工具。取值范围为local0~local7,缺省值为local7。主要用于在日志主机端标志不同的日志来源,查找、过滤对应日志源的日志。
filter filter-name:指定日志主机关联的日志输出规则的名称,只有符合规则的日志才能输出到对应的日志主机。filter-name表示日志信息输出规则的名称,为1~8个字符的字符串,不区分大小写。不指定该参数时,则采用info-center source命令日志主机方向的配置作为日志输出规则。
output-profile profile-name:指定日志主机关联的日志输出模板的名称,为1~8个字符的字符串,不区分大小写。不指定该参数时,采用缺省输出参数。
tcp:配置使用TCP协议发送日志。缺省使用UDP协议发送日志。
ssl-client-policy policy-name:配置使用基于TCP协议的SSL加密方式发送日志。policy-name表示SSL客户端策略名称,为1~31个字符的字符串,不区分大小写。不指定该参数时,表示使用非加密方式发送日志。
source-ip source-address:配置发往指定日志主机的日志信息中使用的源IP地址。不指定该参数时,使用info-center loghost source命令中配置的源IP地址。日志主机可依据该参数来标识日志的生成者。
【使用指导】
如果要使用SSL加密方式发送日志,请先完成SSL客户端策略的相关配置,否则,SSL连接无法建立,会导致日志无法发送给日志主机。关于SSL客户端策略的相关配置请参见“安全配置指导”中的“SSL”。
用户只有使用info-center enable命令开启了信息中心功能,配置info-center loghost命令才会生效。
多次执行本命令可配置多个日志主机,设备最多可配置的日志主机的为20个。
【举例】
# 配置系统向IP地址为1.1.1.1的日志主机发送日志信息。
<Sysname> system-view
[Sysname] info-center loghost 1.1.1.1
【相关命令】
· info-center filter
· info-center source
info-center loghost loadbalance-group命令用来创建日志主机负载均衡组,并进入日志主机负载均衡组视图。如果日志主机负载均衡组已创建,则直接进入日志主机负载均衡组视图。
undo info-center loghost loadbalance-group命令用来删除日志主机负载均衡组。
【命令】
info-center loghost loadbalance-group name
undo info-center loghost loadbalance-group name
【缺省情况】
不存在日志主机负载均衡组。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
name:表示日志主机负载均衡组的名称,为1~8个字符的字符串,区分大小写。
【使用指导】
当会话日志量较大,且需要将会话日志输出到日志主机时,使用日志主机负载均衡组,可以将会话日志以负载分担方式发送给负载均衡组中的日志主机,以免短时间内大量会话日志占用日志主机的存储空间,影响日志主机的性能。
使用info-center loghost命令指定日志主机后,这些日志主机互为备份,设备会将生成的日志同时发送给这些日志主机。创建日志主机负载均衡组,并将info-center loghost命令指定的(部分)日志主机添加到负载均衡组后,设备给负载均衡组中的日志主机发送日志时会进行如下处理:
· 对于会话日志,设备会按照会话发起端的IP地址对会话日志进行负载分担,从而实现:发起端A的会话日志发给日志主机1,发起端B的会话日志发给日志主机2。
一条会话日志只发送给负载均衡组中的一台日志主机。
负载均衡组配置不变,且发起端IP地址不变的情况下,这个发起端的会话日志始终发送到同一日志主机。
· 对于非会话日志,设备会将这样的日志同时发送给负载均衡组中的所有日志主机。
一个负载均衡组内的日志主机如果绑定了Filter(通过info-center filter命令配置)、日志输出模板(通过info-center output-profile命令配置),则要求绑定的Filter、日志输出模板必须保持一致。
多次执行本命令可配置多个日志主机负载均衡组。
【举例】
# 创建负载均衡组test,并进入负载均衡组视图。
<Sysname> system-view
[Sysname] info-center loghost loadbalance-group test
[sysname-ic-lb-group-test]
【相关命令】
· info-center filter
· info-center loghost
· info-center output-profile
· loghost
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
【使用指导】
info-center loghost locate-info with-sn和locate-info with-sn命令均可用来配置向日志主机方向发送日志时,在日志定位信息中携带设备序列号。其中:
· 系统视图下info-center loghost locate-info with-sn命令对所有日志主机生效。
· 日志输出模板视图下的locate-info with-sn命令仅对引用该日志输出模板的日志主机生效。
日志输出模板视图下的配置优先于系统视图下的配置。如果日志主机绑定了日志输出模板,则设备给日志主机发送日志时使用日志输出模板中的配置,系统视图下的配置对该日志主机不生效。
【举例】
# 配置向日志主机方向发送日志时,在日志定位信息中携带设备序列号。
<Sysname> system-view
[Sysname] info-center loghost locate-info with-sn
【相关命令】
· 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命令才会生效。
【举例】
# 配置使用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 output-profile命令用来创建日志输出模板,并进入日志输出模板视图。如果日志输出模板已创建,则直接进入日志输出模板视图。
undo info-center output-profile命令用来删除日志输出模板。
【命令】
info-center output-profile profile-name
undo info-center output-profile profile-name
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
profile-name:指定日志输出模板的名称,为1~8个字符的字符串,区分大小写。
【使用指导】
通过创建一个日志输出模板,并将日志输出模板和日志主机绑定,可以为指定日志主机定制日志输出参数,例如,日志的封装格式、编码格式、时间戳、是否携带序列号等。
【举例】
# 创建日志格式模板profile1,并进入日志格式模板视图。
<Sysname> system-view
[Sysname] info-center output-profile profile1
[sysname-ic-profile-profile1]
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 directory命令用来修改存储安全日志文件的路径。
【命令】
info-center security-logfile directory dir-name
【缺省情况】
存储安全日志文件路径为设备缺省文件系统根目录下的seclog文件夹。
【视图】
系统视图
【缺省用户角色】
security-audit
【参数】
dir-name:安全日志文件存储的路径,为1~64个字符的字符串。
【使用指导】
在执行该配置前,存储安全日志文件的文件夹必须为当前已创建的目录。
只有配置了安全日志管理员权限的本地用户才能使用本命令。安全日志管理员的配置请参见“用户接入与认证配置指导”中的“AAA”。
配置会在设备重启或主用主控板和备用主控板倒换后失效。
【举例】
# 配置存放安全日志文件的目录为flashsda0:/test。
<Sysname> mkdir test
Creating directory flash:/test... Done.
<Sysname> system-view
[Sysname] info-center security-logfile directory flash:/test
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-14:
输出方向 |
日志信息来源 |
开关 |
等级 |
控制台 |
所有支持的模块 |
开 |
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-15。例如,本参数配置为warning,则表示配置对emergency、alert、critical、error和warning级别的日志均生效。
数值 |
信息级别 |
描述 |
0 |
emergency |
表示设备不可用的信息,如系统授权已到期 |
1 |
alert |
表示设备出现重大故障,需要立刻做出反应的信息,如流量超出接口上限 |
2 |
critical |
表示严重信息,如设备温度已经超过预警值,设备电源、风扇出现故障等 |
3 |
error |
表示错误信息,如接口链路状态变化等 |
4 |
warning |
表示警告信息,如接口连接断开,内存耗尽告警等 |
5 |
notification |
表示正常出现但是重要的信息,如通过终端登录设备,设备重启等 |
6 |
informational |
表示需要记录的通知信息,如通过命令行输入命令的记录信息,执行ping命令的日志信息等 |
7 |
debugging |
表示调试过程产生的信息 |
【使用指导】
如果没有使用module-name参数为业务模块单独配置输出规则,则该模块使用default参数配置的输出规则。如果未使用default参数配置输出规则,则使用缺省输出规则。
给业务模块单独配置输出规则后,必须使用module-name参数来修改或删除该规则,使用default参数进行的新配置对该模块不生效。
多次使用module-name参数为同一业务模块配置输出规则,最后一次执行的命令生效;多次使用default参数配置缺省输出规则,最后一次执行的命令生效。
【举例】
# 只允许DEV模块的信息输出控制台,且输出信息的级别为emergency的日志信息。
<Sysname> system-view
[Sysname] info-center source default console deny
[Sysname] info-center source dev console level emergency
# 不允许ARP业务模块的日志输出到控制台,其它业务模块的日志均允许输出到控制台。
<Sysname> system-view
[Sysname] info-center source arp console deny
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 2019 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 2019 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 syslog utf-8 enable命令用来配置信息中心使用UTF-8编码方式输出日志。
undo info-center syslog utf-8 enable命令用来恢复缺省情况。
【命令】
info-center syslog utf-8 enable
undo info-center syslog utf-8 enable
【缺省情况】
信息中心使用GB18030编码方式输出日志。
【视图】
系统视图
【缺省用户角色】
network-admin
【使用指导】
当用户使用登录软件登录设备,且设备往登录软件发送的信息中包含中文字符时,如果登录软件和设备使用的中文字符集编码不同,可能会出现中文字符在登录软件上显示为乱码的情况。
使用本命令可以将信息中心发送日志信息时使用的字符集编码配置为UTF-8或者GB18030。
info-center syslog utf-8 enable命令配置的编码方式对除Logbuf方向外的其它所有输出方向输出的日志生效。如果某日志主机引用了日志输出模板,且日志输出模板下配置了character-set命令,则发往该日志主机的日志使用character-set命令配置的编码方式。即character-set命令的配置优先级高于info-center syslog utf-8 enable命令的配置。
【举例】
# 配置信息中心使用UTF-8编码方式输出日志。
<Sysname> system-view
[Sysname] info-center syslog utf-8 enable
【相关命令】
· display character-set
· character-set
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 2019)。
date:系统当前的日期和时间,格式为“MMM DD hh:mm:ss:ms YYYY”,形如Dec 8 10:12:21:708 2019。
· “MMM”为英语月份的缩写,具体取值如下:Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec。
· “DD”表示日期,如果日期的值小于10,则格式为“空格+日期”,如“ 7”。
· “hh:mm:ss:ms”表示本地时间,hh的取值范围为00~23,mm和ss的取值范围均为00~59,ms的取值范围为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 [ with-milliseconds ] | iso [ with-milliseconds | with-timezone ] * | no-year-date | none }
undo info-center timestamp loghost
【缺省情况】
发往日志主机的日志信息的时间戳输出格式为date格式。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
date:配置时间戳输出格式为:MMM DD hh:mm:ss YYYY,形如Dec 8 10:12:21 2019,但最终显示格式由日志主机决定。
iso:配置时间戳输出格式为ISO 8601标准格式,形如:2019-09-21T15:32:55。
with-milliseconds:表示时间戳精确到毫秒,且毫秒用标准点号分割。对于date格式的时间戳,加毫秒后,形如:Dec 8 10:12:21.708 2019;对于iso格式的时间戳,加毫秒后,形如:2019-09-21T15:32:55.708。不指定该参数时,表示时间戳精确到秒。
with-timezone:在时间戳中携带时区信息,形如:2019-09-21T15:32:55+01:00。不指定该参数时,表示在时间戳中不带时区信息。
no-year-date:系统当前日期和时间,但不包含年份和毫秒信息。
none:不带时间信息。
【使用指导】
info-center timestamp loghost和timestamp命令均可用来配置向日志主机方向发送日志时日志的格式。其中:
· 系统视图下info-center timestamp loghost命令对所有日志主机生效。
· 日志输出模板视图下的timestamp命令仅对引用该日志输出模板的日志主机生效。
日志输出模板视图下的配置优先于系统视图下的配置。如果日志主机绑定了日志输出模板,则设备给日志主机发送日志时使用日志输出模板中的配置,系统视图下的配置对该日志主机不生效。
【举例】
# 配置发往日志主机的日志信息的时间戳为no-year-date格式。
<Sysname> system-view
[Sysname] info-center timestamp loghost no-year-date
【相关命令】
· info-center timestamp
· timestamp
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
locate-info with-sn命令用来配置在日志内容部分携带设备的序列号。
undo locate-info with-sn命令用来恢复缺省情况。
【命令】
locate-info with-sn
undo locate-info with-sn
【缺省情况】
日志内容部分不携带设备的序列号。
【视图】
日志输出模板视图
【缺省用户角色】
network-admin
【使用指导】
配置本功能后,设备发送的日志内容中将增加设备序列号(SN)字段,方便用户识别设备。
info-center loghost locate-info with-sn和locate-info with-sn命令均可用来配置向日志主机方向发送日志时,在日志定位信息中携带设备序列号。其中:
· 系统视图下info-center loghost locate-info with-sn命令对所有日志主机生效。
· 日志输出模板视图下的locate-info with-sn命令仅对引用该日志输出模板的日志主机生效。
日志输出模板视图下的配置优先于系统视图下的配置。如果日志主机绑定了日志输出模板,则设备给日志主机发送日志时使用日志输出模板中的配置,系统视图下的配置对该日志主机不生效。
【举例】
# 配置日志输出模板profile1在日志内容部分携带设备的序列号。
<sysname> system-view
[Sysname] info-center output-profile profile1
[sysname-ic-profile-profile1]locate-info with-sn
【相关命令】
· info-center loghost
· info-center loghost locate-info with-sn
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/logfile1.log:/logfile/logfile.log.
【相关命令】
· info-center logfile enable
· info-center logfile directory
loghost命令用来为日志主机负载均衡组添加日志主机。
undo loghost命令用来将日志主机从日志主机负载均衡组中删除。
【命令】
loghost [ vpn-instance vpn-instance-name ] { hostname | ipv4-address | ipv6 ipv6-address }
undo 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地址。
【使用指导】
本命令用于为日志主机负载均衡组添加日志主机,从而实现将会话日志以负载分担的方式发送给这些日志主机。
请确保设备到指定的日志主机之间路由可达。如果指定的日志主机不可达,则发往该日志主机的会话日志会直接被丢弃,负载均衡组中的其它日志主机上也不会存在这些会话日志。
请先执行info-center loghost命令配置日志主机,再配置本命令。否则,本命令执行失败。
一个日志主机只能添加到一个负载均衡组。一个负载均衡组中日志主机绑定的日志输出规则(通过info-center filter命令配置)和日志输出模板(通过info-center output-profile命令配置)必须一样。
【举例】
# 为负载均衡组test添加日志主机1.1.1.1。
<Sysname> system-view
[Sysname] info-center loghost loadbalance-group test
[sysname-ic-lb-group-test] loghost 1.1.1.1
【相关命令】
· info-center filter
· info-center loghost
· info-center output-profile
· loghost
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.
【相关命令】
· info-center security-logfile directory
· authorization-attribute(用户接入与认证命令参考/AAA)
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 logs.
【相关命令】
· 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.
timestamp命令用来指定日志的时间戳格式。
undo timestamp命令用来恢复缺省情况。
【命令】
timestamp [ utc ] { date [ with-milliseconds ] | iso [ with-milliseconds | with-timezone ] * | no-year-date | none }
undo timestamp
【缺省情况】
日志的时间戳格式是date格式。
【视图】
日志输出模板视图
【缺省用户角色】
network-admin
【参数】
utc:表示使用格林威治时间作为时间戳。不指定该参数时,表示使用UTC、夏令时和时区综合计算后的设备当前系统时间作为时间戳。
date:配置时间戳输出格式为:MMM DD hh:mm:ss YYYY,形如Dec 8 10:12:21 2019,但最终显示格式由日志主机决定。
with-milliseconds:表示时间戳精确到毫秒,且毫秒用标准点号分割。对于date格式的时间戳,加毫秒后,形如:Dec 8 10:12:21.708 2019;对于iso格式的时间戳,加毫秒后,形如:2019-09-21T15:32:55.708。不指定该参数时,表示时间戳精确到秒。
iso:配置时间戳输出格式为ISO 8601标准格式,形如:2019-09-21T15:32:55,但最终显示格式由日志主机决定。
with-timezone:在时间戳中携带时区信息,形如:2019-09-21T15:32:55+01:00。不指定该参数时,表示在时间戳中不带时区信息。
no-year-date:所选时间戳日期和时间,但不包含年份和毫秒信息。
none:不带时间信息。
【使用指导】
本命令用于配置设备发往日志主机的日志中携带的时间戳格式,以便网络管理员准确地了解日志在设备上生成的时间。
配置本命令时,用户可以选择使用UTC或者本机的系统时间作为时间戳。本机的系统时间是由UTC时间和本地配置的时区、夏令时计算后得到的时间。执行display clock命令可查看本机的系统时间。
· 如果显示信息中包含UTC字样,则表示当前的系统时间为UTC时间,例如:
<Sysname> display clock
10:09:00.258 UTC Fri 03/16/2023
· 如果显示信息中未包含UTC字样,则表示当前的系统时间为非UTC时间,例如:
<Sysname> display clock
15:11:00.211 Z5 Fri 03/16/2023
Time Zone : Z5 add 05:00:00
Summer Time : PDT 06:00:00 08/01 06:00:00 09/01 01:00:00
Time Zone表示配置了时区,Summer Time表示配置了夏令时。
关于系统时间命令的详细介绍,请参见“设备管理配置指导”中的“设备基本配置”。
· 未指定utc参数表示使用本机的系统时间作为时间戳
· 如果本设备上未配置时区和夏令时,则本机的系统时间就是UTC时间。此时,配置utc和不配置utc参数效果相同。
· 如果本设备上配置了时区和夏令时,且日志主机也基于时区、夏令时来管理整个网络的日志,此时,无需配置utc参数。
【举例】
# 配置日志输出模板profile1的时间戳格式是no-year-date格式。
<sysname> system-view
[sysname] info-center output-profile profile1
[sysname-ic-profile-profile1] timestamp no-year-date
【相关命令】
· info-center loghost
· info-center timestamp loghost
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!