Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/open-falcon/dashboard

falcon-plus frontend
https://github.com/open-falcon/dashboard

data-visualization falcon monitoring open-falcon

Last synced: about 3 hours ago
JSON representation

falcon-plus frontend

Awesome Lists containing this project

README 

        
## Introduction



dashboard is the Open-Falcon unified default frontend component, including:



- user-defined dashboard and screen.

- configure managent of alerting, hostgroup, template. 

- alerting history managent and display.

- team management.

- combine the multiple alerting.

- user management, such as login, logout, register, ldap_login, etc.



Open-Falcon homepage：[http://open-falcon.org](http://open-falcon.org)



## Demo site

- [dashboard demo](http://116.85.44.234:8081/), user:`test`, password:`test123`



## i18n

Open-Falcon natively support zh_CN and currently partially support English. Any translation will be appreciated.



[How to participate in the translation](./i18n.md)



## Run in docker

- [run dashboard in docker container](https://github.com/open-falcon/falcon-plus/blob/master/docker/README.md)



## Clone & Prepare

```

export HOME=/home/work/



mkdir -p $HOME/open-falcon/

cd $HOME/open-falcon && git clone https://github.com/open-falcon/dashboard.git

cd dashboard;



```



## Install dependency



- **CentOS**



```

yum install -y python-virtualenv

yum install -y python-devel

yum install -y openldap-devel

yum install -y mysql-devel

yum groupinstall "Development tools"



cd $HOME/open-falcon/dashboard/

virtualenv ./env



./env/bin/pip install -r pip_requirements.txt

```



- **Ubuntu**



```

apt-get install -y python-virtualenv

apt-get install -y slapd ldap-utils

apt-get install -y libmysqld-dev

apt-get install -y build-essential

apt-get install -y python-dev libldap2-dev libsasl2-dev libssl-dev



cd $HOME/open-falcon/dashboard/

virtualenv ./env



./env/bin/pip install -r pip_requirements.txt

```



## Init database

```

cd /tmp/ && git clone https://github.com/open-falcon/falcon-plus.git 

cd /tmp/falcon-plus/scripts/mysql/db_schema/

mysql -h 127.0.0.1 -u root -p < 1_uic-db-schema.sql

mysql -h 127.0.0.1 -u root -p < 2_portal-db-schema.sql

mysql -h 127.0.0.1 -u root -p < 3_dashboard-db-schema.sql

mysql -h 127.0.0.1 -u root -p < 4_graph-db-schema.sql

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

rm -rf /tmp/falcon-plus/

```



**if you are upgrading from v0.1 to version v0.2.0(or above),then**



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



## Configure



The open-falcon modules' configuration files is `path/to/open-falcon-binaries//config/cfg.json`, change them if necessary.



**MAKE SURE** Open-falcon api module is up running and works as expcted before start dashboard.



    dashboard config file is 'rrd/config.py', change it if necessary.



    ## set API_ADDR to your falcon-plus api modules addr, default value as bellow:

    API_ADDR = "http://127.0.0.1:8080/api/v1" 



    ## set PORTAL_DB_* if necessary, default mysql user is root, default passwd is ""

    ## set ALARM_DB_* if necessary, default mysql user is root, default passwd is ""

    ## if following error msg occurred, please check DB config in rrd/config.py

    

    Error 'NoneType' object has no attribute 'cursor'



## Start in debug mode



    $ source ./env/bin/python wsgi.py

    $ export FLASK_ENV=development

    $ flask run --host=0.0.0.0 --port=8081



    open http://127.0.0.1:8081 in your browser.



## Run with gunicorn in production mode



    $ bash control start



    open http://127.0.0.1:8081 in your browser.



## Stop gunicorn



    $ bash control stop



## Check log



    $ bash control tail



## Screenshots









 

## Mailing lists



- [openfalcon-users](https://groups.google.com/forum/#!forum/openfalcon-users) – for discussions around openfalcon usage and community support

- [openfalcon-developers](https://groups.google.com/forum/#!forum/openfalcon-developers) – for discussions around openfalcon development



## Issue tracker



We are using the [github issue tracker](https://github.com/open-falcon/falcon-plus/issues) for the various Open-Falcon repositories to fix bugs and features request. If you need support, please send your questions to the [openfalcon-users](https://groups.google.com/forum/#!forum/openfalcon-users) mailing list rather than filing a GitHub issue.



Please do not ask individual project members for support. Use the channels above instead, where the whole community can help you and benefit from the solutions provided. If community support is insufficient for your situation, please refer to the Commercial Support section below.



## Contributing

We welcome community contributions! Open-Falcon uses GitHub to manage reviews of pull requests.



If you have a trivial fix or improvement, go ahead and create a pull request, addressing (with `@...`) the maintainer of this repository in the description of the pull request.



If you plan to do something more involved, first discuss your ideas on our mailing list. This will avoid unnecessary work and surely give you and us a good deal of inspiration.



## Acknowledgements



Open-Falcon was initially started by Xiaomi and we would also like to acknowledge early contributions by engineers from these companies.



[Wei Lai](https://github.com/laiwei) is the founder of Open-Falcon software and community. 



The Open-Falcon logo and website were contributed by Cepave Design Team.