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語言的優勢。在獲取主機狀態信息時，速度相當的快，資源占用也不好。贊一個。