Dashboard

dashboard是面向用户的查询界面。在这里，用户可以看到push到graph中的所有数据，并查看其趋势图。

依赖安装

Dashboard是个Python的项目。安装&部署Dashboard时，需要安装一些依赖库。依赖库安装，步骤如下，

  1. # 安装virtualenv。需要root权限。
  2. yum install -y python-virtualenv
  4. # 安装依赖。不需要root权限、使用普通账号执行就可以。需要到dashboard的目录下执行。
  5. cd /path/to/dashboard/ 
  6. virtualenv ./env
  7. ./env/bin/pip install -r pip_requirements.txt

对于ubuntu用户，安装mysql-python时可能会失败。请自行安装依赖libmysqld-dev、libmysqlclient-dev等。

服务部署

部署dashboard，包括配置修改、启动服务、停止服务等。在此之前，需要进入dashboard的部署目录，然后执行下列步骤

  1. # 修改配置。各配置的含义，见下文。
  2. vim ./gunicorn.conf
  3. vim ./rrd/config.py
  5. # 启动服务
  6. ./control start
  8. # 校验服务
  9. # TODO
  11. ...
  12. # 停止服务
  13. ./control stop

服务启动后，可以通过日志查看服务的运行状态，日志文件地址为./var/app.log。可以通过http://localhost:8081访问dashboard主页(这里假设 dashboard的http监听端口为8081)。

配置说明

dashboard有两个需要更改的配置文件: ./gunicorn.conf 和 ./rrd/config.py。./gunicorn.conf各字段，含义如下

  1. - workers,dashboard并发进程数
  2. - bind,dashboard的http监听端口
  3. - proc_name,进程名称
  4. - pidfile,pid文件全名称
  5. - limit_request_field_size,TODO
  6. - limit_request_line,TODO

配置文件./rrd/config.py，各字段含义为

  1. # dashboard的数据库配置
  2. DASHBOARD_DB_HOST = "127.0.0.1"
  3. DASHBOARD_DB_PORT = 3306
  4. DASHBOARD_DB_USER = "root"
  5. DASHBOARD_DB_PASSWD = ""
  6. DASHBOARD_DB_NAME = "dashboard"
  8. # graph的数据库配置
  9. GRAPH_DB_HOST = "127.0.0.1"
  10. GRAPH_DB_PORT = 3306
  11. GRAPH_DB_USER = "root"
  12. GRAPH_DB_PASSWD = ""
  13. GRAPH_DB_NAME = "graph"
  15. # dashboard的配置
  16. DEBUG = True
  17. SECRET_KEY = "secret-key"
  18. SESSION_COOKIE_NAME = "open-falcon"
  19. PERMANENT_SESSION_LIFETIME = 3600 * 24 * 30
  20. SITE_COOKIE = "open-falcon-ck"
  22. # query服务的地址
  23. QUERY_ADDR = "http://127.0.0.1:9966"
  25. BASE_DIR = "/home/work/open-falcon/dashboard/"
  26. LOG_PATH = os.path.join(BASE_DIR,"log/")
  28. try:
  29.     from rrd.local_config import *
  30. except:
  31.     pass

补充说明

Dashboard正常启动之后，就可以回去配置Fe这个项目的shortcut了。省得以后还要单独输入ip:port来打开dashboard。修改完了shortcut，要重启fe模块。