des726 / falcon-plus

An open-source and enterprise-level monitoring system.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool



Build Status codecov GoDoc Code Issues Go Report Card License Backers on Open Collective Sponsors on Open Collective



  • Git >= 1.7.5
  • Go >= 1.6

Getting Started


Please refer to ./docker/

Build from source

before start, please make sure you prepared this:

yum install -y redis
yum install -y mysql-server

NOTE: be sure to check redis and mysql-server have successfully started.

And then

# Please make sure that you have set `$GOPATH` and `$GOROOT` correctly.
# If you have not golang in your host, please follow [] to install golang.

mkdir -p $GOPATH/src/
cd $GOPATH/src/
git clone

And do not forget to init the database first (if you have not loaded the database schema before)

cd $GOPATH/src/
mysql -h -u root -p < 1_uic-db-schema.sql
mysql -h -u root -p < 2_portal-db-schema.sql
mysql -h -u root -p < 3_dashboard-db-schema.sql
mysql -h -u root -p < 4_graph-db-schema.sql
mysql -h -u root -p < 5_alarms-db-schema.sql

NOTE: if you are upgrading from v0.1 to current version v0.2.0,then. More upgrading instruction

mysql -h -u root -p < 5_alarms-db-schema.sql


cd $GOPATH/src/

# make all modules
make all

# make specified module
make agent

# pack all modules
make pack
  • after make pack you will got open-falcon-vx.x.x.tar.gz
  • if you want to edit configure file for each module, you can edit config/xxx.json before you do make pack

Unpack and Decompose

export WorkDir="$HOME/open-falcon"
mkdir -p $WorkDir
tar -xzvf open-falcon-vx.x.x.tar.gz -C $WorkDir
cd $WorkDir

Start all modules in single host

cd $WorkDir
./open-falcon start

# check modules status
./open-falcon check

Run More Open-Falcon Commands

for example:

# ./open-falcon [start|stop|restart|check|monitor|reload] module
./open-falcon start agent

./open-falcon check
        falcon-graph         UP           53007
          falcon-hbs         UP           53014
        falcon-judge         UP           53020
     falcon-transfer         UP           53026
       falcon-nodata         UP           53032
   falcon-aggregator         UP           53038
        falcon-agent         UP           53044
      falcon-gateway         UP           53050
          falcon-api         UP           53056
        falcon-alarm         UP           53063
  • For debugging , You can check $WorkDir/$moduleName/logs/xxx.log

Install Frontend Dashboard

NOTE: if you want to use grafana as the dashboard, please check this.

Package Management

We use govendor to manage the golang packages. Please install govendor before compilation.

go get -u

Most depended packages are saved under ./vendor dir. If you want to add or update a package, just run govendor fetch xxxx@commitID or govendor fetch xxxx@v1.x.x, then you will find the package have been placed in ./vendor correctly.

Package Release

make clean all pack

API Standard


  • Any issue or question is welcome, Please feel free to open github issues :)
  • FAQ


This project exists thanks to all the people who contribute. [Contribute].


An open-source and enterprise-level monitoring system.

License:Apache License 2.0


Language:Go 88.5%Language:Shell 4.0%Language:CSS 3.8%Language:HTML 1.6%Language:JavaScript 1.1%Language:Python 0.5%Language:Makefile 0.3%Language:Ruby 0.1%Language:Dockerfile 0.1%