Icinga Installation Instructions

How to Integrate Icinga with BigPanda

Create an App Key

First create an App Key. You'll need a separate App Key for each integrated system.

Select an Install Method:

RedHat
CentOS
Debian
Ubuntu

RedHat

Install the BigPanda Agent on RedHat

Connect to the host where your Icinga server is installed, and install the BigPanda agent package.

$ sudo wget http://repos.bigpanda.io/config/bigpanda.repo -O /etc/yum.repos.d/bigpanda.repo
$ sudo yum install bigpanda-agent

Note: If you run RHEL 5, you will need to install the EPEL repository. Please consult the FAQ for instructions.

Configure Icinga

Open the main Icinga configuration file (usually /usr/local/icinga/etc/icinga.cfg or /etc/icinga/icinga.cfg):

$ sudo vim /usr/local/icinga/etc/icinga.cfg
  • Set log_rotation_method to d (= daily log rotation)
  • Make sure log_archive_path is configured (= location of old logs)
  • Test that Icinga (usually nagios user) has write permissions to the log_archive_path folder

Reload the Icinga service for the changes to take effect.

sudo service icinga reload

Configure the BigPanda Agent

Generate the agent's configuration file:

$ sudo bigpanda-config --init --token <YOUR TOKEN>
$ sudo bigpanda-config --add icinga --app-key <YOUR APP KEY>

When prompted, specify the locations of icinga.log, status.dat and objects.cache files.

The script output should look like this:

Log File Path: /var/log/icinga/icinga.log
Status Dat Path: /var/cache/icinga/status.dat
Objects Cache Path: /var/cache/icinga/objects.cache

Of course, the actual paths will depend on your installation.

Update Permissions

Give the agent read permissions to the objects.cache, status.dat and log files. A possible way to do it:

$ sudo usermod -a -G "<GROUP OF OBJECT CACHE FILE>,<GROUP OF LOG FILE>,<GROUP OF STATUS DAT FILE>" bigpanda

Start the BigPanda Agent

  • On RHEL 6:

    $ sudo initctl start bigpanda

  • On RHEL 5 and 7:

    $ sudo service bigpanda start

Success

You should be able to see all your active Icinga alerts in the Incidents tab.

CentOS

Install the BigPanda Agent on CentOS

Connect to the host where your Icinga server is installed, and install the BigPanda agent package.

$ sudo wget http://repos.bigpanda.io/config/bigpanda.repo -O /etc/yum.repos.d/bigpanda.repo
$ sudo yum install bigpanda-agent

Note: If you run CentOS 5, you will need to install the EPEL repository. Please consult the FAQ for instructions.

Configure Icinga

Open the main Icinga configuration file (usually /usr/local/icinga/etc/icinga.cfg or /etc/icinga/icinga.cfg):

$ sudo vim /usr/local/icinga/etc/icinga.cfg
  • Set log_rotation_method to d (= daily log rotation)
  • Make sure log_archive_path is configured (= location of old logs)
  • Test that Icinga (usually nagios user) has write permissions to the log_archive_path folder

Reload the Icinga service for the changes to take effect.

sudo service icinga reload

Configure the BigPanda Agent

Generate the agent's configuration file:

$ sudo bigpanda-config --init --token <YOUR TOKEN>
$ sudo bigpanda-config --add icinga --app-key <YOUR APP KEY>

When prompted, specify the locations of icinga.log, status.dat and objects.cache files.

The script output should look like this:

Log File Path: /var/log/icinga/icinga.log
Status Dat Path: /var/cache/icinga/status.dat
Objects Cache Path: /var/cache/icinga/objects.cache

Of course, the actual paths will depend on your installation.

Update Permissions

Give the agent read permissions to the objects.cache, status.dat and log files. A possible way to do it:

$ sudo usermod -a -G "<GROUP OF OBJECT CACHE FILE>,<GROUP OF LOG FILE>,<GROUP OF STATUS DAT FILE>" bigpanda

Start the BigPanda Agent

  • On CentOS 6:

    $ sudo initctl start bigpanda

  • On CentOS 5 and 7:

    $ sudo service bigpanda start

Success

You should be able to see all your active Icinga alerts in the Incidents tab.

Debian

Install the BigPanda Agent on Debian

Connect to the host where your Icinga server is installed, and install the BigPanda agent package.

$ echo deb http://repos.bigpanda.io/deb `lsb_release -c -s` main | sudo tee /etc/apt/sources.list.d/bigpanda.list
$ curl https://repos.bigpanda.io/config/bigpanda.pub | sudo apt-key add -
$ sudo apt-get update
$ sudo apt-get install bigpanda-agent

Configure Icinga

Open the main Icinga configuration file (usually /usr/local/icinga/etc/icinga.cfg or /etc/icinga/icinga.cfg):

$ sudo vim /usr/local/icinga/etc/icinga.cfg
  • Set log_rotation_method to d (= daily log rotation)
  • Make sure log_archive_path is configured (= location of old logs)
  • Test that Icinga (usually nagios user) has write permissions to the log_archive_path folder

Reload the Icinga service for the changes to take effect.

sudo service icinga reload

Configure the BigPanda Agent

Generate the agent's configuration file:

$ sudo bigpanda-config --init --token <YOUR TOKEN>
$ sudo bigpanda-config --add icinga --app-key <YOUR APP KEY>

When prompted, specify the locations of icinga.log, status.dat and objects.cache files.

The script output should look like this:

Log File Path: /var/log/icinga/icinga.log
Status Dat Path: /var/cache/icinga/status.dat
Objects Cache Path: /var/cache/icinga/objects.cache

Of course, the actual paths will depend on your installation.

Update Permissions

Give the agent read permissions to the objects.cache, status.dat and log files. A possible way to do it:

$ sudo usermod -a -G "<GROUP OF OBJECT CACHE FILE>,<GROUP OF LOG FILE>,<GROUP OF STATUS DAT FILE>" bigpanda

Start the BigPanda Agent

$ sudo service bigpanda start

Success

You should be able to see all your active Icinga alerts in the Incidents tab.

Ubuntu

Install the BigPanda Agent on Ubuntu

Connect to the host where your Icinga server is installed, and install the BigPanda agent package.

$ echo deb http://repos.bigpanda.io/deb `lsb_release -c -s` main | sudo tee /etc/apt/sources.list.d/bigpanda.list
$ curl https://repos.bigpanda.io/config/bigpanda.pub | sudo apt-key add -
$ sudo apt-get update
$ sudo apt-get install bigpanda-agent

Configure Icinga

Open the main Icinga configuration file (usually /usr/local/icinga/etc/icinga.cfg or /etc/icinga/icinga.cfg):

$ sudo vim /usr/local/icinga/etc/icinga.cfg
  • Set log_rotation_method to d (= daily log rotation)
  • Make sure log_archive_path is configured (= location of old logs)
  • Test that Icinga (usually nagios user) has write permissions to the log_archive_path folder

Reload the Icinga service for the changes to take effect.

sudo service icinga reload

Configure the BigPanda Agent

Generate the agent's configuration file:

$ sudo bigpanda-config --init --token <YOUR TOKEN>
$ sudo bigpanda-config --add icinga --app-key <YOUR APP KEY>

When prompted, specify the locations of icinga.log, status.dat and objects.cache files.

The script output should look like this:

Log File Path: /var/log/icinga/icinga.log
Status Dat Path: /var/cache/icinga/status.dat
Objects Cache Path: /var/cache/icinga/objects.cache

Of course, the actual paths will depend on your installation.

Update Permissions

Give the agent read permissions to the objects.cache, status.dat and log files. A possible way to do it:

$ sudo usermod -a -G "<GROUP OF OBJECT CACHE FILE>,<GROUP OF LOG FILE>,<GROUP OF STATUS DAT FILE>" bigpanda

Start the BigPanda Agent

$ sudo service bigpanda start

Success

You should be able to see all your active Icinga alerts in the Incidents tab.


Recommended Reading