configuration icinga

In order to utilize the agent, Icinga2 API must be enabled and an appropriate user needs to be created.

Icinga2 API

Icinga2 API is used to monitor external hosts using the Icinga2 agent and connect 3rd party applications, such as IcingaBusylightAgent, to Icinga2. Mostly, this step is already done for your environment - if not, proceed with the following steps:

# icinga2 api setup
# icinga2 feature enable api
# service icinga2 restart

API user

IcingaBusylightAgent will authenticate against Icinga2 to retrieve host and service information. A read-only user is sufficient for this. To create an Icinga2 API user, create a configuration file like this on your Icinga2 server:

object ApiUser "busylight" {
  password = "giertz"
  permissions = [ "objects/query/Host", "objects/query/Service", "objects/query/Hostgroup" ]
}

This will create an API user busylight with password giertz and allow reading host and service information.