prober插件通过API方式采集打点数据,目前已有插件:
-
elasticsearch
-
github
-
haproxy
-
mongodb
-
mysql
-
nginx
-
prometheus
-
rabbitmq
-
redis
-
tengine
-
zookeeper
prober插件是使用telegraf(https://www.influxdata.com/time-series-platform/telegraf/T) 插件接口封装而成,你可以:
-
直接封装一个telegraf
-
写一个telegraf插件,然后再封装成prober插件
接下来用src/modules/monapi/plugins/demo为例,介绍插件的开发。
Telegraf插件 开发
安全提示
需要实现一个这样的接口类型:
下面是demo插件的实现:
这样就有了一个telegraf的插件, 接下来将它封装成 prober 插件。
插件中Gather方法中的acc是一个接口,具体的实例由运行环境提供的, 在prober中运行插件时,acc的实现在src/modules/prober/manager/accumulator.go
Prober
prober会定期从monapi获取collectRule列表,检查更新自己的插件实例。
-
create rule collector
-
update rule collector
-
delete rule collector
其中,update rule是由delete old,create new来实现的。
monapi之所以需要加载插件,是因为需要获取插件的参数描述,这样才能渲染出合适的UI界面,方便用户输入。 这是demo的参数描述:
有关ui的信息描述,放在了structField的tag中,详细的tag如下:
这样,mapapi拿到结构体后,就可以知道如何渲染,填充结构体里的参数,然后将用户输入的数据存入数据库后,分发到各个prober上执行。
prober获取规则后,通过插件的TelegrafInput方法,将rule转换成telegraf.Input实例。
测试
src/modules/monapi/plugins/demo/demo_test.go
部署
内置编译
-
修改src/modules/monapi/plugins/all/all.go,添加demo
-
重新编译monapi & prober
外挂加载
将自己的插件编译成动态库文件(.so), 复制到monapi &prober工作目录下的plugins/
观看视频讲解:https://www.bilibili.com/video/BV1MK4y1D7i5