Skip to main content

Helps to query MK livestatus and get results

Project description

Author:

Michael Fladischer

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

python-mk-livestatus-0.4.tar.gz (3.7 kB view details)

Uploaded Source

Built Distribution

python_mk_livestatus-0.4-py3-none-any.whl (5.1 kB view details)

Uploaded Python 3

File details

Details for the file python-mk-livestatus-0.4.tar.gz.

File metadata

File hashes

Hashes for python-mk-livestatus-0.4.tar.gz
Algorithm Hash digest
SHA256 ad8bda17f152eca73a273e93309c03190214588ff81095cd4f920be6d08356d9
MD5 e05117e62c7e51d9dd8d01d86dde0df2
BLAKE2b-256 cec65bcb137f44e1346b0247554763bb525ce4a8b7c9d70d5109b5bfdf09ad69

See more details on using hashes here.

Provenance

File details

Details for the file python_mk_livestatus-0.4-py3-none-any.whl.

File metadata

File hashes

Hashes for python_mk_livestatus-0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 e48959c0f01205db2faa93ab8f76e35de7aff5cd65cbc2d79dea23a3d7bfcfae
MD5 2bfba1517ecfeb9db359ffff4caea161
BLAKE2b-256 5a8498f51eca0f571d1ec025faacc686b61b910cab0b09f342508fcf95a3ee40

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page