手把手教你编写自定义Categraf插件

Tianyiyun · · 39 次点击 · · 开始浏览    

本文分享自天翼云开发者社区《手把手教你编写自定义Categraf插件》,作者:任****佳

Categraf 是一个监控采集 Agent,类似 Telegraf、Grafana-Agent、Datadog-Agent,希望对所有常见监控对象提供监控数据采集能力,采用 All-in-one 的设计,不但支持指标采集,也希望支持日志和调用链路的数据采集。相比于其他采集器,Categraf 的优势在于:支持 remote_write 写入协议,支持将数据写入 promethues、M3DB、VictoriaMetrics、InfluxDB;指标数据只采集数值,不采集字符串,标签维持稳态结构;采用 all-in-one 的设计,所有的采集工作用一个 agent搞定;未来也可以把日志和 trace 的采集纳入 agent;纯 Go 代码编写,静态编译依赖少,容易分发,易于安装。

教你编写自定义Categraf插件:

下面以自定义http_response插件为例;

http_response插件作用:解析http响应,该响应可以是获取的监控数据,再将响应写入指定的监控数据库,如promethues、VictoriaMetrics、InfluxDB等;

http_response插件编写思路:

1.拉取官方代码仓库项目,在插件目录input文件夹下建http_response文件夹,在http_response文件夹下建立http_response.go

2.http_response.go以任意一个官方已有插件go文件为模板粘贴,此处以tomcat插件为例,先将涉及插件名称的地方改为http_response

3.在解释器目录parser文件夹下httpresponse文件夹,在httpresponse文件夹下建立parser.go

4.parser.go中解析的http响应数据的方法,并调用SampleList类的PushSample或PushSamples方法推送监控数据

5.在http_response.go中将初始化方法func (ins *Instance) Init() 中调用解释器即可

6.在配置文件目录conf下建立inputs.http_response文件夹,在inputs.http_response文件夹下增加http_response.toml

7.http_response.toml中增加需要的配置,如

8.在代理注册agent文件下的metrics_agent.go中导入自定义插件的路径,如_ "flashcat.cloud/categraf/inputs/http_response"

9.调试插件:可以将不启用插件的conf下的配置文件删除或重命名,或将agent下的注册插件注释即可

Categraf的官方代码托管在两个地方:

- github:https://github.com/flashcatcloud/categraf
- gitlink:https://www.gitlink.org.cn/flashcat/categraf

 

39 次点击  
加入收藏 微博
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传