/snmp
snmp
/snmp菜单用于启用 SNMP 代理并设置其常规行为：向 SNMPv3 客户端标识路由器的引擎 ID、其应答的地址和 VRF，以及 trap 的发送方式。代理默认关闭。实际可读写的 community 在/snmp/community菜单中定义。配置示例参见 SNMP 指南。
snmp
Type: Settings Directory
/snmp 菜单用于启用 SNMP 代理并设置其常规行为：向 SNMPv3 客户端标识路由器的引擎 ID、其应答的地址和 VRF，以及 trap 的发送方式。代理默认关闭。实际可读写的 community 在 /snmp/community 菜单中定义。配置示例参见 SNMP 指南。
| 参数 | 类型 | 描述 |
|---|---|---|
enabled | bool | SNMP 代理是否应答查询并发送 trap。默认值：no。 |
contact | string | 管理联系人信息，任何采集器均可读取。默认值：empty。 |
location | string | 管理位置信息，任何采集器均可读取。默认值：empty。 |
engine-id-suffix | string | SNMP 代理引擎 ID 的尾部。路由器使用前缀 80003a8c04 和以 ASCII 十六进制表示的值构建完整引擎 ID；例如后缀 1234 会生成引擎 ID 80003a8c0431323334。将后缀留空可使用自动生成的引擎 ID，该 ID 在每台路由器上不同，并在重启后保持不变。默认值：empty。 |
src-address | alt { ip: ipAddr , ip6: ip6Addr } | SNMP 消息的源地址。设置值后，代理仅应答发往该地址的请求，IPv4 值会使其停止应答 IPv6 请求。默认值：:: - 回复来自接收请求的接口地址。 |
trap-target | object { ip-addresses: alt { ipv6: ip6Addr , ip: ipAddr } } | 接收 SNMP trap 的采集器地址列表；trap 会发送到每个地址的 UDP 端口 162。默认值：empty。 |
trap-community | enum | 用于发送 trap 的 community。它必须存在于 /snmp/community 菜单中；其安全级别决定 trap 的保护方式。默认值：public。 |
trap-version | enum (1 | 2 | 3) { 1:0, 2:1, 3:3 } | trap 协议的版本。 - 1（默认）- SNMPv1 trap。 - 2 - SNMPv2c trap 报文。 - 3 - SNMPv3 trap，使用 trap-community 的身份验证和加密。 |
trap-generators | multi { array-id, generator: enum } | 生成 trap 的事件；可以组合多个值。 - interfaces - 接口状态变化时生成 linkDown/linkUp trap；可通过 trap-interfaces 缩小范围。 - start-trap - SNMP 服务启动时生成 trap。 - temp-exception（默认）- CPU 温度达到 /system/health 阈值时生成 trap。 |
trap-interfaces | object { interface: iface_enum } | 状态变化会生成 interfaces trap 的接口列表；其他接口保持静默。空表示任意接口。默认值：empty。 |
vrf | enum | SNMP 代理运行所在的 VRF。到达其他 VRF 的请求不会收到回复。默认值：main。 |
| 只读参数 | 类型 | 描述 |
|---|---|---|
engine-id | string | 代理的完整 SNMP 引擎 ID：前缀 80003a8c04 后跟以 ASCII 十六进制表示的 engine-id-suffix 值；后缀为空时使用自动生成的 ID。SNMPv3 客户端通过该值寻址代理，并在每个请求中包含它。 |