转自:http://blog.youkuaiyun.com/wangli61289/article/details/45077795
Graphite是一个Django的项目,所以必须有基础的Python环境,并推荐使用pip作为Python模块的管理工具,我这里安装的Python版本是Python2.7.6。
按照Graphite官网(http://graphite.wikidot.com/installation)安装graphite依赖,特别强调Django的安装版本是Django1.5.x(1.6以上版本会有一些模块变更,导致不兼容)
1.安装graphite依赖
- yum install -y pycairo,mod_python,python-ldap,python-memcached,python-sqlite2,bitmap,bitmap-fonts,python-devel,mod_wsgi
- pip install Django==1.5.1
- pip install django-tagging
- pip install twisted
还有一个需要注意的地方就是默认安装的Twisted在这里不兼容,会导致报出:ImportError: cannot import name daemonize 这样的错误,而要解决这个问题,需要做的就是修正一下版本:
pip uninstall Twisted
pip install "Twisted<12.0"
可以使用pip freeze查看安装列表
2.安装Graphite的三个主要组件
2.1.安装whisper
- tar -zxvf whisper-0.9.12.tar.gz
- cd whisper-0.9.12
- python setup.py install
Whisper 脚本现在应该在应有的位置上:
- [root@VMS04798 graphite]# ls -l /usr/bin/whisper*
- -rwxr-xr-x 1 root root 1658 Apr 13 14:48 /usr/bin/whisper-create.py
- -rwxr-xr-x 1 root root 2902 Apr 13 14:48 /usr/bin/whisper-dump.py
- -rwxr-xr-x 1 root root 1780 Apr 13 14:48 /usr/bin/whisper-fetch.py
- -rwxr-xr-x 1 root root 1071 Apr 13 14:48 /usr/bin/whisper-info.py
- -rwxr-xr-x 1 root root 675 Apr 13 14:48 /usr/bin/whisper-merge.py
- -rwxr-xr-x 1 root root 5984 Apr 13 14:48 /usr/bin/whisper-resize.py
- -rwxr-xr-x 1 root root 919 Apr 13 14:48 /usr/bin/whisper-set-aggregation-method.py
- -rwxr-xr-x 1 root root 970 Apr 13 14:48 /usr/bin/whisper-update.py
2.2.安装carbon
- tar -zxvf carbon-0.9.12.tar.gz
- cd carbon-0.9.12
- python setup.py install
/opt/graphite 现在应该有carbon的lib 包和配置文件:
- [root@VMS04798 graphite]# ls -l /opt/graphite
- total 48
- drwxr-xr-x 2 apache apache 4096 Apr 13 14:48 bin
- drwxrwxrwx 2 apache apache 4096 Apr 15 18:34 conf
- drwxr-xr-x 2 apache apache 4096 Apr 13 15:40 examples
- drwxr-xr-x 4 apache apache 4096 Apr 13 14:47 lib
- drwxr-xr-x 6 apache apache 4096 Apr 15 16:19 storage
2.3.安装graphite-web
- tar -zxvf graphite-web-0.9.12.tar.gz
- cd graphite-web-0.9.12
- python check-dependencies.py
- python setup.py install
修改配置:
- cp graphite.wsgi.example graphite.wsgi
- cd /opt/graphite/webapp/graphite
- cp local_settings.py.example local_settings.py
编辑local_settings.py,务必重新设置SECRET_KEY,根据需要调整TIME_ZONE(TIME_ZONE='Asia/Shanghai')和其它参数。
3.启动一个Carbon进程
Carbon安装自带了默认的端口和很多其他的配置文件,拷贝已经存在的示例文件。
- cd /opt/graphite/conf
- cp carbon.conf.example carbon.conf
- cp storage-schemas.conf.example storage-schemas.conf
- cp storage-aggregation.conf.example storage-aggregation.conf
编辑carbon.conf,并添加以下内容:
- $ vim /opt/graphite/conf/carbon.conf
- [cache]
- LINE_RECEIVER_INTERFACE = 0.0.0.0
- LINE_RECEIVER_PORT = 2003
- PICKLE_RECEIVER_INTERFACE = 0.0.0.0
- PICKLE_RECEIVER_PORT = 2004
- CACHE_QUERY_INTERFACE = 0.0.0.0
- CACHE_QUERY_PORT = 7002
编辑storage-schemas,并添加以下内容:
- vim storage-schemas.conf
- [system_1min]
- pattern = ^system\..*
- priority = 100
- retentions = 60s:31d,5m:90d
编辑storage-aggregation.conf,并添加以下内容:
- vim storage-aggregation.conf
- [system_1min]
- pattern = ^system\..*
- xFilesFactor = 0.5
- aggregationMethod = sum
如果我们的Whisper文件xFilesFactor值是0.5,这意味着仅仅只有至少50%数据点被呈现的时候,它才将聚集数据点。如果超过50%数据点是null,Whisper将创建一个null聚合。在我们的示例中(60s=1m)5m/1m=5也即至少有3个点才开始聚合,因为3/5=0.6才满足xFilesFactor=0.5的聚合条件。你可以给xFilesFactor设置0-1之间的任何值。0表明了即使只有一个数据点非空,聚合就应该被完成。1 表明了只有所有的数据非空,集合才能完成。
4.制造一些测试数据
- cd /opt/graphite/bin
- ./carbon-cache.py start
- cd /opt/graphite/examples
- python example-client.py
最后,你可以检索关于 Whisper 文件的元数据信息,使用 whisper-info 脚本:
- [root@VMS04798 examples]# whisper-info.py /opt/graphite/storage/whisper/system/loadavg_1min.wsp
- maxRetention: 604800
- xFilesFactor: 0.5
- aggregationMethod: sum
- fileSize: 120988
- Archive 0
- retention: 604800
- secondsPerPoint: 60
- points: 10080
- size: 120960
- offset: 28
whisper-dump脚本是一个更完整的脚本,其可以输出所有存储保留时期的原始数据以及关于 Whisper 文件的元数据信息:
- [root@VMS04798 examples]#whisper-dump.py /opt/graphite/storage/whisper/system/loadavg_1min.wsp
- Meta data:
- aggregation method: sum
- max retention: 86400
- xFilesFactor: 0.5
- Archive 0 info:
- offset: 28
- seconds per point: 60
- points: 1440
- retention: 86400
- size: 17280
- Archive 0 data:
- 0: 1400609220, 1
- 1: 0, 0
- 2: 0, 0
- 3: 0, 0
- 4: 0, 0
- 5: 0, 0
- ...
- 1437: 0, 0
- 1438: 0, 0
- 1439: 0, 0
如果Metrics与storage-aggregation.conf中的pattern没有匹配上,默认的aggregation方法是average,xFilesFactor=0.5
5.安装nginx与uwsgi
graphite-web是基于django开发的
5.1 nginx安装
- tar -zxvf nginx-1.2.8.tar.gz
- cd nginx-1.2.8
- ./configure --prefix=/usr/local/nginx
- make
- make install
5.2 uwsgi安装
- pip install uwsgi
配置uwsgi:
- /opt/graphite/webapp
- vim graphite.ini
uWSGI的配置如下:
- [uwsgi]
- post-buffering = 32768
- buffer-size = 32768
- chdir=/opt/graphite/conf/
- module=graphite.wsgi
- master=true
- pidfile=/tmp/graphite.pid
- vacuum=true
- max-requests=10000
- daemonize=/var/log/graphite/access_graphite.log
- processes=15
- socket=127.0.0.1:49156
- stats=127.0.0.1:1716
- listen=1024
配置Nginx:
- cd /usr/local/nginx/conf/sites-enabled
- vim graphite.conf
以下是Nginx虚拟主机的配置
- server {
- listen 8080;
- server_name 127.0.0.1
- charset utf-8;
- access_log /var/log/nginx/graphite.access.log;
- error_log /var/log/nginx/graphite.error.log;
- location / {
- include uwsgi_params;
- uwsgi_pass 127.0.0.1:49156;
- }
- }
7.启动graphite
至此所有全部搞定,先开carbon,再开uwsgi,最后nginx。
- /opt/graphite/bin/carbon-cache.py start
- /opt/graphite/webapp
- uwsgi graphite.ini
- /usr/local/nginx/sbin/nginx
打开浏览器,输入http://ip:8080就能看到效果了。
参考文档:
http://segmentfault.com/a/1190000002533877
http://segmentfault.com/a/1190000002573509