百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
S

swcollector

> 编程语言
开源

Swcollector 基于小米运维开源的 open-falcon,交换机专用代理程序。 感谢小米运维同学的杰出工作、开源、良好的文档和热心。 感谢来炜的宝贵建议。 简介 采集的指标列表: CPU 利用率 内存 利用率 Ping 延迟(正常返回延迟,超时返回 -1,可用于存储…

200 stars0 点赞0 次浏览
访问官网GitHub

工具介绍

Swcollector 基于小米运维开源的 open-falcon,交换机专用代理程序。 感谢小米运维同学的杰出工作、开源、良好的文档和热心。 感谢来炜的宝贵建议。 简介 采集的指标列表: CPU 利用率 内存 利用率 Ping 延迟(正常返回延迟,超时返回 -1,可用于存储…

Swcollector

基于小米运维开源的open-falcon,交换机专用agent。

感谢小米运维同学的杰出工作、开源、良好的文档和热心。

感谢来炜的宝贵建议。

简介

采集的metric列表:

  • CPU利用率
  • 内存利用率
  • Ping延时(正常返回延时,超时返回 -1,可以用于存活告警)
  • IfHCInOctets
  • IfHCOutOctets
  • IfHCInUcastPkts
  • IfHCOutUcastPkts
  • IfHCInBroadcastPkts
  • IfHCOutBroadcastPkts
  • IfHCInMulticastPkts
  • IfHCOutMulticastPkts
  • IfInDiscards
  • IfOutDiscards
  • IfInErrors
  • IfOutErros
  • IfInUnknownProtos
  • IfOutQLen
  • IfSpeed
  • IfSpeedPercent
  • IfOperStatus(接口状态,1 up, 2 down, 3 testing, 4 unknown, 5 dormant, 6 notPresent, 7 lowerLayerDown)

CPU和内存的OID私有,根据设备厂家和OS版本可能不同。目前测试过的设备:

  • Cisco IOS(Version 12)
  • Cisco NX-OS(Version 6)
  • Cisco IOS XR(Version 5)
  • Cisco IOS XE(Version 15)
  • Cisco ASA (Version 9)
  • Ruijie 10G Routing Switch
  • Huawei VRP(Version 8)
  • Huawei VRP(Version 5.20)
  • Huawei VRP(Version 5.120)
  • Huawei VRP(Version 5.130)
  • Huawei VRP(Version 5.70)
  • Juniper JUNOS(Version 10)
  • H3C(Version 3.1)
  • H3C(Version 5)
  • H3C(Version 5.20)
  • H3C(Version 7)
  • DELL
  • Linux

二进制安装

从这里 下载编译好的最新二进制版本即可。注意:这些二进制只能跑在64位Linux上

源码安装

	依赖$GOPATH/src/github.com/gaochao1/sw
	cd $GOPATH/src/github.com/gaochao1/swcollector
	go get ./...
	chmod +x control
	./control build
	./control pack
	最后一步会pack出一个tar.gz的安装包,拿着这个包去部署服务即可。
	
	升级时,确保先更新sw
	cd $GOPATH/src/github.com/gaochao1/sw
	git pull

部署说明

swcollector需要部署到有交换机SNMP访问权限的服务器上。

使用Go原生的ICMP协议进行Ping探测,swcollector需要root权限运行。

支持使用 Gosnmp 或 snmpwalk 进行数据采集,如果使用 snmpwalk 模式,需要在监控探针服务器上安装个snmpwalk命令

配置说明

配置文件请参照cfg.example.json,修改该文件名为cfg.json,将该文件里的IP换成实际使用的IP。

配置说明:

…

自定义 host 配置说明

{
	"hosts":
	{
		"192.168.160":"test1",
		"192.168.88.161":"test2",
		"192.168.33.2":"test3",
		"192.168.31.51":"test4"
	}
}

自定义 oid 配置说明

…

配置的热重载

4.0.6.2 版本起,支持配置的热重载。修改配置后无需重启 swcollector 了。 开启配置热重载需要开启 swcollector 的 http 模块。然后使用以下接口重载配置。

# curl http://127.0.0.1:1990/config/reload

注意对于 transfer 的 interval 修改,热重载无效,还是需要重启 swcollector

同时也可以使用下列接口来查看 swcollector 的相关信息(类似于 Open-Falcon 的官方的 agent)

# curl http://127.0.0.1:1990/ips
查看当前 trustIp 的列表
# curl http://127.0.0.1:1990/workdir
查看当前的工作目录
# curl http://127.0.0.1:1990/exit
远程退出进程
# curl http://127.0.0.1:1990/health
查看当前状态
# curl http://127.0.0.1:1990/version
查看当前版本

部署说明

由于是并发采集,因此每个周期的采集耗时,主要取决于被采集的交换机中,最慢的那个。 因此我们可以在 debug 模式下观察每个交换机的采集耗时。

…

如下所示,我们可以发现 192.168.11.2 这个交换机的采集耗时最长,用掉了 10 秒钟,这个占用了采集周期大部分的耗时。

我们可以根据这些信息将交换机做一下分类,snmp 响应快的放在一起用一个 swcollector 采集,snmp 的超时时间可以设置的短一些,采集周期也可以设的小一点,比如30秒 响应慢的放在一起,用另外一个 swcollector 采集,snmp 的超时时间可以设置的长一点,采集周期也可以适当的放久一点,比如5分钟。

snmp 报文的响应需要消耗 cpu,因此交换机多少都对 snmp 报文的响应有速率限制,在 CPU 过高时,还可能会丢弃 snmp,icmp等优先级不高的请求。 不同品牌的对此的限定都有不同,有些型号可以通过配置修改。如果允许的话,也可以通过放开其对 snmp 的限速控制,来加快交换机对 snmp 报文的响应速度。

如此,在我们调节了 *“木桶” *中 “木板” 的长度后,选择了合适的采集周期后,swcollector 的单个实例可以很轻松的带起上百台乃至更多的交换机。

v3-v4 升级说明(重要!!!!)

由于 v4 版本的 swcollector 修改了接口数据的上报格式,从Counter修改为GAUGE。因此如果同一个 endpoint,使用升级后的 swcollector 采集时,graph 内原有数据会全部丢失! 因此建议在升级时,开启自定义 host 功能,将交换机的 ip 地址通过 host 自定义为新的 endpoint,例如原先采集的 ip 为

			"ipRange":[
         	   "192.168.0.1-192.168.0.2",
			   "192.168.1.1"
 			],

开启 switchhosts.enabled = true,然后配置 hosts.json

{
	"hosts":
	{
		"192.168.0.1":"sw-192.168.0.1",
		"192.168.0.2":"sw-192.168.0.1",
		"192.168.1.1":"sw-192.168.1.1"
	}
}

这样他会以新的 "sw-192.168.x.x" 作为 endpoint 上报,原有的 192.168.x.x 依然继续保留,历史纪录不会丢失。

Issues· 38 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Go

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言