- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 新华三人才研学中心
- 关于我们
27-SNMP-RMON命令
本章节下载： 27-SNMP-RMON命令 (321.88 KB)
目 录
1.1.1 display snmp-agent community
1.1.2 display snmp-agent group
1.1.3 display snmp-agent local-engineid
1.1.4 display snmp-agent mib-view
1.1.5 display snmp-agent statistics
1.1.6 display snmp-agent sys-info
1.1.7 display snmp-agent trap queue
1.1.8 display snmp-agent trap-list
1.1.9 display snmp-agent usm-user
1.1.10 enable snmp trap updown
1.1.12 snmp-agent calculate-password
1.1.15 snmp-agent local-engineid
1.1.18 snmp-agent packet max-size
1.1.22 snmp-agent trap if-mib link extended
1.1.24 snmp-agent trap queue-size
1.1.26 snmp-agent usm-user { v1 | v2c }
【命令】
display snmp-agent community [ read | write ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
read：显示只读访问权限的团体信息。
write：显示读写访问权限的团体信息。
【描述】
display snmp-agent community命令用来显示SNMP v1或SNMP v2c团体信息。
【举例】
# 显示设备当前所有已配置的团体信息。
<Sysname> display snmp-agent community
Community name: aa
Group name: aa
Acl:2001
Storage-type: nonVolatile
Community name: bb
Group name: bb
Storage-type: nonVolatile
Community name: userv1
Group name: testv1
Storage-type: nonVolatile
表1-1 display snmp-agent community命令显示信息描述表
|
字段 |
描述 |
|
Community name |
团体名，如果团体名是通过snmp-agent community命令创建的，则显示的是团体名；如果团体名是通过snmp-agent usm-user { v1 | v2c }命令创建的，则显示的是用户名 |
|
Group name |
组名，如果团体名是通过snmp-agent community命令创建的，则组名和团体名相同；如果团体名是通过snmp-agent usm-user { v1 | v2c }命令创建的，则显示用户所在的组名 |
|
Acl |
使用的ACL表的编号，配置ACL列表后，只有IP地址符合ACL列表要求的NMS才能访问设备 |
|
Storage-type |
表示存储类型，有以下几种： l volatile（重启后信息丢失） l nonVolatile（重启后信息仍保存） l permanent（重启后信息仍保存，允许更改，但不许删除） l readOnly（重启后信息仍保存，既不允许更改，也不许删除） l other（其他） |
【命令】
display snmp-agent group [ group-name ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
group-name：指定要显示SNMP信息的组名，为1～32个字符的字符串，区分大小写。
【描述】
display snmp-agent group命令用来显示组信息，包括组名、安全模式、视图、存储方式等。不带参数时，显示所有组的信息。
【举例】
# 显示所有SNMP组的信息。
<Sysname> display snmp-agent group
Group name: groupv3
Security model: v3 noAuthnoPriv
Readview: ViewDefault
Writeview: <no specified>
Notifyview: <no specified>
Storage-type: nonVolatile
表1-2 display snmp-agent group命令显示信息描述表
|
字段 |
描述 |
|
Group name |
SNMP组名 |
|
Security model |
该组的安全模式，分为三种：authPriv（有认证有加密）、authNoPriv（有认证无加密）、noAuthNoPriv（无认证无加密） |
|
Readview |
该组对应的只读的MIB视图名 |
|
Writeview |
该组对应的可写的MIB视图名 |
|
Notifyview |
该组对应的可以发Trap消息的MIB视图名 |
|
Storage-type |
存储方式，有以下几种类型：volatile、nonVolatile、permanent、readOnly、other，请参见表1-1 |
【命令】
display snmp-agent local-engineid
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
无
【描述】
display snmp-agent local-engineid命令用来显示设备的SNMP实体引擎ID。
SNMP实体引擎ID是SNMP实体的唯一标识，它在一个SNMP管理域内是唯一的。SNMP实体引擎是SNMP实体的重要组成部分，完成SNMP消息的消息调度、消息处理、安全验证、访问控制等功能。
【举例】
# 显示本地设备的SNMP实体引擎ID。
<Sysname> display snmp-agent local-engineid
SNMP local EngineID: 800007DB7F0000013859
【命令】
display snmp-agent mib-view [ exclude | include | viewname view-name ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
exclude：显示属性为exclude的MIB视图的信息。
include：显示属性为include的MIB视图的信息。
viewname view-name：按名称显示指定名称的MIB视图的信息，view-name表示视图的名称，为1～32个字符的字符串。
【描述】
display snmp-agent mib-view命令用来显示MIB视图的信息。不带参数时，显示所有MIB视图的信息。
【举例】
# 显示设备的所有MIB视图。
<Sysname> display snmp-agent mib-view
View name:ViewDefault
MIB Subtree:iso
Subtree mask:
Storage-type: nonVolatile
View Type:included
View status:active
View name:ViewDefault
MIB Subtree:snmpUsmMIB
Subtree mask:
Storage-type: nonVolatile
View Type:excluded
View status:active
View name:ViewDefault
MIB Subtree:snmpVacmMIB
Subtree mask:
Storage-type: nonVolatile
View Type:excluded
View status:active
View name:ViewDefault
MIB Subtree:snmpModules.18
Subtree mask:
Storage-type: nonVolatile
View Type:excluded
View status:active
ViewDefault是设备的缺省视图，使用ViewDefault视图访问设备时，除了snmpUsmMIB、snmpVacmMIB、snmpModules.18子树下的MIB对象，可以访问iso子树下其它所有MIB对象。
表1-3 display snmp-agent mib-view命令显示信息描述表
|
字段 |
描述 |
|
View name |
视图名 |
|
MIB Subtree |
该视图对应的MIB子树 |
|
Subtree mask |
MIB子树的掩码 |
|
Storage-type |
存储方式 |
|
View Type |
MIB视图的类型，包括included和excluded两种： l included表示当前视图包括该子树的所有节点，即可以访问子树内的所有MIB对象 l excluded表示当前视图不包括该子树的任意节点，即子树内的所有MIB对象都不能被访问 |
|
View status |
用来指示MIB视图的状态 |
【命令】
display snmp-agent statistics
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
无
【描述】
display snmp-agent statistics命令用来显示SNMP报文的统计信息。
【举例】
# 显示SNMP报文的统计信息。
<Sysname> display snmp-agent statistics
1684 Messages delivered to the SNMP entity
5 Messages which were for an unsupported version
0 Messages which used a SNMP community name not known
0 Messages which represented an illegal operation for the community supplied
0 ASN.1 or BER errors in the process of decoding
1679 Messages passed from the SNMP entity
0 SNMP PDUs which had badValue error-status
0 SNMP PDUs which had genErr error-status
0 SNMP PDUs which had noSuchName error-status
0 SNMP PDUs which had tooBig error-status (Maximum packet size 1500)
16544 MIB objects retrieved successfully
2 MIB objects altered successfully
7 GetRequest-PDU accepted and processed
7 GetNextRequest-PDU accepted and processed
1653 GetBulkRequest-PDU accepted and processed
1669 GetResponse-PDU accepted and processed
2 SetRequest-PDU accepted and processed
0 Trap PDUs accepted and processed
0 Alternate Response Class PDUs dropped silently
0 Forwarded Confirmed Class PDUs dropped silently
表1-4 display snmp-agent statistics命令显示信息描述表
|
字段 |
描述 |
|
Messages delivered to the SNMP entity |
SNMP Agent收到的数据报文个数 |
|
Messages which were for an unsupported version |
版本不支持的数据报文个数 |
|
Messages which used a SNMP community name not known |
使用了非法团体名的数据报文个数 |
|
Messages which represented an illegal operation for the community supplied |
包含了超出团体名权限的操作的数据报文个数 |
|
ASN.1 or BER errors in the process of decoding |
在解码过程中发生ASN.1或BER错误的数据报文个数 |
|
Messages passed from the SNMP entity |
Agent收到的来自别的SNMP实体的数据报文个数 |
|
SNMP PDUs which had badValue error-status |
错误类型为BadValues的数据报文个数 |
|
SNMP PDUs which had genErr error-status |
General错误的数据报文个数 |
|
SNMP PDUs which had noSuchName error-status |
NoSuchName错误的数据报文个数 |
|
SNMP PDUs which had tooBig error-status (Maximum packet size 1500) |
TooBig错误的数据报文个数(最大报文尺寸1500字节) |
|
MIB objects retrieved successfully |
已成功获取的MIB对象个数 |
|
MIB objects altered successfully |
已成功修改的MIB对象个数 |
|
GetRequest-PDU accepted and processed |
已接收并处理的Get请求的个数 |
|
GetNextRequest-PDU accepted and processed |
已接收并处理的GetNext请求的个数 |
|
GetBulkRequest-PDU accepted and processed |
已接收并处理的GetBulk请求的个数 |
|
GetResponse-PDU accepted and processed |
已接收并处理的Get响应的个数 |
|
SetRequest-PDU accepted and processed |
已接收并处理的Set请求的个数 |
|
Trap PDUs accepted and processed |
已接收并处理的Trap消息的个数 |
|
Alternate Response Class PDUs dropped silently |
被丢弃的响应数据报文个数 |
|
Forwarded Confirmed Class PDUs dropped silently |
被丢弃的转发数据报文个数 |
【命令】
display snmp-agent sys-info [ contact | location | version ] *
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
contact：显示当前设备维护人的联系信息。
location：显示当前设备的物理位置信息。
version：显示当前设备中运行的SNMP版本号。
【描述】
display snmp-agent sys-info命令用来显示当前SNMP设备的系统信息。
不指定参数时，显示设备的全部系统信息。
【举例】
# 显示设备系统信息。
<Sysname> display snmp-agent sys-info
The contact person for this managed node:
Hangzhou H3C Tech.Co., Ltd.
The physical location of this node:
Hangzhou, China
SNMP version running in the system:
SNMPv3
【命令】
display snmp-agent trap queue
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
无
【描述】
display snmp-agent trap queue命令用来显示Trap消息队列的基本信息，包括Trap队列名、队列长度，以及队列中当前Trap消息的数量。
相关配置可参考命令和snmp-agent trap life和snmp-agent trap queue-size。
【举例】
# 显示当前trap队列的配置及使用情况。
<Sysname> display snmp-agent trap queue
Queue name: SNTP
Queue size: 100
Message number: 6
表1-5 display snmp-agent trap queue命令显示信息描述表
|
字段 |
描述 |
|
Queue name |
Trap消息队列名 |
|
Queue size |
Trap消息队列长度 |
|
Message number |
Trap消息队列中当前Trap消息的个数 |
【命令】
display snmp-agent trap-list
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
无
【描述】
display snmp-agent trap-list命令用来显示系统当前可以生成Trap消息的模块及其Trap消息的使能状态。
如果一个模块包含多个子模块，则只要有任何一个子模块的Trap信息是使能的，就显示整个模块是使能的。
相关配置可参考命令snmp-agent trap enable。
【举例】
# 显示系统当前可以生成Trap消息的模块及其Trap消息的使能状态。
<Sysname> display snmp-agent trap-list
configuration trap enable
flash trap enable
standard trap enable
system trap enable
Enable traps: 4; Disable traps: 0
以上显示信息中enable表示允许该模块生成Trap消息，disable表示不允许该模块生成Trap消息。enable或者disable可以通过命令行配置。
【命令】
display snmp-agent usm-user [ engineid engineid | username user-name | group group-name ]*
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
engineid engineid：显示指定引擎ID的SNMP v3用户信息，engineid表示SNMP引擎ID。
username user-name：显示指定名字的SNMP v3用户信息，区分大小写。
group group-name：显示属于指定SNMP组的SNMP v3用户信息，区分大小写。
【描述】
display snmp-agent usm-user命令用来显示SNMP v3用户信息。
【举例】
# 显示设备上已创建的所有用户的信息。
<Sysname> display snmp-agent usm-user
User name: userv3
Group name: mygroupv3
Engine ID: 800063A203000FE240A1A6
Storage-type: nonVolatile
UserStatus: active
User name: userv3code
Group name: groupv3code
Engine ID: 800063A203000FE240A1A6
Storage-type: nonVolatile
UserStatus: active
表1-6 display snmp-agent usm-user命令显示信息描述表
|
字段 |
描述 |
|
User name |
SNMP用户名 |
|
Group name |
SNMP用户所属组的组名 |
|
Engine ID |
SNMP实体引擎ID |
|
Storage-type |
存储类型，有以下几种类型：volatile、nonVolatile、permanent、readOnly、other，请参见表1-1 |
|
UserStatus |
SNMP用户的状态 |
【命令】
enable snmp trap updown
undo enable snmp trap updown
【视图】
以太网接口视图/二层聚合接口视图/VLAN接口视图/OLT端口视图/ONU端口视图
【缺省级别】
2：系统级
【参数】
无
【描述】
enable snmp trap updown命令用来在端口下设置开启端口状态变化的Trap功能。undo enable snmp trap updown命令用来在端口下关闭端口状态变化的Trap功能。
缺省情况下，端口状态变化的Trap功能处于开启状态。
需要注意的是，如果要求端口在状态发生改变时生成端口linkUp/linkDown的Trap报文，需要在端口下和全局都开启端口状态变化的Trap功能。端口下开启请使用命令enable snmp trap updown，全局下开启请使用命令snmp-agent trap enable [ standard [ linkdown | linkup ] * ]。
相关配置可参考snmp-agent target-host和snmp-agent trap enable。
【举例】
# 允许发送端口GigabitEthernet1/1/1的linkUp/linkDown的SNMP Trap报文，使用团体名为public。
<Sysname> system-view
[Sysname] snmp-agent trap enable
[Sysname] snmp-agent target-host trap address udp-domain 10.1.1.1 params securityname public
[Sysname] interface GigabitEthernet1/1/1
[Sysname-GigabitEthernet1/1/1] enable snmp trap updown
【命令】
snmp-agent
undo snmp-agent
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
无
【描述】
snmp-agent命令用来启动SNMP Agent。undo snmp-agent命令用来关闭SNMP Agent。
缺省情况下，SNMP Agent功能关闭。
执行任何带snmp-agent关键字的配置命令都可以启动SNMP Agent。
【举例】
# 开启设备的SNMP Agent功能。
<Sysname> system-view
[Sysname] snmp-agent
【命令】
snmp-agent calculate-password plain-password mode { 3desmd5 | 3dessha | md5 | sha } { local-engineid | specified-engineid engineid }
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
plain-password：需要被加密的明文密码。
mode：指明使用的加密算法和认证算法。AES、3DES和DES都是加密算法，这三个加密算法的安全性由高到低依次是：AES、3DES、DES，安全性高的加密算法实现机制复杂，运算速度慢。对于普通的安全要求，DES算法就可以满足需要；MD5和SHA-1是认证算法，MD5算法的计算速度比SHA-1算法快，而SHA-1算法的安全强度比MD5算法高。
l 3desmd5：用于将明文加密密码转换为密文加密密码，此时对应的认证协议必须为MD5，加密协议必须为3DES。
l 3dessha：用于将明文加密密码转换为密文加密密码，此时对应的认证协议必须为SHA-1，加密协议必须为3DES。
l md5：用于将明文认证密码转换为密文认证密码，此时对应的认证协议必须为MD5；或者用于将明文加密密码转换为密文加密密码，此时对应的认证协议必须为MD5，加密协议可以为AES也可以是DES（当认证协议为MD5时，加密协议不管是AES还是DES，转换后的结果是一样的）。
l sha：用于将明文认证密码转换为密文认证密码，此时对应的认证协议必须为SHA-1；或者用于将明文加密密码转换为密文加密密码，此时对应的认证协议必须为SHA-1，加密协议可以为AES也可以是DES（当认证协议为SHA-1时，加密协议不管是AES还是DES，转换后的结果是一样的）。
local-engineid：使用本地引擎ID计算密文密码，引擎ID的相关描述与配置可参考命令snmp-agent local-engineid。
specified-engineid：使用用户指定的引擎ID计算密文密码。
engineid：引擎ID字符串，必须为偶数个十六进制数，偶数的取值范围为10～64。奇数个十六进制数、全0和全F均被认为是无效参数。
【描述】
snmp-agent calculate-password命令用来计算用户给定明文密码通过加密算法处理后的密文密码。
需要注意的是，用本命令根据SHA算法计算出的密文密码是由40个16进制字符构成的字符串，对认证密文密码，其40位字符均有效，但对加密密文密码，实际只有前32个字符有效。
需要注意的是，执行本命令前，必须先使能设备的SNMP功能。
在创建SNMP v3用户时，如果指明认证或者加密密码采用密文形式，则可以借助此命令生成相应的密文密码。
生成的密码是和引擎ID相关联的，在某一引擎ID下生成的密码，也只在此引擎ID下生效。
相关命令，请参考snmp-agent usm-user v3。
【举例】
# 使用本地engine ID和MD5认证协议计算明文为authkey的加密密码。
<Sysname> system-view
[Sysname] snmp-agent calculate-password authkey mode md5 local-engineid
The secret key is: 09659EC5A9AE91BA189E5845E1DDE0CC
【命令】
snmp-agent community { read | write } community-name [ acl acl-number | mib-view view-name ] *
undo snmp-agent community { read | write } community-name
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
read：表明对MIB对象进行只读的访问。NMS使用该团体名访问Agent时只能执行读操作。
write：表明对MIB对象进行读写的访问。NMS使用该团体名访问Agent时可以执行读、写操作。
community-name：团体名，为1～32个字符的字符串。
acl acl-number：将团体名与基本访问控制列表绑定，acl-number表示访问列表号，取值范围为2000～2999。使用ACL，可以允许或禁止具有特定源IP地址的NMS对Agent的访问。
mib-view view-name：指定与community-name关联的视图，view-name表示MIB视图名，为1～32个字符的字符串。不指定参数时，默认的视图为ViewDefault（启动SNMP Agent服务后系统创建的视图）。
【描述】
snmp-agent community命令用来创建一个新的SNMP团体，可设置的参数有访问权限、团体名、访问控制列表和可访问的MIB视图。undo snmp-agent community命令用来删除指定的团体。
该命令设置的团体名只对v1和v2c版本的SNMP实体有效。
团体是NMS和SNMP Agent的集合，用团体名来标志。团体名相当于密码，团体内的设备通信时需要使用团体名来进行认证。只有NMS和SNMP Agent上配置的团体名相同时，才能互相访问。通常情况下，“public”经常被用来作为读权限团体名、“private”经常被用来作为写权限团体名。为了安全起见，建议网络管理员配置其他团体名。
l acl参数，限制了只有IP地址符合条件的NMS可以访问Agent。
l community-name参数限制了NMS访问Agent时使用的团体名。
l mib-view参数限制了NMS可以对Agent进行操作的MIB对象。
l read、write参数限制了NMS可以对Agent执行的操作类型。
相关配置可参见snmp-agent mib-view。
【举例】
# 创建团体readaccess，并且允许使用该团体名进行只读访问。
<Sysname> system-view
[Sysname] snmp-agent sys-info version v1 v2c
[Sysname] snmp-agent community read readaccess
在NMS上将版本号设置为SNMP v1或者SNMP v2c，并将只读团体名填写为readaccess，建立连接，就可以对设备上ViewDefault视图内的MIB对象进行只读操作。
# 设置团体名writeaccess，并且只允许IP地址为1.1.1.1的NMS使用该用户名设置Agent MIB对象的值，禁止其它NMS使用该团体名执行写操作。
<Sysname> system-view
[Sysname] acl number 2001
[Sysname-acl-basic-2001] rule permit source 1.1.1.1 0.0.0.0
[Sysname-acl-basic-2001] rule deny source any
[Sysname-acl-basic-2001] quit
[Sysname] snmp-agent sys-info version v2c
[Sysname] snmp-agent community write writeaccess acl 2001
将NMS的IP地址配置为1.1.1.1，版本号指定为SNMP v2c，Write community选项填写为writeaccess，即可以对设备上ViewDefault视图内的MIB对象进行读写操作。
# 设置团体名wr-sys-acc，使用该团体名访问设备时只能对system（OID为1.3.6.1.2.1.1）子树下的MIB对象执行写操作。
<Sysname> system-view
[Sysname] snmp-agent sys-info version v1 v2c
[Sysname] snmp-agent mib-view included test system
[Sysname] snmp-agent community write wr-sys-acc mib-view system
在NMS上将版本号设置为SNMP v1或者SNMP v2c，并将Write community填写为wr-sys-acc，建立连接，就可以对设备上system视图内的MIB对象进行读写操作。
【命令】
SNMP v1和v2c版本下的命令格式是：
snmp-agent group { v1 | v2c } group-name [ read-view read-view ] [ write-view write-view ] [ notify-view notify-view ] [ acl acl-number ]
undo snmp-agent group { v1 | v2c } group-name
SNMP v3版本下的命令格式是：
snmp-agent group v3 group-name [ authentication | privacy ] [ read-view read-view ] [ write-view write-view ] [ notify-view notify-view ] [ acl acl-number ]
undo snmp-agent group v3 group-name [ authentication | privacy ]
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
v1：用户使用SNMP v1版本。
v2c：用户使用SNMP v2c版本。
v3：用户使用SNMP v3版本。
group-name：组名，为1～32个字符的字符串。
authentication：指明对报文进行认证但不加密。
privacy：指明对报文进行认证和加密。
read-view read-view：只读视图名，为1～32个字符的字符串。缺省值为ViewDefault。
write-view write-view：读写视图名，为1～32个字符的字符串。缺省情况下，未配置读写视图，即NMS不能对设备的所有MIB对象进行写操作。
notify-view notify-view：可以发Trap消息的视图名，为1～32个字符的字符串。缺省情况下，未配置Trap消息视图，即Agent不会向NMS发送Trap信息。
acl acl-number：将组与基本访问控制列表绑定，acl-number表示访问列表号，取值范围为2000～2999。使用基本ACL，可以对SNMP报文的源IP地址进行限制，即允许或禁止具有特定源IP地址的SNMP报文通过，从而进一步限制NMS和Agent的互访。
【描述】
snmp-agent group命令用来配置一个新的SNMP组，并设置其访问权限。undo snmp-agent group命令用来删除一个指定的SNMP组。
缺省情况下，snmp-agent group v3命令配置的SNMP组采用不认证、不加密方式。
SNMP组用来定义安全模式、视图权限等信息，配置在此组内的用户，具有这些公共属性。
相关配置可参考命令snmp-agent mib-view和snmp-agent usm-user。
【举例】
# 在运行SNMP v3版本的设备上创建一个SNMP组group1，采用不认证、不加密方式。
<Sysname> system-view
[Sysname] snmp-agent group v3 group1
【命令】
snmp-agent local-engineid engineid
undo snmp-agent local-engineid
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
engineid：引擎ID字符串，必须为偶数个十六进制数，偶数的取值范围为10～64。奇数个十六进制数、全0和全F均被认为是无效参数。
【描述】
snmp-agent local-engineid命令用来设置本地SNMP实体的引擎ID。undo snmp-agent local-engineid命令用来恢复缺省情况。
缺省情况下，设备引擎ID为公司的“企业号＋设备信息”。设备信息由各个产品决定，可以是IP地址、MAC地址或者自定义的十六进制数字串。
引擎ID有两个作用：
l 在一个NMS管理的所有设备中，每一个设备都需要有一个唯一的引擎ID来标识SNMP agent，缺省情况下每个设备有一个缺省的引擎ID，网络管理员需要确保一个管理域内不能有重复的引擎ID。
l SNMP v3版本的用户名、密文密码等的生成都和引擎ID相关联，如果更改了引擎ID，则原引擎ID下配置的用户名、密码失效。
通常情况下，使用设备的缺省引擎ID即可，用户也可以根据网络整体规划给设备配置方便记忆的引擎ID，比如A栋一楼的一号设备可以将它的引擎ID设置为000Af0010001，二号设备可以配置为000Af0010002。
相关配置可参考命令snmp-agent usm-user。
【举例】
# 配置本地设备的引擎ID为123456789A。
<Sysname> system-view
[Sysname] snmp-agent local-engineid 123456789A
【命令】
snmp-agent log { all | get-operation | set-operation }
undo snmp-agent log { all | get-operation | set-operation }
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
all：表示SNMP GET和SET操作的日志开关。
get-operation：表示SNMP GET操作的日志开关。
set-operation：表示SNMP SET操作的日志开关。
【描述】
snmp-agent log命令用来打开SNMP日志开关。undo snmp-agent log命令用来恢复缺省情况。
缺省情况下，SNMP日志开关处于关闭状态。
当打开SNMP指定的日志开关后，NMS对SNMP Agent执行指定的操作时，SNMP Agent会记录与该操作相关的信息并保存到设备的信息中心。通过设置信息中心的参数，最终决定SNMP日志的输出规则（即是否允许输出以及输出方向）。
【举例】
# 打开SNMP GET操作的日志开关。
<Sysname> system-view
[Sysname] snmp-agent log get-operation
# 打开SNMP SET操作的日志开关。
<Sysname> system-view
[Sysname] snmp-agent log set-operation
【命令】
snmp-agent mib-view { excluded | included } view-name oid-tree [ mask mask-value ]
undo snmp-agent mib-view view-name
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
excluded：表示当前视图不包括该MIB子树的任何节点。
included：表示当前视图包括该MIB子树的所有节点。
view-name：视图名，为1～32个字符的字符串。
oid-tree：MIB子树，用子树根节点的OID（如1.4.5.3.1）或名称（如“system”）表示。OID是由一系列的整数组成，标明节点在MIB树中的位置，它能唯一的标识一个MIB库中的对象。
mask mask-value：对象子树的掩码，十六进制数，长度为1～32中的偶数。
【描述】
snmp-agent mib-view命令用来创建或者更新MIB视图的信息，以指定NMS可以访问的MIB对象。undo snmp-agent mib-view命令用来取消当前设置。
缺省情况下，视图名为ViewDefault。
MIB视图是MIB的子集，MIB视图可以包含某个MIB子树的所有节点（即允许访问MIB子树的所有节点），也可以不包含某个MIB子树的所有节点（即禁止访问MIB子树的所有节点）。
缺省视图的访问限制可以通过display snmp-agent mib-view命令来查看。缺省视图可以通过undo snmp-agent mib-view命令删除，但是删除以后，可能导致不能对Agent的所有MIB节点执行读写操作。
相关配置可参考命令snmp-agent group。
【举例】
# 创建一个视图mibtest包含mib-2子树的所有对象，不包含ip子树的所有对象。
<Sysname> system-view
[Sysname] snmp-agent mib-view included mibtest 1.3.6.1
[Sysname] snmp-agent mib-view excluded mibtest ip
[Sysname] snmp-agent community read public mib-view mibtest
当NMS使用SNMP v1版本，public团体名访问设备时，不能访问ip子树的所有对象（比如ipForwarding和ipDefaultTTL等节点），可以查询mib-2子树下的其它所有对象。
【命令】
snmp-agent packet max-size byte-count
undo snmp-agent packet max-size
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
byte-count：Agent能接收/发送的SNMP消息包长度的最大值，取值范围为484～17940，单位为字节。
【描述】
snmp-agent packet max-size命令用来设置Agent能接收/发送的SNMP消息包长度的最大值。undo snmp-agent packet max-size命令用来恢复缺省情况。
缺省情况下，Agent能接收/发送的SNMP消息包长度的最大值为1500字节。
设置消息包的最大长度，是为了防止路由通路中存在不支持分片的主机，而导致超长数据被丢弃。通常情况下，请使用缺省值。
【举例】
# 设置Agent能接收/发送的SNMP消息包最长为1042字节。
<Sysname> system-view
[Sysname] snmp-agent packet max-size 1042
【命令】
snmp-agent sys-info { contact sys-contact | location sys-location | version { all | { v1 | v2c | v3 }* } }
undo snmp-agent sys-info { contact | location | version { all | { v1 | v2c | v3 }* } }
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
contact sys-contact：描述系统维护联系信息，为1～200个字符的字符串。
location sys-location：设备节点的物理位置信息，为1～200个字符的字符串。
version：设置系统启用的SNMP版本号。
l all：SNMP v1、SNMP v2c、SNMP v3版本。
l v1：SNMP v1版本。
l v2c：SNMP v2c版本。
l v3：SNMP v3版本。
【描述】
snmp-agent sys-info命令用来设置系统信息，包括系统维护联系信息、设备节点的物理位置信息、启用的SNMP版本号等。undo snmp-agent sys-info contact和undo snmp-agent sys-info location命令用来恢复缺省情况，undo snmp-agent sys-info version命令用来禁止使用指定版本的SNMP功能。
缺省情况下，系统维护联系信息为“Hangzhou H3C Tech. Co.,Ltd.”。物理位置信息为“Hangzhou, China”。版本为SNMP v3。
只有启用了SNMP版本，设备才会处理相应版本的SNMP数据报文，如果只启用了SNMP v1版本，则收到的SNMP v2c数据报文会被丢弃；如果只启用了SNMPv2c版本，则收到的SNMP v1数据报文会被丢弃。为了配合不同NMS，设备上可以同时启用多个SNMP版本运行。
相关配置可参考命令display snmp-agent sys-info。
如果设备发生故障，设备维护人员可以利用系统维护联系信息，及时与设备生产厂商取得联系。设备的位置信息是RFC1213-MIB中system组的一个管理变量，用于表示被管理设备的位置。
【举例】
# 设置系统维护联系信息为Dial System Operator at beeper # 27345。
<Sysname> system-view
[Sysname] snmp-agent sys-info contact Dial System Operator at beeper # 27345
【命令】
snmp-agent target-host trap address udp-domain ip-address [ udp-port port-number ] params securityname security-string [ v1 | v2c | v3 [ authentication | privacy ] ]
undo snmp-agent target-host trap address udp-domain ip-address params securityname security-string
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
trap：配置用来接收Trap和Notify信息的目的主机的参数。
address：指定设备发出的SNMP消息中的目的地址。
udp-domain：指定使用UDP协议来传输SNMP Trap信息。
ip-address：接收Trap的目的主机的IPv4地址。
udp-port port-number：指定目的主机上用来接收Trap信息的端口号。
params securityname security-string：指定认证的参数，为SNMP v1、SNMP v2c的团体名或SNMP v3的用户名，为1～32个字符的字符串。
v1：SNMP v1版本。
v2c：SNMP v2c版本。
v3：SNMP v3版本。
l authentication：指明对报文进行认证但不加密。认证是对报文是否完整以及是否被篡改等进行检验，认证密码在创建SNMP v3用户时配置。
l privacy：指明对报文进行认证和加密。加密是对报文的数据部分进行加密处理以防重要信息被窃取，认证密码和加密在创建SNMP v3用户时配置。
【描述】
snmp-agent target-host命令用来设置接收SNMP Trap报文的目的主机的属性。undo snmp-agent target-host命令用来取消当前设置。根据实际组网需要，用户可以多次使用该命令配置不同的目的主机的属性，使得设备可以向多个NMS发送Trap信息。可以配置的目的主机的个数为20个。
l 不指定udp-port port-number参数时，使用的端口号为162。
l 不指定v1、v2c、v3版本参数时，使用的版本是v1。
l 不指定authentication和privacy参数时，使用的是不认证不加密。
相关配置可参考命令enable snmp trap updown、snmp-agent trap enable、snmp-agent trap source和snmp-agent trap life。
【举例】
# 允许向10.1.1.1发送SNMP Trap报文，使用团体名public。
<Sysname> system-view
[Sysname] snmp-agent trap enable standard
[Sysname] snmp-agent target-host trap address udp-domain 10.1.1.1 params securityname public
【命令】
snmp-agent trap enable [ configuration | flash | standard [ authentication | coldstart | linkdown | linkup | warmstart ]* | system ]
undo snmp-agent trap enable [ configuration | flash | standard [ authentication | coldstart | linkdown | linkup | warmstart ]* | system ]
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
configuration：配置操作的Trap报文。
flash：FLASH相关的Trap报文。
standard：SNMP标准Trap报文。
l authentication：认证失败时，SNMP模块的认证失败的Trap报文。
l coldstart：当设备重新启动时，冷启动Trap报文。
l linkdown：在全局下设置，当端口的链路down时，链路down的Trap报文。
l linkup：在全局下设置，当端口的链路up时，链路up的Trap报文。
l warmstart：当SNMP模块重新启动时，热启动Trap报文。
system：H3C-SYS-MAN-MIB（私有MIB）的Trap报文。
【描述】
snmp-agent trap enable命令用来在全局下开启Trap功能。undo snmp-agent trap enable命令用来在全局下关闭Trap功能。
缺省情况下，在全局下的Trap功能处于开启状态。
开启Trap功能后，各个模块才会生成相应的Trap报文。
需要注意的是，如果要求端口在状态发生改变时生成端口linkUp/linkDown的Trap报文，需要在端口下和全局都开启端口状态变化的Trap功能。端口下开启请使用命令enable snmp trap updown，全局下开启请使用命令snmp-agent trap enable [ standard [ linkdown | linkup ] * ]。
相关配置可参考命令snmp-agent target-host和enable snmp trap updown。
【举例】
# 允许向10.1.1.1发送SNMP认证失败Trap报文，使用团体名为public。
<Sysname> system-view
[Sysname] snmp-agent target-host trap address udp-domain 10.1.1.1 params securityname public
[Sysname] snmp-agent trap enable standard authentication
【命令】
snmp-agent trap if-mib link extended
undo snmp-agent trap if-mib link extended
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
无
【描述】
snmp-agent trap if-mib link extended命令用来对RFC定义的标准linkUp/linkDown Trap报文进行私有扩展，扩展后的Trap报文由标准报文后追加接口描述和接口类型信息构成。undo snmp-agent trap if-mib link extended命令用来恢复缺省情况。
缺省情况下，使用的是RFC定义的标准linkUp/linkDown Trap报文。
l 标准格式的linkUp Trap报文形如：
#Apr 24 11:48:04:896 2008 Sysname IFNET/4/INTERFACE UPDOWN:
Trap 1.3.6.1.6.3.1.1.5.4<linkUp>: Interface 983555 is Up, ifAdminStatus is 1, ifOperStatus is 1
l 扩展格式的linkUp Trap报文形如：
#Apr 24 11:43:09:896 2008 Sysname IFNET/4/INTERFACE UPDOWN:
Trap 1.3.6.1.6.3.1.1.5.4<linkUp>: Interface 983555 is Up, ifAdminStatus is 1, ifOperStatus is 1, ifDescr is GigabitEthernet1/1/1, ifType is 6
l 标准格式的linkDown Trap报文形如：
#Apr 24 11:47:35:224 2008 Sysname IFNET/4/INTERFACE UPDOWN:
Trap 1.3.6.1.6.3.1.1.5.3<linkDown>: Interface 983555 is Down, ifAdminStatus is 2, ifOperStatus is 2
l 扩展格式的linkDown Trap报文形如：
#Apr 24 11:42:54:314 2008 Sysname IFNET/4/INTERFACE UPDOWN:
Trap 1.3.6.1.6.3.1.1.5.3<linkDown>: Interface 983555 is Down, ifAdminStatus is 2, ifOperStatus is 2, ifDescr is GigabitEthernet1/1/1, ifType is 6
扩展格式的linkUp/linkDown Trap报文在标准格式的linkUp/linkDown Trap报文后面增加了了ifDescr和ifType信息，更便于定位问题。
需要注意的是，配置该命令后，设备发送的linkUp/linkDown Trap报文为扩展格式的报文。如果NMS不支持扩展格式，可能会无法解析报文的内容。
【举例】
# 对RFC定义的标准linkUp/linkDown Trap报文进行私有扩展。
[Sysname] snmp-agent trap if-mib link extended
【命令】
snmp-agent trap life seconds
undo snmp-agent trap life
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
seconds：超时时间，取值范围为1～2592000，单位为秒。
【描述】
snmp-agent trap life命令用来设置Trap报文的保存时间，超过该时间的Trap报文都将被丢弃。undo snmp-agent trap life命令用来恢复缺省情况。
缺省情况下，SNMP Trap报文的保存时间为120秒。
SNMP模块使用队列来发送Trap报文，Trap报文进入消息发送队列时会启动一个存活定时器。如果直到定时器超时（即达到snmp-agent trap life命令设置的时间），Trap报文还没有被发送出去，系统就会将该Trap报文从发送队列中删除。
相关配置可参考命令snmp-agent trap enable和snmp-agent target-host。
【举例】
# 设置Trap报文的保存时间为60秒。
<Sysname> system-view
[Sysname] snmp-agent trap life 60
【命令】
snmp-agent trap queue-size size
undo snmp-agent trap queue-size
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
size：消息队列中可以存储的Trap报文的数目，取值范围1～1000。
【描述】
snmp-agent trap queue-size命令用来设置Trap报文发送队列的长度。undo snmp-agent trap queue-size命令用来恢复缺省情况。
缺省情况下，Trap报文的发送队列最多可以存储100条Trap消息。
Trap报文产生后，会进入Trap报文消息队列进行发送，Trap报文消息队列的长度决定了队列最多可以存储的Trap报文的数目。当Trap消息队列达到设定长度后，最新生成的Trap报文会进入消息队列，最早产生的Trap报文被丢弃。
相关配置可参考命令snmp-agent trap enable、snmp-agent target-host和snmp-agent trap life。
【举例】
# 设置发送Trap报文的消息队列最多可以存储200条Trap报文。
<Sysname> system-view
[Sysname] snmp-agent trap queue-size 200
【命令】
snmp-agent trap source interface-type interface-number
undo snmp-agent trap source
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
interface-type interface-number：指定接口类型与接口编号。
【描述】
snmp-agent trap source命令用来指定所发送Trap报文中的源IP地址。undo snmp-agent trap source命令用来恢复缺省情况。
缺省情况下，由SNMP选择一个接口的IP地址作为Trap报文源IP地址。
执行该命令后，系统会使用指定接口的主IP地址作为发送出去的Trap报文的源IP地址。这样，在NMS上就可以使用该IP地址唯一标志Agent。即便Agent使用不同的出端口发送Trap报文，NMS都可以使用该IP地址来过滤Agent发送的所有Trap报文。
如果用户想使用Trap的源IP地址来跟踪特定事件时，可以使用这条配置命令。
需要注意的是：在将某个接口设置为获取Trap的源地址接口之前，必须保证该接口在设备上已经存在，并且配置了合法的IP地址，该IP地址将作为Trap报文的源地址。如果配置的接口不存在，则该命令会配置失败；如果接口没有指定合法的IP地址，则该命令不生效，接口配置了合法IP地址后，该命令会自动生效。
相关配置可参考命令snmp-agent trap enable和snmp-agent target-host。
【举例】
# 将以太网端口Vlan-interface1上的接口IP地址作为Trap报文的源地址。
<Sysname> system-view
[Sysname] snmp-agent trap source Vlan-interface 1
【命令】
snmp-agent usm-user { v1 | v2c } user-name group-name [ acl acl-number ]
undo snmp-agent usm-user { v1 | v2c } user-name group-name
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
v1：表示配置的用户名适用于SNMP v1组网环境。如果Agent和NMS使用SNMP v1版本的报文交互，则需要该参数。
v2c：表示配置的用户名适用于SNMP v2c组网环境。如果Agent和NMS使用SNMP v2c版本的报文交互，则需要该参数。
user-name：用户名，为1～32个字符的字符串，区分大小写。
group-name：该用户对应的组名，为1～32个字符的字符串，区分大小写。
acl acl-number：将用户与基本访问控制列表绑定，acl-number表示访问列表号，取值范围为2000～2999。使用基本ACL，可以对SNMP报文的源IP地址进行限制，即允许或禁止具有特定源IP地址的SNMP报文通过，从而可以允许/禁止指定的NMS使用该用户名访问Agent。
【描述】
snmp-agent usm-user { v1 | v2c }命令用来为一个SNMP组添加一个新用户。undo snmp-agent usm-user { v1 | v2c }命令用来删除SNMP组的一个用户。
根据协议规定，SNMP v1和SNMP v2c组网应用中NMS和Agnet之间使用团体名来认证，SNMP v3组网应用中使用用户名来认证。如果用户习惯配置用户名并使用用户名来认证，设备支持配置SNMP v1和SNMP v2c用户。创建一个SNMP v1或SNMP v2c用户相当于添加一个新的只读团体名。将新创建的用户名填写到NMS的只读团体名参数字段，NMS就可以和设备建立SNMP连接。
要使配置的用户生效，必须先创建组。
相关配置可参考命令snmp-agent group、snmp-agent community和snmp-agent usm-user v3。
【举例】
# 在组readCom里创建一个v2c的用户userv2c。
<Sysname> system-view
[Sysname] snmp-agent sys-info version v2c
[Sysname] snmp-agent group v2c readCom
[Sysname] snmp-agent usm-user v2c userv2c readCom
将NMS的版本号指定为SNMP v2c，Read community选项填写为userv2c，就可以访问Agent了。
# 在组readCom里创建一个v2c的用户userv2c，并且只允许IP地址为1.1.1.1的NMS使用该用户名访问Agent，禁止其它NMS使用该用户名访问。
<Sysname> system-view
[Sysname] acl number 2001
[Sysname-acl-basic-2001] rule permit source 1.1.1.1 0.0.0.0
[Sysname-acl-basic-2001] rule deny source any
[Sysname-acl-basic-2001] quit
[Sysname] snmp-agent sys-info version v2c
[Sysname] snmp-agent group v2c readCom
[Sysname] snmp-agent usm-user v2c userv2c readCom acl 2001
此时在IP地址为1.1.1.1，版本号指定为SNMP v2c，Read community的NMS上，将SNMP协议版本号指定为SNMP v2c，Read community和Write community选项均填写为userv2c，就可以访问Agent了。
【命令】
snmp-agent usm-user v3 user-name group-name [ cipher ] [ authentication-mode { md5 | sha } auth-password [ privacy-mode { 3des | aes128 | des56 } priv-password ] ] [ acl acl-number ]
undo snmp-agent usm-user v3 user-name group-name { local | engineid engineid-string }
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
user-name：用户名，为1～32个字符的字符串，区分大小写。
group-name：该用户对应的组名，为1～32个字符的字符串，区分大小写。
cipher：指明auth-password和priv-password需要输入密文密码，密文密码可以使用snmp-agent calculate-password命令来计算获得。
authentication-mode：指明安全模式为需要认证。MD5算法的计算速度比SHA算法快，而SHA算法的安全强度比MD5算法高。
l md5：指定认证协议为MD5。
l sha：指定认证协议为SHA-1。
auth-password：认证密码。若不配置cipher命令关键字，auth-password表示明文密码，为1～64个可见字符的字符串。若配置cipher命令关键字，auth-password表示密文密码。如果选择md5参数，则auth-password为32个16进制字符构成的字符串；如果选择sha参数，则auth-password为40个16进制字符构成的字符串。
privacy-mode：指明安全模式为需要加密。加密算法的安全性由高到低依次是：AES、3DES、DES，安全性高的加密算法实现机制复杂，运算速度慢。对于普通的安全要求，DES算法就可以满足需要。
l 3des：指定加密协议为3DES（Triple Data Encryption Standard，三重数据加密标准）。
l aes128：指定加密协议为AES（Advanced Encryption Standard，高级加密标准）。
l des56：指定加密协议为DES（Data Encryption Standard，数据加密标准）。
priv-password：加密密码。若不配置cipher命令关键字，priv-password表示明文密码，为1～64个字符的字符串。若配置cipher命令关键字，priv-password表示密文密码。如果选择3des参数，则priv-password为80个16进制字符构成的字符串；如果选择aes128参数，则priv-password为40个16进制字符构成的字符串；如果选择des56参数，则priv-password为40个16进制字符构成的字符串。
acl acl-number：将用户与基本访问控制列表绑定，acl-number表示访问列表号，取值范围为2000～2999。使用基本ACL，可以对SNMP报文的源IP地址进行限制，即允许或禁止具有特定源IP地址的SNMP报文通过，从而可以允许/禁止指定的NMS使用该用户名访问Agent。
local：表示本地实体引擎。
engineid engineid-string：指定与该用户相关联的引擎ID字符串，必须为偶数个十六进制数，十六进制数的个数为10～64。奇数个十六进制数、全0和全F均被认为是无效参数。
【描述】
snmp-agent usm-user v3命令用来为一个SNMP组添加一个新用户。undo snmp-agent usm-user v3命令用来删除SNMP组的一个用户。
该命令配置的用户名适用于SNMP v3组网环境。如果Agent和NMS使用SNMP v3版本的报文交互，则需要创建SNMP v3用户。
要使配置的用户生效，必须先创建组。创建组时配置是否进行认证和加密，认证和加密的具体算法和密码则是在创建用户时配置。
l 指定cipher参数时，系统会把auth-password和priv-password这两个参数当成是密文密码。此时的配置命令支持拷贝、粘贴操作，即当两台设备的引擎ID相同时，可以将A设备配置文件中的SNMPv3用户配置命令拷贝、粘贴到B设备上执行，两设备的密文密码以及明文密码一致。
l 不指定cipher参数时，系统会把这两个参数当成是明文密码。此时，拷贝、粘贴再执行时，系统会对这两个密码再进行加密，导致两设备的密文密码以及明文密码不一致。
需要注意的是：
l 如果使用snmp-agent usm-user v3 cipher命令，其密文密码参数可以用命令snmp-agent calculate-password获得。要使计算所得的密文密码能够用于snmp-agent usm-user v3 cipher命令且等效，必须保证两命令使用的加密算法相同，而且执行snmp-agent usm-user v3 cipher命令时设备的本地引擎ID与snmp-agent calculate-password命令中指定的SNMP实体引擎ID一致。
l 多次使用本命令配置同一用户（即用户名相同，其它参数没有要求），配置结果以最后一次的配置为准。
l NMS在访问设备时，必须输入明文密码，因此在创建用户时请牢记用户名以及对应的明文密码。
相关配置可参考命令snmp-agent calculate-password、snmp-agent group、snmp-agent usm-user { v1 | v2c }。
【举例】
# 为v3组testGroup加入一个用户testUser，安全级别为只认证不加密，认证协议为md5，认证密码明文为authkey。
<Sysname> system-view
[Sysname] snmp-agent group v3 testGroup authentication
[Sysname] snmp-agent usm-user v3 testUser testGroup authentication-mode md5 authkey
在NMS上将版本号设置为SNMP v3，并将用户名填写为testUser，认证协议设置为MD5，认证密码填写为authkey，建立连接，就可以对设备上ViewDefault视图内的MIB对象进行访问了。
# 为v3组testGroup加入一个用户testUser，安全级别为认证和加密，认证协议为md5、加密协议为des56，认证密码明文为authkey，加密密码明文为prikey。
<Sysname> system-view
[Sysname] snmp-agent group v3 testGroup privacy
[Sysname] snmp-agent usm-user v3 testUser testGroup authentication-mode md5 authkey privacy-mode des56 prikey
在NMS上将版本号设置为SNMP v3，并将用户名填写为testUser，认证协议设置为MD5，认证密码填写为authkey，加密协议设置为DES，加密密码填写为prikey，建立连接，就可以对设备上ViewDefault视图内的MIB对象进行访问了。
# 以cihper方式为v3组testGroup加入一个用户testUser，安全级别为认证和加密，认证协议为md5、加密协议为des56，认证密码明文为authkey，加密密码明文为prikey。
<Sysname> system-view
[Sysname] snmp-agent group v3 testGroup privacy
[Sysname] snmp-agent calculate-password authkey mode md5 local-engineid
The secret key is: 09659EC5A9AE91BA189E5845E1DDE0CC
[Sysname] snmp-agent calculate-password prikey mode md5 local-engineid
The secret key is: 800D7F26E786C4BECE61BF01E0A22705
[Sysname] snmp-agent usm-user v3 testUser testGroup cipher authentication-mode md5 09659EC5A9AE91BA189E5845E1DDE0CC privacy-mode des56 800D7F26E786C4BECE61BF01E0A22705
在NMS上将版本号设置为SNMP v3，并将用户名填写为testUser，认证协议设置为MD5，认证密码填写为authkey，加密协议设置为DES，加密密码填写为prikey，建立连接，就可以对设备上ViewDefault视图内的MIB对象进行访问了。
【命令】
display mib-style
【视图】
任意视图
【缺省级别】
3：管理级
【参数】
无
【描述】
display mib-style命令用于查询设备的MIB风格。
设备的MIB风格有两种new和compatible，获得设备的MIB风格后，可根据MIB风格选择适配的H3C网管软件。
相关配置可参考命令mib-style。
【举例】
# 从sysObjectID节点获取设备ID，发现该设备为H3C设备，希望知道该设备上当前MIB风格或者下次启动后的MIB风格。
<Sysname> display mib-style
Current MIB style: new
Next reboot MIB style: new
以上显示信息表明设备当前MIB风格为new，下次启动后MIB风格仍为new。
【命令】
mib-style [ new | compatible ]
【视图】
系统视图
【缺省级别】
3：管理级
【参数】
new：指设定MIB为H3C品牌新风格，即设备sysOID与私有MIB均在H3C企业ID 25506下。
compatible：指设定MIB为H3C品牌兼容风格，即设备sysOID在H3C企业ID 25506下，私有MIB在企业ID 2011下。
【描述】
mib-style命令用来设置设备的MIB风格。
缺省情况下，设备的MIB风格为new。
需要注意的是，该设置需要重启设备才能生效。
【举例】
# 将设备的MIB风格修改为compatible。
<Sysname> system-view
[Sysname] mib-style compatible
[Sysname] quit
<Sysname> display mib-style
Current MIB style: new
Next reboot MIB style: compatible
<Sysname> reboot
【命令】
display rmon alarm [ entry-number ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
entry-number：告警表项的索引号，取值范围为1～65535。
【描述】
display rmon alarm命令用来显示所有或指定RMON告警的配置信息。
如果不指定索引号，则显示所有告警的配置信息。
相关配置可参考命令rmon alarm。
【举例】
# 显示RMON告警配置信息。
AlarmEntry 1 owned by user1 is VALID.
Samples type : absolute
Variable formula : 1.3.6.1.2.1.16.1.1.1.4.1<etherStatsOctets.1>
Sampling interval : 10(sec)
Rising threshold : 50(linked with event 1)
Falling threshold : 5(linked with event 2)
When startup enables : risingOrFallingAlarm
Latest value : 0
表3-1 display rmon alarm命令显示信息描述表
|
字段 |
描述 |
|
AlarmEntry |
告警表项，对应MIB节点alarmIndex |
|
owned by |
创建者，对应MIB节点alarmOwner |
|
VALID |
与该索引对应的告警表项的状态（VALID表示有效，UNDERCREATION表示无效。处于无效状态的表项使用相应的display rmon命令可以查看到，但是使用display current-configuration和display this看不到相应的rmon命令），对应MIB节点alarmStatus |
|
Samples type |
采样类型，取值为absolute（绝对值采样）或者delta（变化值采样），对应MIB节点alarmSampleType |
|
Variable formula |
告警变量，即被监控的MIB节点，对应MIB节点alarmVariable |
|
Sampling interval |
采样的时间间隔，单位为秒，对应MIB节点alarmInterval |
|
Rising threshold |
上限阈值（当采样值大于等于该值时引发上限告警），对应MIB节点alarmRisingThreshold |
|
Falling threshold |
下限阈值（当采样值小于等于该值时引发下限告警），对应MIB节点alarmFallingThreshold |
|
When startup enables |
触发告警的条件，对应MIB节点alarmStartupAlarm |
|
Latest value |
最近一次采样值，对应MIB节点alarmValue |
【命令】
display rmon event [ entry-number ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
entry-number：事件表项的索引号，取值范围为1～65535。此项如果为空，则显示所有事件的配置信息。
【描述】
display rmon event命令用来显示所有或指定RMON事件的配置信息。
显示信息包括：事件表中的事件索引、事件的所有者、对事件的描述、事件引发的动作（日志或告警消息）、最近一次事件发生的时刻（此时间是以系统初始化/启动以来的秒数计算的）等。
相关配置可参考命令rmon event。
【举例】
# 显示RMON事件信息。
<Sysname> display rmon event
EventEntry 1 owned by user1 is VALID.
Description: null.
Will cause log-trap when triggered, last triggered at 0days 00h:02m:27s.
表3-2 display rmon event命令显示信息描述表
|
字段 |
描述 |
|
EventEntry |
事件表项，对应MIB节点eventIndex |
|
owned by |
该事件表项的所有者，对应MIB节点eventOwner |
|
VALID |
与该索引对应的告警表项的状态（VALID表示有效，UNDERCREATION表示无效。处于无效状态的表项使用相应的display rmon命令可以查看到，但是使用display current-configuration和display this看不到相应的rmon命令），对应MIB节点eventStatus |
|
Description |
该事件表项的描述符，对应MIB节点eventDescription |
|
cause log-trap when triggered |
事件引发日志和Trap告警，对应MIB节点eventType 。事件关联的动作有四种： l none表示不采取任何措施 l log表示事件被触发时会记录日志 l snmp-trap表示事件被触发时会向NMS发送Trap信息 l log-and-trap表示事件被触发时既会记录日志又会发送Trap信息 |
|
last triggered at |
最近一次事件发生的时间，对应MIB节点eventLastTimeSent |
【命令】
display rmon eventlog [ entry-number ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
entry-number：事件表项的索引号，取值范围为1～65535。
【描述】
display rmon eventlog命令用来显示指定事件的记录。
如果不指定entry-number参数，则显示所有事件的记录。
如果使用rmon event命令指定某表项的动作包括记录日志，当该事件被触发时，就会在RMON日志表中保留该事件的记录。通过该命令可以显示日志表的具体内容：事件表中的事件索引及事件当前的状态、事件产生日志的时刻（此时间是以系统初始化/启动以来的秒数计算的）以及事件的描述等。
【举例】
# 查看RMON事件1的日志。
<Sysname> display rmon eventlog 1
LogEntry 1 owned by null is VALID.
Generates eventLog 1.1 at 0day(s) 00h:00m:33s.
Description: The alarm formula defined in prialarmEntry 1,
uprise 80 with alarm value 85. Alarm sample type is absolute.
Generates eventLog 1.2 at 0day(s) 00h:42m:03s.
Description: The alarm formula defined in prialarmEntry 2,
less than(or =) 5 with alarm value 0. Alarm sample type is delta.
表3-3 display rmon eventlog命令显示信息描述表
|
字段 |
描述 |
|
LogEntry |
事件日志表项，对应MIB节点logIndex |
|
owned by |
该事件表项的所有者，对应MIB节点eventOwner |
|
VALID |
与该索引对应的告警表项的状态（VALID表示有效，UNDERCREATION表示无效。处于无效状态的表项使用相应的display rmon命令可以查看到，但是使用display current-configuration和display this看不到相应的rmon命令），对应MIB节点eventStatus |
|
Generates eventLog at |
该条日志生成的时间（距离设备启动时的相对时间），对应MIB节点logTime |
|
Description |
该条日志的描述，对应MIB节点logDescription |
以上举例表明事件1产生了两条日志：
l 日志1.1由扩展告警表项1触发生成，原因是告警值（85）超过了上限阈值（80），采样类型为绝对值采样。
l 日志1.2由扩展告警表项2触发生成，原因是告警值（0）低于下限阈值（5），采样类型为变化值采样。
【命令】
display rmon history [ interface-type interface-number ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
interface-type interface-number：接口类型和接口编号。
【描述】
display rmon history命令用来显示RMON历史控制表及历史采样信息。
在端口创建历史表项之后，系统会按一定的时间周期统计端口的信息，并将这些信息保存到etherHistoryEntry表，使用本命令可以显示该表项存储的记录。
可显示的历史采样信息的数目以及历史采样的间隔可以通过rmon history命令来设置。相关配置可参考命令rmon history。
【举例】
# 显示端口GigabitEthernet1/1/1的RMON历史控制表及历史采样信息。
<Sysname> display rmon history GigabitEthernet 1/1/1
HistoryControlEntry 1 owned by null is VALID
Samples interface : GigabitEthernet1/1/1<ifIndex.1>
Sampling interval : 10(sec) with 5 buckets max
Sampled values of record 1 :
dropevents : 0 , octets : 0
packets : 0 , broadcast packets : 0
multicast packets : 0 , CRC alignment errors : 0
undersize packets : 0 , oversize packets : 0
fragments : 0 , jabbers : 0
collisions : 0 , utilization : 0
Sampled values of record 2 :
dropevents : 0 , octets : 0
packets : 0 , broadcast packets : 0
multicast packets : 0 , CRC alignment errors : 0
undersize packets : 0 , oversize packets : 0
fragments : 0 , jabbers : 0
collisions : 0 , utilization : 0
Sampled values of record 3 :
dropevents : 0 , octets : 0
packets : 0 , broadcast packets : 0
multicast packets : 0 , CRC alignment errors : 0
undersize packets : 0 , oversize packets : 0
fragments : 0 , jabbers : 0
collisions : 0 , utilization : 0
Sampled values of record 4 :
dropevents : 0 , octets : 0
packets : 0 , broadcast packets : 0
multicast packets : 0 , CRC alignment errors : 0
undersize packets : 0 , oversize packets : 0
fragments : 0 , jabbers : 0
collisions : 0 , utilization : 0
Sampled values of record 5 :
dropevents : 0 , octets : 0
packets : 0 , broadcast packets : 0
multicast packets : 0 , CRC alignment errors : 0
undersize packets : 0 , oversize packets : 0
fragments : 0 , jabbers : 0
collisions : 0 , utilization : 0
表3-4 display rmon history命令显示信息描述表
|
字段 |
描述 |
|
HistoryControlEntry |
历史控制表项，对应MIB节点etherHistoryIndex |
|
owned by |
该表项的所有者，对应MIB节点historyControlOwner |
|
VALID |
与该索引对应的告警表项的状态（VALID表示有效，UNDERCREATION表示无效。处于无效状态的表项使用相应的display rmon命令可以查看到，但是使用display current-configuration和display this看不到相应的rmon命令），对应MIB节点historyControlStatus |
|
Samples Interface |
被统计的接口 |
|
Sampling interval |
统计周期，单位为秒，对应MIB节点historyControlInterval。系统会按周期对端口的信息进行统计 |
|
buckets max |
系统最多可保存的统计值的条数，如果在rmon history命令中指定的buckets的值超出了设备实际支持的历史表容量，则此处显示的是设备实际支持的历史表容量 如果当前保存的统计值条数已经到达了系统支持的最大值，则系统会删除最早的记录来保存新的统计值，对应MIB节点historyControlBucketsGranted |
|
Sampled values of record number |
系统缓存区中的第number条统计信息，统计信息保存到缓存区时会按时间先后顺序进行编号 |
|
dropevents |
统计周期内检测到的丢包事件次数，对应MIB节点etherHistoryDropEvents |
|
octets |
统计周期内接收到的字节数，对应MIB节点etherHistoryOctets |
|
packets |
统计周期内接收到的包数，对应MIB节点etherHistoryPkts |
|
broadcast packets |
统计周期内接收到的广播包数，对应MIB节点etherHistoryBroadcastPkts |
|
multicast packets |
统计周期内接收到的组播包数，对应MIB节点etherHistoryMulticastPkts |
|
CRC alignment errors |
统计周期内接收到的校验错误的包数，对应MIB节点 etherHistoryCRCAlignErrors |
|
undersize packets |
统计周期内接收到的过小的包数，对应MIB节点etherHistoryUndersizePkts |
|
oversize packets |
统计周期内接收到的超大的包数，对应MIB节点etherHistoryOversizePkts |
|
fragments |
统计周期内接收到的过小且校验错误的包数，对应MIB节点etherHistoryFragments |
|
jabbers |
统计周期内接收到的超大且校验错误的包数，对应MIB节点etherHistoryJabbers |
|
collisions |
统计周期内接收到的冲突的包数，对应MIB节点etherHistoryCollisions |
|
utilization |
统计周期内的带宽利用率，对应MIB节点etherHistoryUtilization |
【命令】
display rmon prialarm [ entry-number ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
entry-number：扩展告警表项的索引，取值范围为1～65535。此项如果为空，则显示所有扩展告警的配置信息。
【描述】
display rmon prialarm命令用来显示扩展告警表项的配置信息。
相关配置可参考命令rmon prialarm。
【举例】
# 显示RMON所有的扩展告警信息。
<Sysname> display rmon prialarm
PrialarmEntry 1 owned by user1 is VALID.
Samples type : absolute
Variable formula : (.1.3.6.1.2.1.16.1.1.1.6.1*100/.1.3.6.1.2.1.16.1.1.1.5.1)
Description : ifUtilization. GigabitEthernet1/1/1
Sampling interval : 10(sec)
Rising threshold : 80(linked with event 1)
Falling threshold : 5(linked with event 2)
When startup enables : risingOrFallingAlarm
This entry will exist : forever
Latest value : 85
表3-5 display rmon prialarm命令显示信息描述表
|
字段 |
描述 |
|
PrialarmEntry |
扩展告警表项 |
|
owned by |
创建者为 |
|
VALID |
与该索引对应的告警表项的状态（VALID表示有效，UNDERCREATION表示无效。处于无效状态的表项使用相应的display rmon命令可以查看到，但是使用display current-configuration和display this看不到相应的rmon命令） |
|
Samples type |
采样类型，取值为absolute（绝对值采样）或者delta（变化值采样） |
|
Variable formula |
样本变量的计算公式 |
|
Sampling interval |
采样间隔，单位为秒，系统会按一定的时间间隔对采样变量进行绝对值采样或者变化值采样 |
|
Rising threshold |
告警上限，当采样值大于等于该值时引发上限告警 |
|
Falling threshold |
告警下限，当采样值小于等于该值时引发下限告警 |
|
linked with event |
告警对应的事件索引 |
|
When startup enables |
触发告警的条件 |
|
This entry will exist |
该扩展告警表项的存活时间，可以是永远存在，也可以是在规定的时间内存在 |
|
Latest value |
最近一次采样计算值 |
【命令】
display rmon statistics [ interface-type interface-number ]
【视图】
任意视图
【缺省级别】
1：监控级
【参数】
interface-type interface-number：接口类型和接口编号。
【描述】
display rmon statistics命令用来显示RMON统计消息。
本命令显示的是从端口创建统计表项到执行显示命令这段时间内端口的统计信息。设备重启时，会清除该统计信息。
相关配置可参考命令rmon statistics。
【举例】
# 显示以太网接口GigabitEthernet1/1/1的RMON统计信息。
<Sysname> display rmon statistics GigabitEthernet 1/1/1
EtherStatsEntry 1 owned by null is VALID.
Interface : GigabitEthernet1/1/1<ifIndex.3>
etherStatsOctets : 43393306 , etherStatsPkts : 619825
etherStatsBroadcastPkts : 503581 , etherStatsMulticastPkts : 44013
etherStatsUndersizePkts : 0 , etherStatsOversizePkts : 0
etherStatsFragments : 0 , etherStatsJabbers : 0
etherStatsCRCAlignErrors : 0 , etherStatsCollisions : 0
etherStatsDropEvents (insufficient resources): 0
Packets received according to length:
64 : 0 , 65-127 : 0 , 128-255 : 0
256-511: 0 , 512-1023: 0 , 1024-1518: 0
表3-6 display rmon statistics命令显示信息描述表
|
字段 |
描述 |
|
EtherStatsEntry |
统计信息表项，对应MIB节点etherStatsIndex |
|
VALID |
与该索引对应的告警表项的状态（VALID表示有效，UNDERCREATION表示无效。处于无效状态的表项使用相应的display rmon命令可以查看到，但是使用display current-configuration和display this看不到相应的rmon命令），对应MIB节点etherStatsStatus |
|
Interface |
被统计端口，对应MIB节点etherStatsDataSource |
|
etherStatsOctets |
统计时间内，端口收到和发送的所有报文的字节数，对应MIB节点etherStatsOctets |
|
etherStatsPkts |
统计时间内，端口收到和发送的所有报文的包数，对应MIB节点etherStatsPkts |
|
etherStatsBroadcastPkts |
统计时间内，端口收到和发送的所有广播包的数量，对应MIB节点etherStatsBroadcastPkts |
|
etherStatsMulticastPkts |
统计时间内，端口收到和发送的所有组播包的数量，对应MIB节点etherStatsMulticastPkts |
|
etherStatsUndersizePkts |
统计时间内，端口收到和发送的所有过小包的数量，对应MIB节点etherStatsUndersizePkts |
|
etherStatsOversizePkts |
统计时间内，端口收到和发送的所有超大包的数量，对应MIB节点etherStatsOversizePkts |
|
etherStatsFragments |
统计时间内，端口收到和发送的所有过小且校验错误包的数量，对应MIB节点etherStatsFragments |
|
etherStatsJabbers |
统计时间内，端口收到和发送的所有超大且校验错误包的数量，对应MIB节点etherStatsJabbers |
|
etherStatsCRCAlignErrors |
统计时间内，端口收到和发送的所有校验错误包的数量，对应MIB节点etherStatsCRCAlignErrors |
|
etherStatsCollisions |
统计时间内，端口收到和发送的所有冲突包的数量，对应MIB节点etherStatsCollisions |
|
etherStatsDropEvents |
统计时间内，端口收到和发送的所有丢包事件的数量，对应MIB节点etherStatsDropEvents |
|
Packets received according to length: 64 : 0 , 65-127 : 0 , 128-255 : 0 256-511: 0 , 512-1023: 0 , 1024-1518: 0 |
统计时间内，根据包的长度对接收到和发送的包分区间进行统计（该功能需要硬件支持，如果硬件不支持则所有统计值均显示为0），其中： l 64字段的信息对应MIB节点etherStatsPkts64Octets l 65-127字段的信息对应MIB节点etherStatsPkts65to127Octets l 128-255字段的信息对应MIB节点etherStatsPkts128to255Octets l 256-511字段的信息对应MIB节点etherStatsPkts256to511Octets l 512-1023字段的信息对应MIB节点etherStatsPkts512to1023Octets l 1024-1518字段的信息对应MIB节点etherStatsPkts1024to1518Octets |
【命令】
rmon alarm entry-number alarm-variable sampling-interval { absolute | delta } rising-threshold threshold-value1 event-entry1 falling-threshold threshold-value2 event-entry2 [ owner text ]
undo rmon alarm entry-number
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
entry-number：添加/删除表项的索引号，取值范围为1～65535。
alarm-variable：告警变量，为1～256个字符的字符串，可以是节点OID的点分格式（格式为entry.integer.instance或者叶子节点名.instance，如1.3.6.1.2.1.2.1.10.1），也可以是节点名（如ifInOctets.1）。只有可以解析为ASN.1中INTEGER（INTEGER, Counter, Gauge, or TimeTicks）的数据类型的变量能作为告警变量，比如etherStatsEntry表项的叶子节点（etherStatsOctets、etherStatsPkts和etherStatsBroadcastPkts等）的实例，ifEntry表项的叶子节点（ifInOctets、ifInUcastPkts和ifInNUcastPkts等）的实例。
sampling-interval：采样间隔时间，取值范围为5～65535，单位为秒。
absolute：采样类型为绝对值采样，即采样时间到达时直接提取变量的值。
delta：采样类型为变化值采样，即采样时间到达时提取的是变量在采样间隔内的变化值。
rising-threshold threshold-value1 event-entry1：设置超上限参数，threshold-value1表示上限阈值，取值范围为-2147483648～+2147483647；event-entry1表示上限阈值相应的事件号，取值范围为0～65535（0表示没有对应的事件，告警被触发后不会采取任何事件动作）。
falling-threshold threshold-value2 event-entry2：设置下限参数，threshold-value2表示下限阈值，取值范围为-2147483648～+2147483647；event-entry2表示下限阈值相应的事件号，取值范围为0～65535（0表示没有对应的事件，告警被触发后不会采取任何事件动作）。
owner text：该表项的创建者，为1～127个字符的字符串。区分大小写，支持空格。
【描述】
rmon alarm命令用来在告警表中添加一个表项。undo rmon alarm命令用来在告警表中删除一个指定表项。
本命令用来设置告警项，以便在出现异常时触发告警事件，再由告警事件来定义具体的处理方式。
用户定义了告警表项后，系统对告警表项的处理如下：
l 对所定义的告警变量alarm-variable按照定义的时间间隔进行采样；
l 将采样值和设定的阈值进行比较，按照下表执行相应的处理过程。
|
实际情况 |
处理过程 |
|
采样值大于等于设定的上限threshold-value1 |
触发事件表中定义的事件event-entry1 |
|
采样值小于等于设定的下限threshold-value2 |
触发事件表中定义的事件event-entry2 |
l 在添加告警表项之前，需要通过rmon event命令定义好告警表项中引用的事件。
l 如果在新建表项时，指定的告警变量（alarm-variable）、采样间隔（sampling-interval）、采样类型（absolute或delta）、上限阈值（threshold-value1）和下限阈值（threshold-value2）五项参数的值和已经存在的告警表项对应的五项参数值完全相同时，系统将认为这两个表项的配置相同，创建操作失败。
l 用户最多可以定义60个告警表项。
相关配置可参考display rmon alarm、rmon event、rmon history和rmon statistics。
【举例】
# 在告警表中添加第1表项，对节点1.3.6.1.2.1.16.1.1.1.4.1以10秒的采样间隔进行绝对值采样，当采样值大于等于5000的上限阈值触发事件1，小于等于下限阈值5时触发事件2，创建者为user1。
<Sysname> system-view
[Sysname] rmon event 1 log
[Sysname] rmon event 2 none
[Sysname] interface GigabitEthernet 1/1/1
[Sysname-GigabitEthernet1/1/1] rmon statistics 1
[Sysname-GigabitEthernet1/1/1] quit
[Sysname] rmon alarm 1 1.3.6.1.2.1.16.1.1.1.4.1 10 absolute rising-threshold 5000 1 falling-threshold 5 2 owner user1
1.3.6.1.2.1.16.1.1.1.4是叶子节点etherStatsOctets的OID，它表示接口收到报文的统计值（以字节为单位）。以上步骤中也可以使用etherStatsOctets.1来代替1.3.6.1.2.1.16.1.1.1.4.1参数，.1与接口统计表项的编号一致，如果创建的是“rmon statistics 5”，则对应需要使用etherStatsOctets.5。
以上配置步骤实现：对接口GigabitEthernet1/1/1的使用情况进行统计、监控，每10秒钟对接口收到报文的总字节数取绝对值，如果接口收到报文的总字节数达到5000字节时，就记录日志；当接口收到报文的总字节数小于或等于5字节时，不采取任何措施。
【命令】
rmon event entry-number [ description string ] { log | log-trap log-trapcommunity | none | trap trap-community } [ owner text ]
undo rmon event entry-number
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
entry-number：添加/删除事件的索引号，取值范围为1～65535。
description string：事件的描述信息，为1～127个字符的字符串。
log：日志事件。当该事件被触发时，系统会记录日志。
log-trap log-trapcommunity：日志和Trap事件。当该事件被触发时，系统会同时记录日志和发送Trap消息。log-trapcommunity表示接收Trap消息的网管站的团体名，为1～127个字符的字符串。
none：不产生动作的事件。当该事件被触发时，系统不做处理。
trap trap-community：Trap事件。当该事件被触发时，系统会以trap-community为团体名发送Trap消息。trap-community表示接收Trap消息的网管站的团体名，为1～127个字符的字符串。
owner text：该表项的创建者，为1～127个字符的字符串。区分大小写，支持空格。
【描述】
rmon event命令用来在事件表中添加一个表项。undo rmon event命令用来在事件表中删除一指定表项。
RMON的事件管理定义事件号及事件的处理方式包括：记录日志、向网管站发Trap消息、记录日志的同时向网管站发Trap消息或者既不记录日志也不发送Trap消息。这样系统就可以对告警表中定义的告警事件进行相应的处理。
相关配置可参考display rmon event、rmon alarm和rmon prialarm。
l 如果在新建表项时，指定的事件描述（description string）、事件类型（log、trap、logtrap或none）和团体名（trap-community或log-trapcommunity）三项参数的值和已经存在的事件表项对应的三项参数值完全相同时，系统将认为这两个表项的配置相同，创建操作失败。
l 用户最多可以定义60个事件表项。
【举例】
# 在事件表中添加索引号为10、标记为日志的事件。
<Sysname> system-view
[Sysname] rmon event 10 log owner user1
【命令】
rmon history entry-number buckets number interval sampling-interval [ owner text ]
undo rmon history entry-number
【视图】
以太网接口视图
【缺省级别】
2：系统级
【参数】
entry-number：添加/删除历史控制表项的索引号，取值范围为1～65535。
buckets number：该历史控制表项对应的历史表容量，即历史表最多可容纳的记录数，取值范围为1～65535。
interval sampling-interval：统计周期，取值范围为5～3600，单位为秒。
owner text：该表项的创建者，为1～127个字符的字符串。区分大小写，支持空格。
【描述】
rmon history命令用来在历史控制表中添加一个表项。undo rmon history命令用来在历史控制表中删除指定表项。
创建历史表项后，系统会按周期统计当前端口收发报文的情况，并将统计值作为一个实例保存在etherHistoryEntry表的叶子节点下。可保存的统计值个数由buckets number参数决定，当历史表的容量达到最大值时，系统会删除最早的记录来保存新的统计值。统计信息包括端口一个周期内收到的报文总数、广播报文总数和组播报文总数等。
在添加历史表项的过程中，如果指定的历史表容量超出了设备实际支持的历史表容量时，新的历史表项会被添加，但该表项对应生效的历史表容量为设备实际支持的历史表容量，可以使用display rmon history命令来查看配置结果。
l 如果在新建表项时，指定的采样间隔（interval sampling-interval）参数的值和该接口下已经存在的历史表项对应的该项参数值相同时，系统将认为这两个表项的配置相同，创建操作失败。
l 用户最多可以定义100个历史表项。
相关配置可参考命令display rmon history。
【举例】
# 创建索引号为1，表容量为10，采样时间为5秒的历史控制表项，创建者为user1
<Sysname> system-view
[Sysname] interface GigabitEthernet 1/1/1
[Sysname-GigabitEthernet1/1/1] rmon history 1 buckets 10 interval 5 owner user1
【命令】
rmon prialarm entry-number prialarm-formula prialarm-des sampling-interval { absolute | changeratio | delta } rising-threshold threshold-value1 event-entry1 falling-threshold threshold-value2 event-entry2 entrytype { forever | cycle cycle-period } [ owner text ]
undo rmon prialarm entry-number
【视图】
系统视图
【缺省级别】
2：系统级
【参数】
entry-number：该新建表项的索引号，取值范围为1～65535。
prialarm-fromula：对告警变量进行计算的告警公式，为1～256个字符的字符串。公式中的告警变量必须以OID来表示，OID表达式必须以小数点开始，例如(.1.3.6.1.2.1.2.1.10.1)*8；用户可以使用加减乘除四种运算方法对告警变量进行运算，该运算公式的结果取值为长整型数。用户在编写公式的时候需要注意，公式中每一步的运算结果都不能超过长整型数的取值范围，否则可能会得出错误的结果。
prialarm-des：对该告警的描述，为1～127个字符的字符串。
sampling-interval：采样间隔时间，取值范围为10～65535，单位为秒。
absolute | changeratio | delta：采样类型，绝对值采样、变化率采样或者变化值采样。绝对值采样是采样时间到达时直接提取变量的值，变化值采样是采样时间到达时提取的是变量在采样间隔内的变化值。变化率采样方式暂时不支持。
rising-threshold threshold-value1 event-entry1：设置超上限参数，threshold-value1表示上限阈值，取值范围为-2147483648～+2147483647；event-entry1表示上限阈值相应的事件号，取值范围为0～65535（0表示没有对应的事件，告警被触发后不会采取任何事件动作）。
falling-threshold threshold-value2 event-entry2：设置下限参数，threshold-value2表示下限阈值，取值范围为-2147483648～+2147483647；event-entry2表示下限阈值相应的事件号，取值范围为0～65535（0表示没有对应的事件，告警被触发后不会采取任何事件动作）。
forever：本告警实例存活类型为永久。
cycle cycle-period：本告警实例的存活时间，单位为秒，取值范围0～2147483647。
owner text：该表项的创建者，为1～127个字符的字符串。区分大小写，支持空格。
【描述】
rmon prialarm命令用来在扩展RMON告警表中添加一个表项。undo rmon prialarm命令用来在扩展RMON告警表中删除指定表项。
用户定义了扩展告警表项后，系统对扩展告警表项的处理如下：
l 对定义的扩展告警公式中的告警变量按照定义的时间间隔进行采样
l 将采样值按照定义的运算公式进行计算
l 将计算结果和和设定的阈值进行比较，按照下表执行相应的处理过程
|
实际情况 |
处理过程 |
|
计算值大于等于设定的上限threshold-value1 |
触发事件表中定义的事件event-entry1 |
|
计算值小于等于设定的下限threshold-value2 |
触发事件表中定义的事件event-entry2 |
l 在添加扩展告警表项之前，需要通过rmon event命令定义好扩展告警表项中引用的事件。
l 如果在新建表项时，指定的告警变量公式（prialarm-formula）、采样间隔（sampling-interval）、采样类型（absolute、changeratio或delta）、上限阈值（threshold-value1）和下限阈值（threshold-value2）五项参数的值和已经存在的扩展告警表项对应的五项参数值完全相同时，系统将认为这两个表项的配置相同，创建操作失败。
l 用户最多可以定义50个扩展告警表项。
相关配置可参考display rmon prialarm、rmon event、rmon history和rmon statistics。
【举例】
# 在扩展告警表中添加索引号为5的表项，对相应告警变量以公式(.1.3.6.1.2.1.16.1.1.1.6.1*100/.1.3.6.1.2.1.16.1.1.1.5.1)运算，对该公式中涉及的变量以10秒的采样间隔进行绝对值采样。上限告警值为80对应事件1（将事件记录在日志表中），下限告警值为5对应事件2（不需要采取措施），表项的存活时间为永远（forever），创建者为user1。
<Sysname> system-view
[Sysname] rmon event 1 log
[Sysname] rmon event 2 none
[Sysname] interface GigabitEthernet 1/1/1
[Sysname-GigabitEthernet1/1/1] rmon statistics 1
[Sysname-GigabitEthernet1/1/1] quit
[Sysname] rmon prialarm 1 (.1.3.6.1.2.1.16.1.1.1.6.1*100/.1.3.6.1.2.1.16.1.1.1.5.1) packet. GigabitEthernet1/1/1 10 absolute rising-threshold 80 1 falling-threshold 5 2 entrytype forever owner user1
1.3.6.1.2.1.16.1.1.1.6.1是节点etherStatsBroadcastPkts.1的OID，1.3.6.1.2.1.16.1.1.1.5.1是节点etherStatsPkts.1的OID。.1与接口统计表项的编号一致，如果创建的是“rmon statistics 5”，则对应需要使用.1.3.6.1.2.1.16.1.1.1.6.5和.1.3.6.1.2.1.16.1.1.1.5.5。
以上配置步骤实现：对接口GigabitEthernet1/1/1的使用情况进行统计、监控，当广播报文占总报文数的比例大于等于80％时将该事件记录到日志表中，比例小于等于5％时不采取任何措施。
通过display rmon eventlog命令可以查看事件日志。
【命令】
rmon statistics entry-number [ owner text ]
undo rmon statistics entry-number
【视图】
以太网接口视图
【缺省级别】
2：系统级
【参数】
entry-number：添加/删除统计信息的索引号，取值范围为1～65535。
owner text：该表项的创建者，为1～127个字符的字符串。区分大小写，支持空格。
【描述】
rmon statistics命令用来在统计表中添加一个表项。undo rmon statistics命令用来在统计表中删除指定表项。
统计表项建立后，系统会持续统计当前端口的使用情况。统计信息包括网络冲突数、CRC校验错误报文数、过小（或超大）的数据报文数、广播、多播的报文数以及接收字节数、接收报文数、发送字节数、发送报文数等。设备重启时，会清除该统计信息。
用户可以通过display rmon statistics命令来显示统计表项的信息。
l 每个接口下只能定义一个统计表项。
l 用户最多可以定义100个统计表项。
【举例】
# 在统计表中添加GigabitEthernet1/1/1的统计表项，表项的索引号为20，创建者为user1。
<Sysname> system-view
[Sysname] interface GigabitEthernet 1/1/1
[Sysname-GigabitEthernet1/1/1] rmon statistics 20 owner user1
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
售前咨询
售后咨询
人工在线咨询
