OpenStack监控测量服务Ceilometer安装及 API说明

1.Ceilometer是作什么的

Ceilometer是OpenStack中的一个子项目，它像一个漏斗同样，能把OpenStack内部发生 的几乎全部的事件都收集起来，而后为计费和监控以及其它服务提供数据支撑。Ceilometer的核心架构图



2.OpenStack监控测量服务Ceilometer安装


2.1 到github下载最新的ceilometer代码

2.2安装mongodb， 因为ceilometer采用mongodb做为默认数据持久化数据库，因此须要先安装mongodb

apt-get install mongodb

2.3在keystone中添加ceilometer用户

需注意：添加的ceilometer帐户须要属于admin tenant不然会出现不能获取实例监控信息的状况，而且将此帐户添加为ResellerAdmin角色中便于获取swift监控信息。 添加的ceilometer帐户须要属于admin tenant，而且角色为ResellerAdmin以及Admin。

查看user列表

keystone --os-username admin --os_password pass --os_tenant_name admin --os_auth_url http://localhost:5000/v2.0 user-list


查看role列表

keystone --os-username admin --os_password pass --os_tenant_name admin --os_auth_url http://localhost:5000/v2.0 role-list


查看tanant列表

keystone --os-username admin --os_password pass --os_tenant_name admin --os_auth_url http://localhost:5000/v2.0 tenant-list


新建user

keystone --os-username admin --os_password pass --os_tenant_name admin --os_auth_url http://localhost:5000/v2.0 user-create --name ceilometer --email co@co.cn --tenant-id tid --pass pass --enabled true


添加user角色

keystone --os-username admin --os_password pass --os_tenant_name admin --os_auth_url http://localhost:5000/v2.0 user-role-add --user-id uid --tenant-id tid --role-id rid

2.4安装ceilometer

1)首先查看模块所依赖的包

vim ceilometer/requirements.txt

1. d2to1>=0.2.10,<0.3
   

2. pbr>=0.5,<0.6
   

3. WebOb>=1.2
   

4. kombu
   

5. iso8601
   

6. argparse
   

7. SQLAlchemy>=0.7,<=0.7.99
   

8. sqlalchemy-migrate>=0.7.2
   

9. pymongo>=2.2
   

10. eventlet
    

11. anyjson>=0.2.4
    

12. Flask==0.9
    

13. pecan>=0.2.0
    

14. stevedore>=0.7
    

15. msgpack-python
    

16. python-glanceclient
    

17. python-novaclient>=2.6.10
    

18. python-keystoneclient>=0.2.3
    

19. python-swiftclient
    

20. lxml
    

21. requests>=1.1
    

22. wsme>=0.5b2
    

23. pyyaml
    

24. oslo.config>=1.1.0
    

25. happybase>=0.4

复制代码

此版本ceilometer使用G版本Openstack中新加的oslo.config模块完成配置文件读取模块。

此外要求WebOb的版本要在1.2以上，查看F版本Openstack使用的此库版本为1.0.8，这是比较大的冲突，而且发现有不少人反映此库与以前的库不兼容的状况（https://bugs.launchpad.net/ceilometer/+bug/1092227），在我实际的安装过程当中也发现此库不能被python-novaclient, python-glanceclient等库所使用。因而我使用virtualenv（https://pypi.python.org/pypi/virtualenv）创建了一个隔离的python环境来安装运行ceilometer及相关依赖。




2)安装virtualenv并创建隔离沙箱

sudo pip install virtualenv #安装

virtualenv grizzlyenv #创建名为grizzlyenv的隔离环境

source grizzlyenv/bin/activate #进入grizzlyenv隔离环境

进入后在提示符前会出现提示，如  

(grizzlyenv)root@ceilotest:/opt#

在此环境下，有一套独立于全局python的环境，在此使用pip和easy_install安装python包均可以不影响全局的python环境，使用完毕以后使用deactivate命令便可退出到全局环境，相关的使用方法在网上均可以找到，在此不赘述




3)隔离环境安装完毕以后，就可以在这之中安装ceilometer了

#cd ceilometer

#python setup.py develop

安装完以后能够看到所依赖的包都安装在了grizzlyenv/lib/python2.7/site-packages/ 路径之下。

将ceilometer/etc/ceilometer/下全部文件拷贝到/etc/ceilometer/目录下（没有则新建），并将其中ceilometer.conf.sample文件修改成：

ceilometer.conf

1. [DEFAULT]
   

2. verbose=True
   

3. debug=True
   

4. os_auth_url = http://192.168.5.202:35357/v2.0
   

5. os_tenant_name = admin
   

6. os_password = admin
   

7. os_username = ceilometer
   

8. policy_file = /etc/ceilometer/policy.json
   

9. notification_topics = notifications,glance_notifications
   

10. rabbit_password = admin
    

11. rabbit_host = 127.0.0.1
    

12. rabbit_max_retries = 10
    

13. rpc_backend = ceilometer.openstack.common.rpc.impl_kombu
    

14. 
    

15. [keystone_authtoken]
    

16. signing_dir = /etc/ceilometer
    

17. admin_tenant_name = admin
    

18. admin_password = admin
    

19. admin_user = ceilometer
    

20. auth_protocol = http

复制代码

4) 启动ceilometer

在screen中开启四个选项卡，依次运行：

ceilometer-collector

ceilometer-agent-central

ceilometer-agent-compute

ceilometer-api

分别对应ceilometer架构中的四个重要模块，在ceilometer-agent-compute启动的过程当中可能会出现No module named libvirt的问题，这是由于隔离环境中没有安装python-libvirt的缘故，可是同时发现没法使用pip来安装此库，可是使用dpkg -l命令查看是发现python-libvirt的确已经安装，因而直接将全局环境中的相关文件拷贝到隔离环境中来并修改相应权限：

cp /usr/lib/python2.7/dist-packages/libvirt* /opt/stack/grizzlyenv/lib/python2.7/site-packages/


chown stack:stack /opt/stack/grizzlyenv/lib/python2.7/site-packages/libvirt*

这样应该就可以正常启动了，启动以后能够到mongodb中查看相应的数据记录。



3.OpenStack监控测量服务Ceilometer  API说明3.API3.1 Resources资源获取资源的信息。   GET           http://HOST:8777/v2/resources 列出全部资源的定义。 GET           http://HOST:8777/v2/resources/{resource_id} 获取指定的资源的详细信息。 3.2 Meters计量获取计量信息。   GET           http://HOST:8777/v2/meters 到目前为止的计量数据列表。   GET           http://HOST:8777/v2/meters/{meter_id} 获取指定ID的计量信息。   POST         http://HOST:8777/v2/meters/{meter_id} 更新指定ID的计量信息列表。   GET           http://HOST:8777/v2/meters/{meter_id}/statistics 计算在指定的时间范围内的样本的统计信息。 3.3 Alarms告警列表，建立，获取详细信息，更新和删除报警。   GET           http://HOST:8777/v2/alarms 根据指定查询，列出了警报。   POST         http://HOST:8777/v2/alarms 建立一个报警。   GET           http://HOST:8777/v2/alarms/{alarm_id} 获取指定ID的报警信息。   PUT           http://HOST:8777/v2/alarms/{alarm_id} 更新指定ID的报警。   PUT           http://HOST:8777/v2/alarms/{alarm_id}/state 设置一个指定ID的报警状态。   GET           http://HOST:8777/v2/alarms/{alarm_id}/state 获取指定ID的报警状态。   GET           http://HOST:8777/v2/alarms/{alarm_id}/history 组装指定ID的报警历史记录。