Icinga2

From HoerupWiki
Jump to: navigation, search

Base Icinga2 + web2

Notes for setting up icinga2 on Debian9/Stretch

  • see this https://www.howtoforge.com/tutorial/install-icinga2-and-icingaweb2-on-centos-7/
  • base debian9 vm (2vcpu + 1gb mem + 4gb disk)
  • apt-get install mariadb-server (note that mariadb root uses socket auth like postgres has been doing for many years)
  • apt-get install icinga2 monitoring-plugins icingacli
  • apt-get install icinga2-ido-mysql (this will create database and mysql user)
  • icinga2 feature enable ido-mysql (make sure the module is enabled)
  • apt-get install vim-icinga2 (this is optional)
  • icinga2 feature enable command
  • icinga2 feature enable api
  • icinga2 api setup
  • validate basic icinga2 is working
    • systemctl restart icinga2
    • systemctl status icinga2


  • apt-get install icingaweb2

Add hosts and services to /etc/icinga2/conf.d/ . you need to restart icinga2 in order to load new config systemctl restart icinga2

Agent push of icinga settings


Icinga Director

  • apt-get install php-curl
  • read http://www.stankowic-development.net/?p=6987&lang=en
  • ..a and Read github install guide
  • ... and this [1]
  • create database for director
  • add database to icingaweb -> configuration -> application -> resources
  • download latest release from github to /usr/share/icingaweb2/modules and unpack it
  • enable the module icingaweb -> configuration -> modules
  • choose director from left hand menu

Dashing Icinga2

https://github.com/Icinga/dashing-icinga2

object ApiUser "dashing" {
  password = "icinga2ondashingr0xx"
  permissions = [ "status/query", "objects/query/*" ]
}
  • vim config/icinga2.json
{
 "icinga2": {
   "api": {
     "host": "localhost",
     "port": 5665,
     "user": "dashing",
     "password": "icinga2ondashingr0xx"
   }
 }
}