/zbx

Zabbix command line interface for ops

Primary LanguagePython

zbx

Zabbix command line interface Python2.7 & Python3.5 tested

Sponsor

Developed with the support and help of BlaBlaCar.

BlaBlaCar is trusted community marketplace that connects drivers with empty seats to passengers looking for a ride. Hoping to give them an effective tool

Requirement

Install

Example based on a debian linux box.

Python2

For test & dev

  • Install pip apt-get install python-pip
  • Upgrade pip easy_install -U pip
  • Install ConfigParser pip install ConfigParser
  • Install Logging pip install logging
  • Rename config.ini.example to config.ini
  • Add server url, login and password in config.ini
  • Run pip3 install --editable .

Easy way

  • run python2 setup.py install

Python3

For test & dev

  • Install python 3 apt-get install python3
  • Install pip3 apt-get install python3-pip
  • Upgrade pip3 easy_install3 -U pip
  • Rename config.ini.example to config.ini
  • Add server url, login and password in config.ini
  • Run pip3 install --no-cache-dir --editable .

Easy way

  • run python3 setup.py install

Configuration

Default

  • Look config.ini.example for example
  • Create a config.ini like config.ini.example

Option

  • Set environment variable ZBX_CONF_FILE with the config name file

Tests

Install Test

  • run cd ~ + wich zbx
  • run zbx --versionfrom any where in your filesystem tree

Dev Test

  • Install pytest pip3 search pytest
  • Install pytest-cov pip3 install pytest-cov
  • Run pytest zbx_test.py --cov=zbx.py

Python2

  • pip install pytest
  • pip install pytest-cov
  • Run pytest test.py --cov=zbx.py

Python3

  • pip3 install pytest
  • pip3 install pytest-cov
  • Run pytest test.py --cov=zbx.py

Command

  • zbx group list : List all server group in the zabbix server
  • zbx group show GROUP_NAME: List every host in a specific group
  • zbx alert list : All alert currently up
  • zbx alert history : List all reported issues with a alert send to current user
  • zbx alert ack EVEN-ID MESSAGE : Acknowledge a alert
  • zbx host add FQDN : Delete a host in zabbix server (FQDN must be a true record dns)
  • zbx host del FQDN : Delete a host in zabbix server
  • zbx host notemplate : List all host without template (and thus not monitored)
  • zbx host template FQDN : List templates for a particular host
  • zbx host linktemplate FQDN TEMPLATE : Link particular template to particular host
  • zbx maintenance add FQDN DURATION : Create a dedicated maintenance for a particular host
  • zbx maintenance del FQDN DURATION : Delete a dedicated maintenance for a particular host
  • zbx maintenance list : List all maintenance present, expired or not
  • zbx maintenance gc : Delete all expired ("Active till date time" is exceeded) maintenance
  • zbx monitor enable FQDN : Enable monitoring for a host in zabbix server
  • zbx monitor disable FQDN : Disable monitoring for a host in zabbix server
  • zbx unmonitored : List all host with monitoring disable in zabbix server
  • zbx items get ITEM.KEY --group GROUP_NAME: List the last item value for the item.key provided for all host in a group
  • zbx items get ITEM.KEY --host HOST : List the last item value for the item.key provided for the host