zabbixsender

Very simple python module implementing Zabbix Sender protocol.
It allows one to build list of items and send them as trapper. It currently supports items as well as Low Level Discovery.

Install

With pip:

pip install zabbixsender

Usage

Once module is installed, you can use it as follow

Send item as trappers

#!/usr/bin/env python

''' import module '''
from simplezabbixsender import Item

''' create Item, providing item_host, item_key, and item_value with option item_clock_value '''
item = Item(host = 'my_host', 
			key = 'trap.key[32]', 
			value = 3.3333, 
			clock=None)
result = item.send(server='172.0.0.1',
				   port=10051)
try:
	result.raise_for_failure()
except ZabbixTotalSendError:
	print 'failed to submit item'
else:
	print 'item submitted'
	
	
## Send multiple items

''' set dryrun for testing purpose. Won't send anything to Zabbix '''
zbx_container.dryrun = True

''' Add items one after the other '''
hostname="myhost"
item="my.zabbix.item"
value=0
zbx_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 '''
try:
    zbx_container.send()
except SendException as e:
    print str(e)

print "Everything is OK"

Send Low Level Discovery as trappers

#!/usr/bin/env python

''' import module '''
import zabbixsender

''' create DataContainer, providing data_type, zabbix server and port '''
zbx_container = zabbixsender.DataContainer(data_type = "lld",
                                       zbx_host  = '127.0.0.1',
                                       zbx_port  = 10051,
                                       debug     = False,
                                       dryrun    = False)
''' set debug '''
zbx_container.debug = 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': [
            { '{#ZBX_LLD_KEY11}': 0,
              '{#ZBX_LLD_KEY12}': 'lld string' },
            { '{#ZBX_LLD_KEY11}': 1,
              '{#ZBX_LLD_KEY12}': 'another lld string' }
        ]
    'myhost2':
        'my.zabbix.lld_item2': [
            { '{#ZBX_LLD_KEY21}': 10,
              '{#ZBX_LLD_KEY21}': 'yet an lld string' },
            { '{#ZBX_LLD_KEY21}': 2,
              '{#ZBX_LLD_KEY21}': 'yet another lld string' }
        ]
}
zbx_container.add(data)

''' Send data to zabbix '''
try:
    zbx_container.send()
except SendException as e:
    print str(e)

print "Everything is OK"