Helps to query MK livestatus and get results
Project description
- Version:
- 0.4
Access the data returned from MK Livestatus queries as Python lists or dictionaries. It does this by sending queries to the MK Livestatus UNIX socket and parses the returned rows. Read/write permission to the UNIX socket are required.
This package is known to be compatible with Python 2.7, 3.3, 34, pypy and pypy3.
Usage
Here a simple example to fetch the name and hostgroups for all servers in the UP (0) state:
>>> from mk_livestatus import Socket >>> s = Socket("/var/lib/icinga/rw/live") >>> q = s.hosts.columns('name', 'groups').filter('state = 0') >>> print q GET hosts Columns: name groups Filter: state = 0>>> q.call() [{'name': 'example.com', 'groups': ['ssh', 'snmp', 'smtp-server', 'ping-server', 'http-server', 'debian-server', 'apache2']}]
s.hosts returns a Query to the hosts resources on Nagios. The columns and filter methods modify our query and return it, so we can chain the calls. The call to call method returns the rows as a list of dictionaries.
If you use xinetd to bind the Unix socket to a TCP socket (like explained here), you can create the socket like :
>>> s = Socket(('192.168.1.1', 6557))
For more information please visit the python-mk-livestatus website. Information about MK Livestatus and it’s query syntax is available at the mk-livestatus website.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for python_mk_livestatus-0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e48959c0f01205db2faa93ab8f76e35de7aff5cd65cbc2d79dea23a3d7bfcfae |
|
MD5 | 2bfba1517ecfeb9db359ffff4caea161 |
|
BLAKE2b-256 | 5a8498f51eca0f571d1ec025faacc686b61b910cab0b09f342508fcf95a3ee40 |