# MKLivestatus backend

MKLivestatus is a very simple and smart Nagios eventbroker module. Livestatus is concepted and tuned to reduce disk, memory and cpu loads caused by live-data processing on the Nagios system. Just as NDO, Livestatus makes use of the Nagios Event Broker API and loads a binary module into the Nagios process. But other than the NDO, Livestatus does not actively write out data e.g. to the disk. Instead, it opens a socket for external applications to connect to and fetch the current status information from Nagios. For details about the new data access provider take a look at the official documentation.

Since the first NagVis 1.5 release the mklivestatus backend is included on delivery. It performs much better than all other existing backends and comes with less overhead than other backends. No additional database is needed to make this backend work.

Value | Default | Description
--- | --- | ---

socket

unix:/usr/local/nagios/var/rw/live

The socket to connect to can be a local unix socket or a tcp socket. You have to define the type at the beginning of the string. Set "unix:" for unix sockets or "tcp:" for tcp sockets.

In case of the unix socket you need to put the path of the livestatus unix socket to connect to.

When using a tcp socket you have to enter a hostaddress and a tcp port using the following scheme: <host>:<port>. The host address can be an IP-address or an FQDN.

timeout | 5 | New in 1.6.4: This option controls the connect timeout of the livestatus socket. This is just a fallback. To prevent timeouts when accessing remote sites you really should configure a statushost for the backend. For details take a look at the general backend parameters documented in the backend section of the main configuration format description.

There are also some general parameters. You can read about them in main configuration format description.