python-zabbix

Very simple python module implementing Zabbix Sender protocol. You can find code in module subdir.

Install

With Debian:

apt-get install python-stdeb python-setuptools
cd module
python setup.py --command-packages=stdeb.command bdist_deb
apt-get install python-simplejson
dpkg -i deb_dist/python-zabbix_0.0.1-1_all.deb

From pip:

For now, protobix is only available from testpypip:

pip install -i https://testpypi.python.org/pypi protobix

Usage

Once module is installed, you can use it as follow

Send items as trappers

#!/usr/bin/env python''' import module '''importprotobix''' create DataContainer, providing data_type, zabbix server and port '''zbx_container=protobix.DataContainer("items", "localhost", 10051)
''' set debug '''zbx_container.set_debug(True)
zbx_container.set_verbosity(True)
''' Add items one after the other '''hostname="myhost"item="my.zabbix.item"value=0zbx_container.add_item( hostname, item, value)
''' or use bulk insert '''data= {
"myhost1": {
"my.zabbix.item1": 0,
"my.zabbix.item2": "item string"
},
"myhost2": {
"my.zabbix.item1": 0,
"my.zabbix.item2": "item string"
}
}
zbx_container.add(data)
''' Send data to zabbix '''ret=zbx_container.send(zbx_container)
''' If returns False, then we got a problem '''ifnotret:
print"Ooops. Something went wrong when sending data to Zabbix"print"Everything is OK"

Send Low Level Discovery as trappers

#!/usr/bin/env python''' import module '''importprotobix''' create DataContainer, providing data_type, zabbix server and port '''zbx_container=protobix.DataContainer("lld", "localhost", 10051)
''' set debug '''zbx_container.set_debug(True)
zbx_container.set_verbosity(True)
''' Add items one after the other '''hostname="myhost"item="my.zabbix.lld_item1"value=[
{ 'my.zabbix.ldd_key1': 0,
'my.zabbix.ldd_key2': 'lld string' },
{ 'my.zabbix.ldd_key3': 1,
'my.zabbix.ldd_key4': 'another lld string' }
]
zbx_container.add_item( hostname, item, value)
''' or use bulk insert '''data= {
'myhost1': {
'my.zabbix.lld_item1': [
{ 'my.zabbix.ldd_key1': 0,
'my.zabbix.ldd_key2': 'lld string' },
{ 'my.zabbix.ldd_key3': 1,
'my.zabbix.ldd_key4': 'another lld string' }
]
'myhost2':
'my.zabbix.lld_item2': [
{ 'my.zabbix.ldd_key10': 10,
'my.zabbix.ldd_key20': 'yet an lld string' },
{ 'my.zabbix.ldd_key30': 2,
'my.zabbix.ldd_key40': 'yet another lld string' }
]
}
zbx_container.add(data)
''' Send data to zabbix '''ret=zbx_container.send(zbx_container)
''' If returns False, then we got a problem '''ifnotret:
print"Ooops. Something went wrong when sending data to Zabbix"print"Everything is OK"