Python CheckMk Requests library

Provides a library to manage the most common CheckMk requests.

class Connection

Provides common operations on CheckMk.

Usage:

from requests.auth import HTTPBasicAuth
http_auth = HTTPBasicAuth("user", "password")
conn = Connection("URL", auth=http_auth, verify=False)
# or
from requests_gssapi import HTTPKerberosAuth
conn = Connection("URL", auth=HTTPKerberosAuth())
host_info = conn.host_search("HOSTREGEX")
hosts_services_info = conn.collect_host_services_from_regex("HOSTREGEX")
hosts_services_info = conn.collect_host_services_from_list(
 ["HOSTNAME", "HOSTNAME"])
service_info = conn.search_host_service_by_regex("HOSTNAME")
# Args: hostname, downtime duration in minutes, downtime message
conn.set_host_downtime("HOSTNAME", 120, "MESSAGE")
conn.remove_host_downtime("HOSTNAME")
nok_services = conn.host_services("HOSTNAME").filter_nok()
# same for service downtimes
conn.set_service_acks_from_response(nok_services, "MESSAGE")
conn.remove_service_acks_from_response(nok_services)

class Response

Contains data from a CheckMk Connection request.

Usage:

nok_services_info = service_info.filter_nok() # -> Response
for hostname, host_service_data in service_info.items(): # dict iterator
	for service_name, service_data in host_service_data.items():
	 ...
for hostname in service_info: # provides __iter__
 ...
print(service_info) # provides __str__
print([service_info]) # provides __repr__