open-falcon agent安装使用

2015年6月17日 发表评论 阅读评论

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可以查看相关监控信息,上张图(点击图片看大图):

xiaomi-agent

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

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




本站的发展离不开您的资助,金额随意,欢迎来赏!

You can donate through PayPal.
My paypal id: itybku@139.com
Paypal page: https://www.paypal.me/361way

分类: 未分类 标签: ,
  1. 本文目前尚无任何评论.
  1. 本文目前尚无任何 trackbacks 和 pingbacks.