Ganglia Python外掛程式編寫過程筆記

一、Gmond擴充Python度量模組
 官方：http://sourceforge.net/apps/trac/ganglia/wiki/ganglia_gmond_python_modules
 官方文檔中文版：

尋找本地gmond是否安裝
 # netstat -ano | grep 8649
 或者
 # talnet localhost 8649
 

尋找gmond動態連結程式庫檔案路徑
 # locate */ganglia/*.so
 /opt/ganglia/lib/python/gmon/Gmetricmodule.so
 /opt/ganglia/lib/python/gmon/Networkmodule.so
 /opt/ganglia/lib/python/gmon/Processmodule.so
 /usr/local/lib64/ganglia/modcpu.so
 /usr/local/lib64/ganglia/moddisk.so
 /usr/local/lib64/ganglia/modload.so
 /usr/local/lib64/ganglia/modmem.so
 /usr/local/lib64/ganglia/modmulticpu.so
 /usr/local/lib64/ganglia/modnet.so
 /usr/local/lib64/ganglia/modproc.so
 /usr/local/lib64/ganglia/modpython.so
 /usr/local/lib64/ganglia/modsys.so
 # cd /usr/local/lib64/ganglia/
 modcpu.so  moddisk.so  modload.so  modmem.so  modmulticpu.so  modnet.so  modproc.so  modsys.so
 

安裝 ganglia-python-3.3.0-1.x86_64.rpm
 # rpm -ivh ganglia-python-3.3.0-1.x86_64.rpm
 # cd /usr/local/lib64/ganglia/
 # ls
 modcpu.so  moddisk.so  modload.so  modmem.so  modmulticpu.so  modnet.so  modproc.so  modpython.so  modsys.so  python_modules
 modpython.so 和 python_modules目錄在安裝ganglia-python後產生
 
擴充Python度量模組完成 

二、開發python模組
 尋找python模組設定檔存放路徑
 # vim /etc/ganglia/gmond.conf
 /include 搜尋，一般會有如下格式的一行，該目錄即為存放路徑，如沒有這行，手動添加一行
 include ("/usr/local/etc/conf.d/*.conf")
 
建立設定檔foo.conf，讓gmond知道這裡有ganglia外掛程式
 # cd /usr/local/etc/conf.d
 # vim foo.conf
 粘貼下面的配置代碼
 modules {
  module {
    name = "foo"                  #模組名，該檔案存放於params = "/usr/lib64/ganglia/python_modules"指定的路徑下
    language = "python"        #聲明使用python語言
    params = "/usr/local/lib64/ganglia/python_modules"  #指定編寫的python指令碼置放位置，可不寫用預設
  }
 }
 

collection_group {
  collect_every = 60
  time_threshold = 60
  metric {
    name = "foo_count"          #python主模組名稱
    title = "Foo Count"            #動態庫路徑
    value_threshold = 1.0        #編寫的python指令碼置放位置
  }
 }
 

編寫自訂Python模組
 # cd /usr/local/lib64/ganglia/python_modules
 # vim foo.py

粘貼以下代碼：

#coding=utf-8
import random
def  get_foo_count(name):
    '''可定製業務方法，返回一個整數值'''
    return random.randrange(5, 100) + 10

def metric_init(params):
    '''metric'''
    global descriptors
   
    d1 = {
        'name': 'foo_count',
        'call_back': get_foo_count,                  # 名字同業務方法一致
        'time_max': 90,                                  # 最大調度間隔時間
        'value_type': 'uint',
        'units': 'C',
        'slope': 'both',
        'format': '%u',
        'description': 'Number of Foo',
        'groups': 'foo_group'
        }
    descriptors = [d1]
    return descriptors

def metric_cleanup():
    "清除metric"

if __name__ == '__main__':
    metric_init({})
    for d in descriptors:
        v = d['call_back'](d['name'])
        print 'value for %s is %u' % (d['name'], v)

三、重啟gmond

 # /etc/init.d/gmond restart