SuperAPI AI 工具集

snmptrap-receiver

部署与运维

查看项目

更新于 10-15 18:45

技能介绍

用途:该技能让 NetClaw 通过 UDP 接收网络设备(路由器、交换机、防火墙)发送的 SNMP Trap,并对已收集的数据进行查询,适用于设备事件监控(如链路 up/down、认证失败)、事件调查、多设备 Trap 聚合、按类型/来源/版本过滤及模式分析。

依赖与工具:需配合 MCP 服务器 snmptrap-mcp。可用工具包括 snmptrap_start_receiver(开始监听)、snmptrap_stop_receiver(停止接收)、snmptrap_get_status(查看状态与统计)、snmptrap_query(按条件检索)、snmptrap_get_trap(查看单条完整详情)、snmptrap_get_counts(按类型与来源统计数量)。

使用方式:先调用 snmptrap_start_receiver(示例端口 10162),再将网络设备配置为向该端口发送 Trap,并用 snmptrap_get_status 验证是否收到。查询时可用 snmptrap_query 配合 trap_oid_prefix(如标准 Trap 的 1.3.6.1.6.3.1.1.5)和 source_ip 过滤,再用 snmptrap_get_trap 取回变量绑定详情;日常汇总可用 snmptrap_get_counts 观察分布。

配置:snmptrap-mcp 通过环境变量配置:SNMPTRAP_PORT(默认 162)、SNMPTRAP_BIND_ADDRESS(默认 0.0.0.0)、SNMPTRAP_RETENTION_HOURS(默认 24)、SNMPTRAP_RATE_LIMIT(默认 1000/秒)、SNMPTRAP_DEDUP_WINDOW(默认 5 秒)。

限制:仅内存存储,重启后数据丢失;SNMPv3 需配置 USM 用户才能完整解析;每端口仅支持单实例;不做 MIB 编译,OID 以数字显示;仅支持 UDP,无 TCP/TLS。出错时应直接报告错误信息,不臆测结果;只读调用可检查连通性并重试一次,涉及状态变更或发送消息的调用超时后应先确认状态再决定是否重试。