Shell's Home

Jul 9, 2012 - 1 minute read - Comments

debian wheezy下以uwsgi安装graphite

abstract

graphite是一个python写的性能监控系统。这个系统是由多个分离的部分组成的。

  • graphite-web: 由django写的web界面系统。
  • carbon: 数据收集的守护进程。
  • whisper: 一种python写的数据库,类似rrd,便于大量的性能日志数据收集和处理。上两个组件会调用这个库。
  • collectd: 数据收集守护进程,向carbon中喂数据的数据源。

另外,有一点黑色幽默的就是,graphite的意思是石墨,是炭(carbon)的一种同素异形体。因此在graphite项目中,多次出现carbon这个名字。当然,另两个同素异形体是钻石(diamond)和足球烯(footballene),你就暂时别指望看到他们的身影了。

另一个用python写的,以元素命名的著名软件是mercurial。化学元素中的汞,俗称水银,符号hg。因此mercurial的命令行简写才是hg。

以上几个的结构大概是这样的:

collectd(source) -network-> carbon -> writing-> whisper

database -> reading-> graphite-web

下文描述了在debian wheezy下,以nginx+uwsgi模式安装graphite的过程。之所以用这个模式,是因为我的大部分系统都是python写的,同样安装在uwsgi下面。一事不烦二主。

carbon

carbon有对应的debian包,可以很简单的安装。

sudo aptitude install graphite-carbon

默认的数据端口是2003,默认的数据路径是/var/lib/graphite/,这个在下文需要用到。

graphite

virtual

graphite有部分需要安装到系统中,因此最好用virtualenv进行安装。

cd /var/web/
sudo aptitude install python-virtualenv
virtualenv --system-site-packages graphite

我假定你的安装路径是/var/web/graphite,这个在下面要反复用到。

install

在安装路径下,执行以下内容

source bin/activite
pip install graphite-web --install-option="--prefix=/var/web/graphite" --install-option="--install-lib=/var/web/graphite/webapp"

注意,/var/web/graphite需要根据上面的设定自行修改,webapp是你的django基础路径。

configure

在/var/web/graphite/webapp/graphite下面,执行以下内容

cp local_settings.py.example local_settings.py

然后编辑local_settings.py

GRAPHITE_ROOT = '/var/web/graphite'
WHISPER_DIR = '/var/lib/graphite/whisper'
DATABASES = ...

注意databases,不要在settings.py里面修改,要改这里的才有效。我用的是sqlite,如果你高兴,可以改为postgres/mysql。WHISPER_DIR是上文carbon中设定的目录。

最后,执行以下指令,完成数据库初始化。

python manage.py syncdb

uwsgi

编辑/etc/uwsgi/apps-enabled/graphite.ini,包含以下内容。

[uwsgi]
plugins = python
workers = 1
chdir = /var/web/graphite/webapp
pythonpath = /var/web/graphite
env = DJANGO_SETTINGS_MODULE=graphite.settings
module = django.core.handlers.wsgi:WSGIHandler()

注意,这里的chdir,是你的webapp基础路径。而pythonpath则是virtualenv的路径。两者在上文都有说明的。env里面那个graphite是webapp/graphite这个app(不详细说明,自己学一下django就懂了)。module是django的固定写法。

nginx

最后,在nginx中包含以下内容,将部分url转发到uwsgi上。

location ~ ^/(graphite|content|metrics|dashboard|render|browser|composer)/ {
    include uwsgi_params;
    uwsgi_param  UWSGI_SCHEME $scheme;
    uwsgi_pass unix:/run/uwsgi/app/graphite/socket;
}

collectd

install

collectd的安装很简答,有包,直接安装就好。

sudo aptitude install collectd

configure

在/etc/collectd/这个路径,能够看到collectd.conf这个文件。反注释掉以下内容:

<LoadPlugin python>
    Globals true
</LoadPlugin>

然后,再编辑以下内容。

<Plugin python>
    ModulePath "/etc/collectd/carbon"
    Import “carbon_writer”
    <Module “carbon_writer”>
        LineReceiverHost “localhost″
        LineReceiverPort 2003
        DifferentiateCountersOverTime true
        LowercaseMetricNames true
        TypesDB "/usr/share/collectd/types.db"
    </Module>
</Plugin>

上文中假定你把python插件放在了/etc/collectd/carbon下面,所以下文需要按照这个路径安装carbon。

collectd-carbon

在/etc/collectd下面,执行

sudo git clone https://github.com/indygreg/collectd-carbon.git carbon

注意,sudo其实是不安全的。不过目前就这样吧,问题不明显。

restart whole system

执行以下指令重启服务

sudo /etc/init.d/nginx restart
sudo /etc/init.d/uwsgi restart
sudo /etc/init.d/carbon-cache restart
sudo /etc/init.d/collectd restart

完成这步后,可以在/var/log/syslog中看到collectd的输出,数据确实的被灌入了carbon。而/var/log/uwsgi/app/graphite.log中可以看到uwsgi的输出。如果一切正常的话,你可以去http://localhost/graphite/下面看你要的东西了。

评价

数据收集的挺完整的。既然是基于collectd,那么应当没什么问题的,openwrt也可以支持的。问题是拿到数据后展现的一方面。由于默认配置太差,因此需要很长时间调教。我没那个功夫,搞定测试后就直接删除了。