用途:telemetry-ops 是一个元技能,为 NetClaw 的各类遥测接收器提供统一接口,把 syslog、SNMP Trap、IPFIX/NetFlow 与 gNMI 流式遥测的事件聚合起来,用于整体网络监控。适合在多协议下搭建综合监控、跨来源关联事件、利用多数据源排查网络问题、了解网络健康全貌,以及将新设备接入 NetClaw 监控。
组件技能:syslog-receiver 使用 syslog-mcp,走 RFC 5424/3164 UDP,默认端口 514;snmptrap-receiver 使用 snmptrap-mcp,走 SNMPv1/v2c/v3 UDP,默认端口 162;ipfix-receiver 使用 ipfix-mcp,走 IPFIX/NetFlow UDP,默认端口 2055;gnmi-telemetry 使用 gnmi-mcp,走 gNMI gRPC,默认端口 57400。
典型流程:完整设备上架时,依次配置设备向 NetClaw 发送 syslog(UDP 514)、SNMP trap(UDP 162)、NetFlow/IPFIX 导出(UDP 2055),并把设备加入 gNMI 目标以启用流式遥测,然后启动全部接收器并验证各来源均有数据。多源事件调查时,可查询事发时间附近的 syslog 错误、检查 linkDown 等 SNMP trap、分析流量异常、订阅 gNMI 获取实时接口状态。健康总览可分别使用 syslog_get_severity_counts、snmptrap_get_counts、ipfix_top_talkers 与 gnmi_get。
配置示例:Cisco Catalyst 9300 上 syslog 使用 logging host 10.0.0.1 transport udp port 514,SNMP trap 使用 snmp-server host 10.0.0.1 version 2c public,NetFlow/IPFIX 定义 flow exporter NETCLAW 并设置 transport udp 2055 和 export-protocol ipfix,gNMI 启用 netconf-yang、gnmi-yang 与 gnmi-yang secure-server。由于 ngrok 不支持 UDP,远程测试可选用支持 UDP 的 Pinggy、Tailscale 或 LocalXpose 做隧道。
限制:所有接收器使用内存存储,重启后数据丢失;不内建跨来源关联,关联由 agent 完成;各接收器相互独立运行;远程测试需要 UDP 隧道。工具报错(超时、主机不可达、响应格式错误)时应直接向用户报告失败与错误信息,不得编造或猜测结果。只读调用确认后可检查连通性并重试一次;任何改变状态或发送消息的调用,超时不代表失败,重试前应先检查当前状态或投递状态,保留必需的审批与变更门禁,结果未知的操作不得重复执行。