• dev Branch:
• upstream Branch (default):

python-protobix is a very simple python module implementing Zabbix Sender protocol 2.0.
It allows to build list of Zabbix items and send them as trappers.

Currently python-protobix supports items as well as Low Level Discovery.

Please note that python-protobix is developped and tested on Debian GNU/Linux only.
I can't enforce compatibility with other distributions, though it should work on any distribution providing Python 2.7 or Python 3.x.

Any feedback on this is, of course, welcomed.

To install all required dependencies and launch test suite

python setup.py test

By default, all tests named like *need_backend* are disabled, since they need a working Zabbix Server.

If you want to run theses tests as well, you will need:

• a working Zabbix Server 3.x configuration file like the one in tests/zabbix/zabbix_server.conf
• SQL statements in tests/zabbix/zabbix_server_mysql.sql with all informations to create testing hosts & items

You can then start Zabbix Server with zabbix_server -c tests/zabbix/zabbix_server.conf -f and launch test suite with

py.test --cov protobix --cov-report term-missing

You can also use docker to run test suite on any Linux distribution of your choice.
You can use provided script docker-tests.sh as entrypoint example:

docker run --volume=$(pwd):/home/python-protobix --entrypoint=/home/python-protobix/tests/docker-tests.sh -ti debian:jessie

Please note that this docker entrypoint does not provide a way to execute test that need a backend.

With pip (stable version):

pip install protobix

With pip (test version):

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

Python is available as Debian package for Debian GNU/Linux sid and testing.

Once module is installed, you can use it as follow

python-protobix provides a convenient sample probe you can extend to fit your own needs.

Using protobix.SampleProbe allows you to concetrate on getting metrics or Low Level Discovery items without taking care of anything related to protobix itself.
This is the recommanded way of using python-protobix.

protobix.SampleProbe provides a run methods which take care of everything related to protobix.

Some probes are available from my Github repository python-zabbix

#!/usr/bin/env python

''' import module '''
import protobix

print "Everything is OK"

#!/usr/bin/env python

''' import module '''
import protobix

print "Everything is OK"

You can contribute to protobix:

• fork this repository
• write tests and documentation
• implement the feature you need
• open a pull request against upstream branch