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的報警歷史記錄。