- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 新华三人才研学中心
- 关于我们
24-SNMP-RMON命令
本章节下载： 24-SNMP-RMON命令 (271.15 KB)
目 录
1.1.2 display snmp-agent community
1.1.3 display snmp-agent group
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-list
1.1.8 display snmp-agent usm-user
1.1.11 snmp-agent calculate-password
1.1.14 snmp-agent local-engineid
1.1.17 snmp-agent packet max-size
1.1.23 snmp-agent trap queue-size
【命令】
display snmp-agent { local-engineid | remote-engineid }
【视图】
任意视图
【参数】
local-engineid：本地SNMP实体引擎ID。
remote-engineid：远端SNMP实体引擎ID。
【描述】
display snmp-agent 命令用来显示本地或远程SNMP实体引擎ID。
SNMP引擎是SNMP管理域的标识，它在一个管理域内唯一的标识一个SNMP实体。SNMP引擎是SNMP实体的重要组成部分，完成SNMP消息的收发、验证、提取PDU、组装消息、与SNMP应用程序通信等功能。
【举例】
# 显示本地设备的引擎ID。
<device> display snmp-agent local-engineid
SNMP local EngineID: 800007DB000FE20F12346877
以上信息中，SNMP local EngineID表示本地SNMP实体引擎ID。
【命令】
display snmp-agent community [ read | write ]
【视图】
任意视图
【参数】
read：显示只读访问权限的团体名信息。
write：显示读写访问权限的团体名信息。
【描述】
display snmp-agent community命令用来显示SNMP v1或SNMP v2c当前配置的团体名信息。
【举例】
# 显示当前配置的团体名。
<device> display snmp-agent community
Community name:public
Group name:public
Storage-type: nonVolatile
Community name:private
Group name:private
Storage-type: nonVolatile
表1-1 display snmp-agent community命令显示信息描述表
|
字段 |
描述 |
|
Community name |
团体名 |
|
Group name |
组名 |
|
Storage-type |
存储类型，有以下几种类型： l volatile l nonVolatile l permanent l readOnly l other |
【命令】
display snmp-agent group [ group-name ]
【视图】
任意视图
【参数】
group-name：指定要显示SNMP信息的组名，取值范围为1～32个字符。
【描述】
display snmp-agent group命令用来显示设备上的组信息。包括组名、安全模式、各种视图的状态以及组存储方式。
【举例】
# 显示SNMP组名以及安全模式。
<device> display snmp-agent group
Group name: v3r2
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 |
该组对应的通知的MIB视图名 |
|
storage-type |
存储方式，有以下几种类型： l volatile l nonVolatile l permanent l readOnly l other |
【命令】
display snmp-agent mib-view [ exclude | include | viewname view-name ]
【视图】
任意视图
【参数】
exclude：显示排除属性SNMP MIB视图。
include：显示包含属性SNMP MIB视图。
view-name：显示指定的SNMP MIB视图名称。
【描述】
display snmp-agent mib-view命令用来显示当前设备的MIB视图配置信息。
【举例】
# 显示当前配置的MIB视图。
<device> display snmp-agent mib-view
View name:ViewDefault
MIB Subtree:internet
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
上述显示域中参数的说明见下表1-3。
表1-3 display snmp-agent mib-view命令显示信息描述表
|
字段 |
描述 |
|
View name |
视图名 |
|
MIB Subtree |
MIB子树 |
|
Subtree mask |
子树掩码 |
|
Storage-type |
存储方式 |
|
ViewType: included/excluded |
标志对一个MIB对象的访问是允许或者是禁止 |
|
View status |
用来指示MIB视图的状态 |
【命令】
display snmp-agent statistics
【视图】
任意视图
【参数】
无
【描述】
display snmp-agent statistics命令用来显示SNMP报文的统计信息。
【举例】
# 显示SNMP报文的统计信息。
<device> display snmp-agent statistics
1276 Messages delivered to the SNMP entity
0 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
1291 Messages passed from the SNMP entity
0 SNMP PDUs which had badValue error-status
0 SNMP PDUs which had genErr error-status
7 SNMP PDUs which had noSuchName error-status
0 SNMP PDUs which had tooBig error-status (Maximum packet size 1500)
3669 MIB objects retrieved successfully
26 MIB objects altered successfully
420 GetRequest-PDU accepted and processed
832 GetNextRequest-PDU accepted and processed
0 GetBulkRequest-PDU accepted and processed
1276 GetResponse-PDU accepted and processed
24 SetRequest-PDU accepted and processed
15 Trap PDUs accepted and processed
0 Alternate Response Class PDUs droped silently
0 Forwarded Confirmed Class PDUs droped silently
【命令】
display snmp-agent sys-info [ contact | location | version ]*
【视图】
任意视图
【参数】
contact：显示当前设备节点的联系信息。
location：显示当前设备节点的物理位置信息。
version：显示系统中运行的SNMP的版本信息。
【描述】
display snmp-agent sys-info命令用来显示当前SNMP设备的系统信息。
不选择参数则显示全部信息。
【举例】
# 显示SNMP设备的系统信息。
<device> display snmp-agent sys-info
The contact person for this managed node:
Hangzhou, H3C Technologies Co.,Ltd.
The physical location of this node:
Hangzhou China
SNMP version running in the system:
SNMPv3
【命令】
display snmp-agent trap-list
【视图】
任意视图
【参数】
无
【描述】
display snmp-agent trap-list命令用来显示系统Trap列表信息。
相关配置可参考命令snmp-agent trap enable。
【举例】
# 显示Trap列表信息。
<device> display snmp-agent trap-list
flash trap enable
standard trap enable
system trap enable
Enable traps :4; Disable traps 0
【命令】
display snmp-agent usm-user [ engineid engineid | username user-name | group group-name ]*
【视图】
任意视图
【参数】
engineid：显示指定引擎ID的SNMP v3的用户信息，取值范围为10～64个十六进制数。
user-name：显示指定SNMP v3用户的信息，取值范围为1～32个字符。
group-name：显示属于指定SNMP组的用户信息，取值范围为1～32个字符。
【描述】
display snmp-agent usm-user命令用来显示SNMP用户信息。不选择参数则显示全部信息。
【举例】
# 显示当前所有的用户信息。
<device> display snmp-agent usm-user
User name: usm-user
Group name: usm-group
Engine ID: 800007DB000FE20F12346877
Storage-type: nonVolatile
UserStatus: active
上述显示域中参数的说明见下表1-4。
表1-4 display snmp-agent usm-user命令显示信息描述表
|
字段 |
描述 |
|
User name |
SNMP用户名 |
|
Group name |
SNMP用户所属组的组名 |
|
Engine ID |
标识SNMP设备的字符串 |
|
Storage-type |
存储方式，有以下几种类型： l volatile l nonVolatile l permanent l readOnly l other |
|
UserStatus |
SNMP 用户的状态 |
【命令】
enable snmp trap updown
undo enable snmp trap updown
【视图】
以太网端口视图/接口视图
【参数】
无
【描述】
enable snmp trap updown命令用来设置允许发送端口或者接口的LINK UP和LINK DOWN的SNMP Trap信息。undo enable snmp trap updown命令用来设置禁止发送当前端口或者接口的LINK UP和LINK DOWN的SNMP Trap信息。
缺省情况下，允许发送端口或者接口的Trap信息。
enable snmp trap updown命令要和snmp-agent target-host命令协同使用，使用snmp-agent target-host命令来指定哪些主机可以接收Trap信息。为了发送Trap信息，用户必须配置至少一条snmp-agent target-host命令。
【举例】
# 允许使用public团体名，发送端口GigabitEthernet1/0/1 的LINK UP和LINK DOWN的SNMP Trap信息到IP地址为10.1.1.1的网管站上。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent trap enable
[device] snmp-agent target-host trap address udp-domain 10.1.1.1 params securityname public
[device] interface GigabitEthernet1/0/1
[device-GigabitEthernet1/0/1] enable snmp trap updown
【命令】
snmp-agent
undo snmp-agent
【视图】
系统视图
【参数】
无
【描述】
snmp-agent命令用来启动SNMP Agent。undo snmp-agent命令用来禁止SNMP Agent。
缺省情况下，SNMP Agent功能处于关闭状态。
【举例】
# 禁止正在运行的SNMP Agent。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] undo snmp-agent
设备为防止恶意用户对未使用的UDP端口的攻击，提高设备的安全性，提供了如下功能：
l 执行snmp-agent命令或执行snmp-agent的任何一条配置命令，都可以启动SNMP Agent，同时打开SNMP Agent使用的UDP 161端口和SNMP TRAP Client使用的UDP 1024端口。
l 应用undo snmp-agent命令的同时即可关闭UDP 161端口和UDP 1024端口。
【命令】
snmp-agent calculate-password plain-password mode { md5 | sha } { local-engineid | specified-engineid engineid }
【视图】
系统视图
【参数】
plain-password：需要被加密的明文密码，取值范围为1～64个字符。
mode：指明使用认证方式加密明文密码。
md5：指定认证协议为HMAC MD5算法。
sha：指定认证协议为HMAC SHA算法。
local-engineid：使用本地引擎ID计算密钥。
specified-engineid：使用用户指定的引擎ID计算密钥。
engineid：用户输入用来计算机密钥的引擎ID的16进制数字符串。对引擎ID字符串的字母大小写不敏感，系统转换为大写处理。该字符串必须为偶数个字符，并且字符长度范围为10～64。
【描述】
snmp-agent calculate-password 命令用来将明文密码根据选定的加密算法（MD5或者SHA）计算出相应的密文密码。
计算密文密码必须在SNMP Agent功能已开启状态下才能进行。
【举例】
# 使用本地引擎ID和md5算法计算明文为aaaa的密码的密文形式。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent calculate-password aaaa mode md5 local-engineid
The result of the password is: 382357824A26379D44AD20B01EA861E9
【命令】
snmp-agent community { read | write } community-name [ [ acl acl-number ] [ mib-view view-name ] ]*
undo snmp-agent community community-name
【视图】
系统视图
【参数】
read：表明对MIB对象进行只读的访问，具有只读权限的团体只能对设备信息进行查询。
write：表明对MIB对象进行读写的访问，具有读写权限的团体可以对设备进行配置。
community-name：团体名，取值范围为1～32个字符。
view-name：MIB视图名，取值范围为1～32个字符。
acl-number：该团体名指定的基本访问控制列表，取值范围为2000～2999。
【描述】
snmp-agent community命令用来设置团体访问名、允许对SNMP协议进行访问。undo snmp-agent community命令用来取消团体访问名设置。
【举例】
# 设置团体名为comaccess，并且允许使用该团体名进行只读访问。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent community read comaccess
# 设置团体名为mgr，并且可以进行读写访问。
[device] snmp-agent community write mgr
# 删除团体名comaccess。
[device] undo snmp-agent community comaccess
【命令】
(1) 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
(2) 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 ]
【视图】
系统视图
【参数】
v1：SNMP v1版本。
v2c：SNMP v2c版本。
v3：SNMP v3版本。
group-name：组名，取值范围为1～32个字符。
authentication：指明对报文进行认证但不加密。
privacy：指明对报文进行认证和加密。
read-view：只读视图名，取值范围为1～32个字符。
write-view：读写视图名，取值范围为1～32个字符。
notify-view：通知视图名，取值范围为1～32个字符。
acl-number：基本访问控制列表，取值范围为2000～2999。
【描述】
snmp-agent group命令用来配置一个新的SNMP组，即将SNMP用户映射到SNMP视图。undo snmp-agent group命令用来删除一个指定的SNMP组。
缺省情况下，snmp-agent group v3命令配置的SNMP组采用不认证、不加密方式。
相关配置可参考命令snmp-agent mib-view，snmp-agent usm-user。
【举例】
# 创建一个SNMP v3组group1。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent group v3 group1
【命令】
snmp-agent local-engineid engineid
undo snmp-agent local-engineid
【视图】
系统视图
【参数】
engineid：引擎ID字符串，必须为十六进制数字，该字符串必须为偶数个字符，并且字符长度范围为10～64个十六进制数。
【描述】
snmp-agent local-engineid命令用来设置本地SNMP实体的引擎ID。undo snmp-agent local-engineid命令用来恢复缺省设置。
缺省情况下，设备引擎ID为公司的“企业号＋设备信息”。设备信息由各个产品自己决定，可以是IP地址，MAC地址或者自己定义的十六进制数字串。
相关配置可参考命令snmp-agent usm-user。
【举例】
# 配置本地设备的名称为123456789A。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent local-engineid 123456789A
【命令】
snmp-agent log { set-operation | get-operation | all }
undo snmp-agent log { set-operation | get-operation | all }
【视图】
系统视图
【参数】
set-operation：将网管的设置（set）操作记入日志系统。
get-operation：将网管的查询（get）操作记入日志系统。
all：将网管发送来的get、set操作都记入日志系统。
【描述】
snmp-agent log命令用来打开网管操作的日志功能。undo snmp-agent log命令用来关闭网管操作的日志功能。
缺省情况下，网管操作的日志功能关闭。
用户只需要在当前设备上使用display logbuffer命令，就可查看网管发送过来的get和set操作的日志信息。
【举例】
# 打开网管查询和设置操作的日志功能。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent log all
【命令】
snmp-agent mib-view { included | excluded } view-name oid-tree [ mask mask-value ]
undo snmp-agent mib-view view-name
【视图】
系统视图
【参数】
included：表示包括该MIB子树。
excluded：表示排除该MIB子树。
view-name：视图名。
oid-tree：MIB对象子树的OID MIB子树，可以是变量OID的字符串（如1.4.5.3.1），也可以是变量名的字符串（如system）。
mask mask-value：MIB对象子树的掩码，必须为偶数个十六进制数字，且长度范围为2～32。奇数个十六进制数字被认为是无效参数。
【描述】
snmp-agent mib-view命令用来创建或者更新MIB视图的信息，以限制NMS可以访问的MIB对象。undo snmp-agent mib-view命令用来取消当前设置。
缺省情况下，视图名为ViewDefault，OID为1。
若创建视图时指定了十六进制的掩码值，则按照从左至右的顺序，视图掩码值的二进制数值表示的每个bit与MIB对象子树OID中的每个子OID一一对应。在掩码的二进制表示中，1表示精确匹配，即要访问的节点OID与MIB对象子树OID对应位置的子OID必须相等；0表示通配，即要访问的节点OID与MIB对象子树OID对应位置的子OID允许不相等。
使用掩码定义视图时，有以下几点需要注意：
l 若视图掩码值的二进制数值的位数多于MIB对象子树OID中的子OID个数，则多出部分不做考虑；
l 若视图掩码值的二进制数值的位数少于MIB对象子树OID中的子OID个数，则默认用二进制的1补全。
l 若创建视图时未指定掩码值，则与掩码值为全F（二进制数值为全1）时效果一样，但在读取掩码值时显示为空。
相关配置可参考命令snmp-agent community，snmp-agent group。
【举例】
# 创建一个名称为view-a，MIB对象子树为1.3.6.1.5.4.3.4，子树掩码为FE的视图。对于OID为1.3.6.1.5.4.3.x的MIB节点都包含在该视图内，其中x表示任意整数值。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent mib-view included view-a 1.3.6.1.5.4.3.4 mask FE
【命令】
snmp-agent packet max-size byte-count
undo snmp-agent packet max-size
【视图】
系统视图
【参数】
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字节。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent packet max-size 1042
【命令】
snmp-agent sys-info { contact sys-contact | location sys-location | version { { v1 | v2c | v3 }* | all } }
undo snmp-agent sys-info { contact [ location ] | location [contact ] | version { { v1 | v2c | v3 }* |all } }
【视图】
系统视图
【参数】
sys-contact：描述系统维护联系信息的字符串，为长度不超过200个字符的字符串。
sys-location：设备节点的物理位置信息，为长度不超过200个字符的字符串。
version：设置系统启用的SNMP版本号。
v1：SNMP v1版本。
v2c：SNMP v2c版本。
v3：SNMP v3版本。
all：SNMP v1、SNMP v2c、SNMP v3版本。
【描述】
snmp-agent sys-info命令用来设置系统信息，包括系统维护联系信息、设备节点的物理位置信息、并设置设备启用相应SNMP版本等。undo snmp-agent sys-info命令用来恢复系统的缺省配置。
如果设备发生故障，设备维护人员可以利用系统维护联系信息，及时与设备生产厂商取得联系。
缺省情况下，设备的系统维护联系信息为“Hangzhou H3C Technologies Co.,Ltd.”；物理位置信息为“Hangzhou China”；版本为<NONE>。
相关配置可参考命令display snmp-agent sys-info。
【举例】
# 设置系统维护联系信息为Dial System Operator # 1234。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent sys-info contact Dial System Operator # 1234
【命令】
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 ip-address securityname security-string
【视图】
系统视图
【参数】
trap：指定该主机为Trap主机。
address：指定SNMP消息传输的目标主机地址。
udp-domain：指定目标主机的传输域基于UDP。
ip-address：接受Trap的主机的IPV4地址。
port-number：指定接收Trap报文的UDP端口号，取值范围为1～65535。
params：指定目标主机信息以用于产生SNMP消息。
security-string：SNMP v1、SNMP v2c的团体名或SNMP v3的用户名，取值范围为1～32个字符。
v1：代表SNMP v1版本。
v2c：代表SNMP v2c版本。
v3：代表SNMP v3版本。
authentication：指明对报文进行认证但不加密。
privacy：指明对报文进行认证和加密。
【描述】
snmp-agent target-host命令用来设置接收SNMP Trap报文的目的主机。undo snmp-agent target-host命令用来取消当前设置。
若要一台设备可以发送Trap消息，需要将snmp-agent target-host命令与snmp-agent trap enable或enable snmp trap updown命令协同使用：
(1) 使用snmp-agent trap enable或enable snmp trap updown命令设置允许发送的Trap报文(默认是可以发送所有Trap的)。
(2) 使用snmp-agent target-host命令来设置接收SNMP Trap报文的目的主机地址。
相关配置可参考命令snmp-agent trap enable，snmp-agent trap source，snmp-agent trap life。
【举例】
# 允许向10.1.1.1发送SNMP Trap报文 ，使用团体名public。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent trap enable standard
[device] 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 ]
【视图】
系统视图
【参数】
configuration：发送配置操作的Trap报文。
flash：发送Flash的Trap信息。
standard：发送SNMP标准的通知或Trap信息。
authentication：认证失败时，发送SNMP协议的认证失败的Trap信息。
coldstart：当设备重新启动时，发送SNMP协议的冷启动Trap信息。
linkdown：当端口由up状态变为down状态时，发送SNMP协议的链路down掉的Trap信息。
linkup：当端口由down状态变为up状态时，发送SNMP协议的链路up的Trap信息。
warmstart：当SNMP协议重新启动时，发送SNMP协议的热启动Trap报文。
system： 发送device-SYS-MAN-MIB（私有MIB）的Trap信息。
【描述】
snmp-agent trap enable命令用来设置允许发送设备的Trap报文。undo snmp-agent trap enable命令用来设置禁止设备发送Trap报文。
缺省情况下，允许发送Trap报文。
snmp-agent trap enable命令需要与snmp-agent target-host命令协同使用，使用snmp-agent target-host命令来指定哪些主机可以接收Trap信息。为了发送Trap信息，用户必须配置至少一条snmp-agent target-host命令。
【举例】
# 允许向10.1.1.1发送SNMP认证失败Trap报文，使用团体名为public。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent trap enable standard authentication
[device] snmp-agent target-host trap address udp-domain 10.1.1.1 params securityname public
【命令】
snmp-agent trap ifmib link extended
undo snmp-agent trap ifmib link extended
【视图】
系统视图
【参数】
无
【描述】
snmp-agent trap ifmib link extended命令用来配置Trap扩展功能。undo snmp-agent trap ifmib link extended命令用来恢复为缺省情况。
缺省情况下，linkUp/linkDown Trap使用IF-MIB中定义的标准格式（具体请参见RFC1213），此时发往日志主机的所有Trap消息中，MIB对象的OID字符串后没有增加对应MIB对象的名字。
【举例】
# 配置扩展linkUp/linkDown Trap的格式，使Trap信息中包含接口描述和接口类型。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent trap ifmib link extended
【命令】
snmp-agent trap life seconds
undo snmp-agent trap life
【视图】
系统视图
【参数】
seconds：老化时间，单位为秒，取值范围为1～2592000。
【描述】
snmp-agent trap life命令用来设置Trap报文的老化时间，超过该时间的Trap报文都将被丢弃。undo snmp-agent trap life命令用来恢复Trap报文老化时间的缺省值。
缺省情况下，SNMP Trap报文的老化时间为120秒。
相关配置可参考命令snmp-agent trap enable，snmp-agent target-host。
【举例】
# 设置Trap报文的老化时间为60秒。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent trap life 60
【命令】
snmp-agent trap queue-size size
undo snmp-agent trap queue-size
【视图】
系统视图
【参数】
size：消息队列的长度，取值范围为1～1000。
【描述】
snmp-agent trap queue-size命令用来设置发往目的主机的Trap报文的消息队列的长度。undo snmp-agent trap queue-size命令用来恢复Trap报文的消息队列的长度的缺省值。
缺省情况下，发往目的主机的Trap报文的消息队列的长度为100条。
相关配置可参考命令snmp-agent trap enable，snmp-agent target-host，snmp-agent trap life。
【举例】
# 设置发送Trap报文的消息队列的长度为200条。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent trap queue-size 200
【命令】
snmp-agent trap source interface-type interface-number
undo snmp-agent trap source
【视图】
系统视图
【参数】
interface-type：接口类型。
interface-number：接口编号。
【描述】
snmp-agent trap source命令用来指定发送Trap消息的源地址。undo snmp-agent trap source命令用来取消当前配置。
从一台服务器发出的SNMP Trap消息，无论从哪个接口发出，都有一个发送Trap报文的源IP地址。
缺省情况下，由SNMP选择一个出接口。
如果用户想使用Trap地址来跟踪特定事件时，可以使用这条配置命令。
在将某个接口设置为发送Trap的源地址之前，必须保证该接口已经配置了IP地址。
相关配置可参考命令snmp-agent trap enable，snmp-agent target-host。
【举例】
# 将VLAN接口1的IP地址作为Trap报文的源地址。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent trap source Vlan-interface 1
【命令】
(1) v1、v2c版本
snmp-agent usm-user { v1 | v2c } user-name group-name [ acl acl-number ]
undo snmp-agent usm-user { v1 | v2c } user-name group-name
(2) v3版本
snmp-agent usm-user v3 user-name group-name [ cipher ] [ authentication-mode { md5 | sha } auth-password [ privacy-mode { des56 | aes128 } priv-password ] ] [ acl acl-number ]
undo snmp-agent usm-user v3 user-name group-name { local | engineid engineid-string }
【视图】
系统视图
【参数】
v1：用户使用v1的安全模式。
v2c：用户使用v2c的安全模式。
v3：用户使用v3的安全模式。
user-name：用户名，取值范围为1～32个字符。
group-name：该用户对应的组名，取值范围为1～32个字符。
cipher：指明认证或者加密密码需采用密文形式。
authentication-mode：指明安全级别为需要认证。如果不输入该参数，则默认是无认证，无加密模式。
md5：指定认证协议为HMAC MD5算法。
sha：指定认证协议为HMAC SHA算法。
auth-password：认证密码，字符串，明文形式下取值范围为1～64个字符。密文形式下若采用MD5算法，则为32个16进制数的认证密钥；若采用SHA算法，则为40个16进制数的认证密钥。
privacy：指明安全级别为加密。
des56：指定加密协议为DES（Data Encryption Standard，数据加密标准）。
aes128：指定加密协议为AES（Advanced Encryption Standard，高级加密标准）。
priv-password：加密密码，字符串，明文形式下取值范围为1～64个字符。密文形式下若采用MD5算法，则为32个16进制数的认证密钥；若采用SHA算法，则为40个16进制数的认证密钥。
acl-number：基本访问控制列表，取值范围为2000～2999。
local：表示本地实体用户。
engineid-string：指定与该用户相关联的引擎ID，必须为十六进制数字，该字符串必须为偶数个字符，并且字符长度范围为10～64个十六进制数。
【描述】
snmp-agent usm-user命令用来为一个SNMP组添加一个新用户。undo snmp-agent usm-user命令用来删除SNMP组的一个用户。
对于SNMP v3用户，在为某个代理配置了远端用户后，在进行验证时，需要用到engineID。如果配置用户后引擎ID（engineID）改变，则原引擎ID相应的用户无效。
执行该命令，对于SNMP v1、SNMP v2c来说，是添加一个新的团体名；对SNMP v3来说，是为一个SNMP的组添加一个新用户。
相关配置可参考命令snmp-agent group，snmp-agent community，snmp-agent local-engineid。
【举例】
# 为SNMP v3组Johngroup加入一个用户John，安全级别为需要认证和加密，指定认证协议为HMAC-MD5、认证密码为hello，指定加密协议为AES、加密密码为cfb128cfb128。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] snmp-agent group v3 Johngroup privacy
[device] snmp-agent usm-user v3 John Johngroup authentication-mode md5 hello privacy-mode aes128 cfb128cfb128
【命令】
display rmon alarm [ entry-number ]
【视图】
任意视图
【参数】
entry-number：告警表项索引号，取值范围为1～65535。如果不指定此参数，则显示所有告警的配置信息。
【描述】
display rmon alarm命令用来显示所有或指定RMON告警的配置信息。
相关配置可参考命令rmon alarm。
【举例】
# 显示RMON告警信息。
Alarm table 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 : 20(sec)
Rising threshold : 100(linked with event 1)
Falling threshold : 10(linked with event 2)
When startup enables : risingOrFallingAlarm
Latest value : 5510006
表2-1 display rmon alarm显示信息描述表
|
字段 |
描述 |
|
Alarm table |
告警表项 |
|
user1 |
创建者 |
|
Valid |
与该索引对应的告警表项有效 |
|
Samples type |
采样类型：变化值或绝对值 |
|
Variable formula |
被采样节点的变量表示 |
|
Sampling interval |
采样的时间间隔 |
|
Rising threshold |
上限阈值 |
|
Falling threshold |
下限阈值 |
|
When startup enables |
告警启动类型： risingOrFallingAlarm（允许上限和下限触发告警） risingAlarm（允许上限触发告警） FallingAlarm（允许下限触发告警） |
|
Latest value |
最近一次采样值 |
【命令】
display rmon event [ event-entry ]
【视图】
任意视图
【参数】
event-entry：事件表的索引号，取值范围为1～65535。如果不指定此参数，则显示所有事件的配置信息。
【描述】
display rmon event命令用来显示所有或指定RMON事件的配置信息。
显示信息包括：事件表中的事件索引、事件的所有者、对事件的描述、事件引发的动作（日志或告警消息）、最近一次事件发生的时刻（此时间是以系统初始化/启动以来的秒数计算的）等。
相关配置可参考命令rmon event。
【举例】
# 显示RMON事件。
<device> display rmon event
Event table 1 owned by user1 is VALID.
Description: null.
Will cause log-trap when triggered, last triggered at 0days 00h:02m:27s.
表2-2 display rmon event显示信息描述表
|
字段 |
描述 |
|
Event table |
事件表项 |
|
VALID |
索引对应的行状态为有效 |
|
Description |
事件描述 |
|
Will cause log-trap when triggered |
事件引发日志和Trap告警 |
|
last triggered at |
最近一次事件发生时刻 |
【命令】
display rmon eventlog [ event-entry ]
【视图】
任意视图
【参数】
event-entry：事件表的索引号，取值范围为1～65535。如果不指定此参数，则显示所有事件日志的配置信息。
【描述】
display rmon eventlog命令用来显示所有或指定RMON事件日志的配置信息。
显示的RMON事件日志信息包括：事件表中的事件索引及事件当前的状态。事件产生日志的时刻（此时间是以系统初始化/启动以来的秒数计算的）等，以及事件的描述。
【举例】
# 显示RMON事件日志。
<device> display rmon eventlog 1
Event table 1 owned by user1 is VALID.
Generates eventLog 1.1 at 0days 00h:01m:39s.
Description: The 1.3.6.1.2.1.16.1.1.1.4.1 defined in alarm table 1,
less than(or =) 100 with alarm value 0. Alarm sample type is absolute.
Generates eventLog 1.2 at 0days 00h:02m:27s.
Description: The alarm formula defined in private alarm table 1,
less than(or =) 100 with alarm value 0. Alarm sample type is absolute.
表2-3 display rmon eventlog显示信息描述表
|
字段 |
描述 |
|
Event table |
事件表项 |
|
VALID |
索引对应的行状态为有效 |
|
Generates eventLog 1.1 at 0days 00h:02m:27s |
事件发生的时刻，事件可能被触发过多次，1.1表明这是事件1第一次被触发的时间 |
|
Description |
事件日志描述，记录了事件被触发的具体情况 |
【命令】
display rmon history [ interface-type interface-number | unit unit-number ]
【视图】
任意视图
【参数】
interface-type：接口类型。
interface-number：接口编号。
unit unit-number：具体的设备单元号。
【描述】
display rmon history命令用来显示RMON历史控制表及其最近一次历史采样信息，这些信息包括利用率、错误数和总包数等。
相关配置可参考命令rmon history。
【举例】
# 显示端口GigabitEthernet 1/0/1的RMON历史信息。
<device> display rmon history GigabitEthernet 1/0/1
History control entry 1 owned by user1 is VALID
Samples interface : GigabitEthernet1/0/1<ifIndex.4227625>
Sampling interval : 5(sec) with 10 buckets max
Latest sampled values :
Dropevents : 0 , octets : 10035
packets : 64 , broadcast packets : 35
multicast packets : 8 , CRC alignment errors : 0
undersize packets : 0 , oversize packets : 0
fragments : 0 , jabbers : 0
collisions : 0 , utilization : 0
表2-4 display rmon history显示信息描述表
|
字段 |
描述 |
|
History control entry |
历史控制表中的索引号 |
|
VALID |
索引对应的行状态为有效 |
|
Samples interface |
采样端口 |
|
Sampling interval |
采样间隔 |
|
buckets |
历史控制表中的记录数 |
|
Latest sampled values |
最新的采样信息 |
|
dropevents |
丢包事件 |
|
octets |
采样时间内接收或发送的字节数 |
|
packets |
采样时间内接收或发送的包数 |
|
broadcastpackets |
广播包数 |
|
multicastpackets |
组播包数 |
|
CRC alignment errors |
校验错误的包数 |
|
undersize packets |
过小的包数 |
|
oversize packets |
超大的包数 |
|
fragments |
过小且校验错误的包数 |
|
jabbers |
超大且校验错误的包数 |
|
collisions |
冲突的包数 |
|
utilization |
利用率 |
【命令】
display rmon prialarm [ prialarm-entry-number ]
【视图】
任意视图
【参数】
prialarm-entry-number：扩展告警表项索引，取值范围为1～65535。如果不指定此参数，则显示所有扩展告警的配置信息。
【描述】
display rmon prialarm命令用来显示所有或指定的RMON扩展告警的配置信息。
相关配置可参考命令rmon prialarm。
【举例】
# 显示RMON扩展告警信息。
<device> display rmon prialarm
Prialarm table 1 owned by user1 is VALID.
Samples type : absolute
Variable formula : ((.1.3.6.1.2.1.16.1.1.1.4.1)*100)
Description :
Sampling interval : 10(sec)
Rising threshold : 10000(linked with event 1)
Falling threshold : 2000(linked with event 1)
When startup enables : risingOrFallingAlarm
This entry will exist : forever.
Latest value : 0
表2-5 display rmon prialarm显示信息描述表
|
字段 |
描述 |
|
Prialarm table |
扩展告警表行的索引号 |
|
owned by user1 |
创建者为user1 |
|
VALID |
有效 |
|
Samples type |
采样类型：变化值或绝对值 |
|
Variable formula |
被采样节点的变量表示 |
|
Description |
描述 |
|
Sampling interval |
采样间隔 |
|
Rising threshold |
告警上限，当采样值从正常值达到该值时引发上限告警 |
|
Falling threshold |
告警下限，当采样值从正常值达到该值时引发下限告警 |
|
linked with event |
告警对应的事件索引 |
|
When startup enables: risingOrFallingAlarm |
告警启动类型： risingOrFallingAlarm（允许上限和下限触发告警） risingAlarm（允许上限触发告警） FallingAlarm（允许下限触发告警） |
|
This entry will exist: forever |
该行的存在期限， 可以是forever（永远存在），也可以是cycle（在规定的时间内存在） |
|
Latest value |
最近一次采样值 |
【命令】
display rmon statistics [ interface-type interface-number | unit unit-number ]
【视图】
任意视图
【参数】
interface-type：接口类型。
interface-number：接口编号。
unit unit-number：具体的设备单元号。
【描述】
display rmon statistics命令用来显示RMON统计消息。
显示的RMON统计消息包括：网络冲突数、CRC校验错误报文数、过小（或超大）的数据报文数、广播、多播的报文数以及接收字节数、接收报文数等。
相关配置可参考命令rmon statistics。
【举例】
# 显示RMON统计信息。
<device> display rmon statistics GigabitEthernet 1/0/1
Statistics entry 1 owned by user1-rmon is VALID.
Interface : GigabitEthernet1/0/1<ifIndex.4227625>
etherStatsOctets : 30561 , etherStatsPkts : 217
etherStatsBroadcastPkts : 102 , etherStatsMulticastPkts : 25
etherStatsUndersizePkts : 0 , etherStatsOversizePkts : 0
etherStatsFragments : 0 , etherStatsJabbers : 0
etherStatsCRCAlignErrors : 0 , etherStatsCollisions : 0
etherStatsDropEvents (insufficient resources): 0
Packets received according to length:
64 : 177 , 65-127 : 27 , 128-255 : 2
256-511: 0 , 512-1023: 0 , 1024-1518: 11
表2-6 display rmon statistics显示信息描述表
|
字段 |
描述 |
|
Statistics entry |
统计信息表的索引号 |
|
VALID |
有效 |
|
Interface |
被统计端口 |
|
etherStatsOctets |
字节数 |
|
etherStatsPkts |
包数 |
|
etherStatsBroadcastPkts |
广播的包数 |
|
etherStatsMulticastPkts |
组播的包数 |
|
etherStatsUndersizePkts |
过小的包数 |
|
etherStatsOversizePkts |
超大的包数 |
|
etherStatsFragments |
过小且校验错误的包数 |
|
etherStatsJabbers |
超大且校验错误的包数 |
|
etherStatsCRCAlignErrors |
校验错误的包数 |
|
etherStatsCollisions |
冲突的包数 |
|
etherStatsDropEvents |
丢包事件 |
|
Packets received according to length |
收到的不同长度的数据包 |
【命令】
rmon alarm entry-number alarm-variable sampling-time { delta | absolute } rising_threshold threshold-value1 event-entry1 falling_threshold threshold-value2 event-entry2 [ owner text ]
undo rmon alarm entry-number
【视图】
系统视图
【参数】
entry-number：添加/删除表项的索引号，取值范围为1～65535。
alarm-variable：告警变量，字符串类型size（1～256），格式为节点OID的点分格式，如1.3.6.1.2.1.2.1.10.1，只有可以解析为ASN.1中INTEGER (INTEGER, Counter, Gauge, or TimeTicks)的数据类型的变量才能作为告警变量。
sampling-time：采样间隔时间，取值范围为5～65535，单位为秒。
delta：采样类型为变化值（选定变量的当前采样值相对于最近一次采样值的变化量）。
absolute：采样类型为绝对值。
rising_threshold threshold-value1：上限阈值，取值范围为0～2147483647。
event-entry1：上限阈值相应的事件号，取值范围为0～65535。
falling_threshold threshold-value2：下限阈值，取值范围为0～2147483647。
event-entry2：下限阈值相应的事件号，取值范围为0～65535。
owner text：该行的创建者，字符串，长度为1～127个字符。
【描述】
rmon alarm命令用来在告警表中添加一个表项。undo rmon alarm命令用来在告警表中删除一个表项。
本命令用来设置告警项以便在出现异常时触发告警事件，再由告警事件来决定记录日志和向网管站发送Trap。
用户定义了告警表项后，系统对告警表项的处理如下：
l 对所定义的告警变量（alarm-variable）按照定义的时间间隔（sampling-time）进行采样；
l 将采样值和设定的阈值进行比较，按照下表执行相应的处理过程。
|
实际情况 |
处理过程 |
|
采样值大于等于设定的上限threshold-value1 |
触发事件表中定义的事件event-entry1 |
|
采样值小于设定的下限threshold-value2 |
触发事件表中定义的事件event-entry2 |
l 在添加告警表项之前，需要通过rmon event命令定义好告警表项中引用的事件。
l rmon alarm命令在对节点进行监控时，要求被监控的节点必须存在，否则配置无效。
【举例】
# 在告警表中添加第1行，对节点1.3.6.1.2.1.16.1.1.1.4.1以10秒的采样间隔进行采样，当采样值超过50的上限阈值触发事件1，低于下限阈值5时触发事件2；创建者为user1。
<device> system-view
System View: return to User View with Ctrl+Z.
[device]interface GigabitEthernet 1/0/1
[device-GigabitEthernet1/0/1] rmon statistics 1
[device-GigabitEthernet1/0/1] quit
[device] rmon event 1 log
[device] rmon event 2 none
[device] rmon alarm 1 1.3.6.1.2.1.16.1.1.1.4.1 10 absolute rising_threshold 50 1 falling_threshold 5 2 owner user1
# 在告警表中删除第15行信息。
[device] undo rmon alarm 15
【命令】
rmon event event-entry [ description string ] { log | trap trap-community | log-trap log-trapcommunity | none } [ owner text ]
undo rmon event event-entry
【视图】
系统视图
【参数】
event-entry：添加/删除行的索引号，取值范围为1～65535。
description string：事件的描述，字符串，长度为1～127个字符。
log：日志事件。
trap：定义事件为Trap事件。
trap-community：接收事件消息的网管站的团体名属性，字符串，长度为1～127个字符。
log-trap：定义事件为日志和Trap事件。
log-trapcommunity：接收事件消息的网管站的团体名属性，字符串，长度为1～127个字符。
none：不产生动作的事件。
owner text：该行的创建者,字符串，长度为1～127个字符。
【描述】
rmon event命令用来在事件表中添加一行。undo rmon event命令用来在事件表中删除一行。
RMON的事件管理定义事件号及事件的处理方式包括：记日志、向网管站发Trap消息、记日志同时向网管站发Trap消息。这样系统就可以对告警表中定义的告警事件进行相应的处理。
【举例】
# 在事件表中添加第10行，标记为日志事件。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] rmon event 10 log
【命令】
rmon history entry-number buckets number interval sampling-interval [ owner text ]
undo rmon history entry-number
【视图】
以太网端口视图
【参数】
entry-number：添加/删除行的索引号，取值范围为1～65535。
buckets number：该控制行对应历史表容量。取值范围为1～65535。
interval sampling-interval：采样时间，取值范围为5～3600，单位为秒。
owner text：该行的创建者，字符串，长度为1～127个字符。
【描述】
rmon history命令用来在历史控制表中添加一行。undo rmon history命令用来在历史控制表中删除一行。
本命令可以设定对某个端口进行抽样，设置抽样参数（抽样时间间隔）和保存数量。设置之后RMON就定期对指定的端口进行数据采集并保存起来以备查看。抽样信息包括利用率、错误数和总包数等。
用户可以通过display rmon history命令来显示历史控制表项的统计信息。
【举例】
# 创建索引号为1，表容量为10，采样时间为5秒的历史控制表项，创建者为user1。
<device> system-view
System View: return to User View with Ctrl+Z.
[device]interface GigabitEthernet 1/0/1
[device-GigabitEthernet1/0/1]rmon history 1 buckets 10 interval 5 owner user1
# 删除索引号为15的历史控制表项。
[device-GigabitEthernet1/0/1] undo rmon history 15
【命令】
rmon prialarm entry-number prialarm-formula prialarm-des sampling-timer { delta | absolute | changeratio } rising_threshold threshold-value1 event-entry1 falling_threshold threshold-value2 event-entry2 entrytype { forever | cycle cycle-period } [ owner text ]
undo rmon prialarm entry-number
【视图】
系统视图
【参数】
entry-number：该新建行的索引号，取值范围为1～65535。
prialarm-fromula ：对告警变量进行计算的告警公式，字符串长度为1～256个字符。公式中的告警变量必须以OID来表示，例如(.1.3.6.1.2.1.2.1.10.1)*8；用户可以使用加减乘除四种运算方法对告警变量进行运算，该运算公式的结果取值为长整型数。用户在编写公式的时候需要注意，公式中每一步的运算结果都不能超过长整型数的取值范围，否则可能会得出错误的结果。
prialarm-des：对该告警的描述，长度为1～128个字符的字符串。
sampling-timer：采样间隔时间，取值范围为10～65535，单位为秒。
delta | absolute | changeratio：采样类型，变化值、绝对值或者变化率。
threshold-value1：上限阈值，取值范围为0～2147483647。
event-entry1：上限阈值相应的事件号，取值范围为0～65535。
threshold-value2：下限阈值，取值范围为0～2147483647。
event-entry2：下限阈值相应的事件号，取值范围为0～65535。
forever ：告警实例存活类型为永久。
cycle：告警实例存活类型为周期。
cycle-period：告警实例的存活时间，取值范围0～2147483647，单位为秒。
owner text：该行的创建者，字符串，长度为1～127。
【描述】
rmon prialarm命令用来在扩展RMON告警表中设定一行信息。undo rmon prialarm命令用来在扩展RMON告警表中删除一行信息。
l 在添加扩展告警表项之前，需要通过rmon event命令定义好扩展告警表项中引用的事件。
l rmon event命令在对节点进行监控时，要求被监控的节点必需存在，否则配置无效。
l 用户最多可以定义50个扩展告警表项。
用户定义了扩展告警表项后，系统对扩展告警表项的处理如下：
l 对定义的扩展告警公式prialarm-formula中的告警变量按照定义的时间间隔sampling-timer进行采样；
l 将采样值按照定义的运算公式prialarm-formula进行计算；
l 将计算结果和与设定的阈值进行比较，按照下表2-8执行相应的处理过程。
|
实际情况 |
处理过程 |
|
计算值大于等于设定的上限threshold-value1 |
触发事件表中定义的事件event-entry1 |
|
计算值小于等于设定的下限threshold-value2 |
触发事件表中定义的事件event-entry2 |
【举例】
#在扩展告警表的第2行添加扩展告警项，对相应告警变量以公式((.1.3.6.1.2.1.16.1.1.1.4.1)*100)运算，对该运算结果以10秒的采样间隔进行监视，当变化率大于上限阈值50时触发事件1，小于下限阈值5时触发事件2，设置告警实例采样类型为forever，创建者为user1。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] interface GigabitEthernet 1/0/1
[device-GigabitEthernet1/0/1] rmon statistics 1
[device-GigabitEthernet1/0/1] quit
[device] rmon prialarm 2 ((.1.3.6.1.2.1.16.1.1.1.4.1)*100) test 10 changeratio rising_threshold 50 1 falling_threshold 5 2 entrytype forever owner user1
# 在扩展RMON告警表中删除第2行。
[device] undo rmon prialarm 2
【命令】
rmon statistics entry-number [ owner text ]
undo rmon statistics entry-number
【视图】
以太网端口视图
【参数】
entry-number：添加/删除行的索引号，取值范围为1～65535。
owner text：该行的创建者，字符串，长度为1～127个字符。
【描述】
rmon statistics命令用来在统计表中添加一行。undo rmon statistics命令用来在统计表中删除一行。
RMON统计管理功能可以用于统计被监视端口的使用及错误。统计信息包括网络冲突数、CRC校验错误报文数、过小（或超大）的数据报文数、广播、多播的报文数以及接收字节数、接收报文数等。
一个端口下只能创建一个RMON统计表项。即如果在一个端口下已经创建了一个统计表项，再在该端口下创建一个其他索引号的统计表项也不能成功。
用户可以通过display rmon statistics命令来显示统计表项的信息。
【举例】
# 在统计表中的第20行添加GigabitEthernet1/0/1的统计信息。
<device> system-view
System View: return to User View with Ctrl+Z.
[device] interface GigabitEthernet 1/0/1
[device-GigabitEthernet1/0/1] rmon statistics 20
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
售前咨询
售后咨询
人工在线咨询
