open-falcon agent项目之前是一个独立项目名字叫falcon-eye ,其自带有web页面来自于linux-dash项目。agent用于采集机器负载监控指标,比如cpu.idle、load.1min、disk.io.util等等,每隔60秒push给Transfer。agent与Transfer建立了长连接,数据发送速度比较快,agent提供了一个http接口/v1/push用于接收用户手工push的一些数据,然后通过长连接迅速转发给Transfer。

一、源码安装
cd $GOPATH/src/github.com/open-falcon/agent
go get ./...
./control build
./control pack

最后一步会pack出一个tar.gz的安装包,拿着这个包去部署服务即可。需要注意的是在源码编译时:

1、需要主机配置GOPATH环境变量(一般可以配置为用户家家目录);

2、需要主机可以连接外网,通过go get下载相关源码包。

3、编译pack 出的包,在其他agent主机上部署时,无需连接外网 ,pack出的包,可以类似的理解为由c源代码编译后得出的二进制文件。

二、配置说明

配置文件必须叫cfg.json,可以基于cfg.example.json修改,默认该文件并不存在,通过./control start时自动会从cfg.example.json复制一份为cfg.json 。

{
"debug": true,
"hostname": "",
"ip": "",
"plugin": {
"enabled": false, # 默认不开启插件机制
"dir": "./plugin",
"git": "https://coding.net/ulricqin/plugin.git",
"logs": "./logs"
},
"heartbeat": {
"enabled": true, # 此处enabled要设置为true
"addr": "127.0.0.1:6030", # hbs的地址,端口是hbs的rpc端口
"interval": 60,
"timeout": 1000
},
"transfer": {
"enabled": true, # 此处enabled要设置为true
"addr": "127.0.0.1:8433", # transfer的地址,端口是transfer的rpc端口
"interval": 60,
"timeout": 1000
},
"http": {
"enabled": true,
"listen": ":1988"
},
"collector": {
"ifacePrefix": ["eth", "em"] # 默认配置只会采集网卡名称前缀是eth、em的网卡流量,配置为空就会采集所有的,lo的也会采集。可以从/proc/net/dev看到各个网卡的流量信息
},
"ignore": { # 默认采集了200多个metric,可以通过ignore设置为不采集
"cpu.busy": true,
"mem.swapfree": true
}
}
三、进程管理
./control start 启动进程
./control stop 停止进程
./control restart 重启进程
./control status 查看进程状态
./control tail 用tail -f的方式查看var/app.log

验证

看var目录下的log是否正常,或者浏览器访问其1988端口。另外agent提供了一个--check参数,可以检查agent是否可以正常跑在当前机器上。

./falcon-agent --check

/v1/push接口

该接口暂未用到,不过这里还是接官方wiki原话先摘录备忘下:“ 我们设计初衷是不希望用户直接连到Transfer发送数据,而是通过agent的/v1/push接口转发,接口使用范例 ”。

ts=`date +%s`; curl -X POST -d "[{\"metric\": \"metric.demo\", \"endpoint\": \"qd-open-falcon-judge01.hd\", \"timestamp\":
 $ts,\"step\": 60,\"value\": 9,\"counterType\": \"GAUGE\",\"tags\": \"project=falcon,module=judge\"}]" 
http://127.0.0.1:1988/v1/push

打开url  http://IP:1988可以查看相关监控信息,上张图(点击图片看大图):

这里要吐槽下,使用firefox和IE浏览器都可以正常查看该页面。使用360极速浏览器时无法正常查看该页面 ,好垃圾的浏览器。

open-falcon agent(独立该项目来讲)和之前介绍的linux-dash同属于可以查看单机当前信息状态的一个工具,不过open-falcon agent由于使用go语言的优势。在获取主机状态信息时,速度相当的快,资源占用也不好。赞一个。

原文来自:http://www.361way.com/open-falcon-agent/4546.html

本文地址:https://www.linuxprobe.com/open-falcon-agent.html编辑:张雄,审核员:逄增宝

本文原创地址:https://www.linuxprobe.com/open-falcon-agent.html编辑:问题终结者,审核员:暂无