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也可以支持的。问题是拿到数据后展现的一方面。由于默认配置太差，因此需要很长时间调教。我没那个功夫，搞定测试后就直接删除了。