Monitoring  ·  ONLINE

Icinga 2 Director – erste Schritte und Nutzung

18. März 2016

Wenn du den Director nicht innerhalb der letzten 15 Minuten eingerichtet hast empfehle ich dir, den aktuellen Stand via GitHub auszuchecken und zum Einsatz zu bringen — Tom arbeitet sehr fleißig, und nahezu täglich gibt es neue Commits. Beachte dabei auch eventuelle Datenbank-Anpassungen und -Änderungen!

Host Template, Host Object und Deploy

Unser erster Schritt besteht darin, ein host template generic-director-host und ein host object fritzbox4711.bafi.lan anzulegen (das von generic-director-host erbt). Der übliche Check, der für Hosts verwendet werden soll, ist hostalive. In Icinga Web 2 navigierst du also zu Icinga Director · Host Objects · Add Host und fügst das Template (zum Beispiel gemäß der Angaben in nebenstehendem Screenshot) hinzu. Bist du fertig, speichere die Angaben mit einem Klick auf Store.
Jetzt kann mit fritzbox4711.bafi.lan der erste reale Host erfasst werden; wiederum navigierst du über Icinga Director · Host Objects · Add Host — als Object Type musst du nun jedoch Object angeben (und nicht, wie zuvor, Template).

Host und Template sind nun erfasst, jedoch noch nicht in die Konfiguration übernommen — die entsprechende Zahl der Änderungen wird üblicherweise neben Deployments/ History hervorgehoben. Wagen wir es also und übermitteln dem System unsere Änderungen — klicke hierzu auf Deployments/ History · Render config · Deploy to master (vgl. auch Screenshot — hier hab ich echt lange gebraucht, bis der Groschen endlich fiel!).

Der Rest analog

Das ist der übliche Ablauf: du erfasst deinen Kram — Hosts und Services, User und Downtimes, Notifications und so weiter — und lässt dem ein Deploy folgen. That’s it — deine Änderungen erscheinen nahezu zeitgleich. Das Webinterface hat ein Refresh-Intervall von 10 Sekunden, deine Änderungen sind aber schon deutlich eher verfügbar; im Zweifelsfalle kannst du auch auf Refresh klicken, dann siehst du das.

Data Lists und Data Fields

Frei wählbare Felder wie diese brauchst du, um die Konfiguration vollends an deine Bedürfnisse anpassen zu können. Ich zum Beispiel möchte, dass Icinga 2 mir Warnungen per Jabber schickt — ich möchte also meinen User-Eintrag um meinen Jabber-Namen erweitern. Tun wir das gemeinsam: über Icinga Director · Define data fields · Add new definieren wir das Feld Jabber vom Typ String.

Nun weisen wir dieses Feld dem Template generic-director-user zu (Icinga Director · Users · generic-director-user · Reiter „Fields“), wir erweitern also das Template um den Eintrag Jabber — hier können wir auch angeben, ob die Angabe eines Jabber-Namens optional oder zwingend ist. Und für jeden User, der Ableger des Templates generic-director-user ist, kann nun ein Jabber-Name hinterlegt werden. That’s it.

Analog hierzu funktionieren Data Lists — erwartungsgemäß stellen wir hier ein Drop-Down-Feld zur Verfügung, aus dem ausgewählt werden kann. Erweitern wir nun also unser Template generic-director-host um die Angabe, welches Betriebssystem auf dem Host installiert ist.

  • Im ersten Schritt erstellen wir also eine Liste aller Betriebssysteme, die wir einsetzen: Icinga Director · Provide Data Lists · Add list.
  • Anschließend müssen wir ein Data Field vom Typ Data List anlegen und diesem Feld unsere eben erstellte Betriebssystem-Liste unterschieben.
  • Zuletzt erweitern wir unser Host-Template um eben dieses Data Field, indem wir in Icinga Director · Hosts · generic-director-host auf den Reiter Fields klicken, das Field Operating System auswählen und festlegen, ob diese Angabe freiwillig oder zwingend zu erfolgen hat.
  • Deploy. That’s it.

Bin ich verständlich? Ich fürchte, es ist umständlicher zu erklären als auszuführen, deshalb habe ich dir großzügig Screenshots angeheftet und hoffe, sie helfen dir weiter. Feedback — wie immer — erwünscht! Und nun: viel Spaß beim Ausprobieren :-)

Diesen Beitrag schrieb ich vor über 5 Jahren, und zumindest technische Dinge haben sich seither nicht selten signifikant geändert. Behalte das beim Lesen bitte im Hinterkopf.

DeplymentIcinga 2Icinga DirectorIcinga Web 2

Marianne Spiller

Schreibt sich um Kopf und Kragen, bloggt seit 2006.Diese Seite war immer und ist derzeit und bleibt auch in Zukunft werbefrei. Wenn du das Bedürfnis hast, mir etwas Gutes zu tun, so kannst du beispielsweise mein Buch kaufen, den Betrieb des Servers durch eine Spende via PayPal unterstützen oder mir eine Kleinigkeit von meiner Amazon-Wishlist schenken. Wie auch immer, ich sage schon jetzt: vielen Dank!

Related Articles


Grafana Banner
Monitoring  ·  ONLINE  ·  Performance Data
Abuse rpcbind
9. Mai 2017
Icinga2 Dashing
Events  ·  Monitoring  ·  ONLINE
Icinga 2: Dashing
1. März 2016

7 Comments


Fuchsi
6. Januar 2018 at 19:54

Generell kann ich das Buch Icinga 2 (ix Edition): Ein praktischer Einstieg ins Monitoring zum Einstieg in Icinga 2 sehr empfehlen.
Gute andere Turorials für Installationen auf Debian und Ubuntu findet man hier:

https://www.4b42.com/support/kb/5649d075b9d15-Icinga-Web-2-Installation-unter-Debian-8-Jessie-9-Stretch
https://www.4b42.com/support/kb/55759b4747519-Icinga-2-Monitoring-Installation-unter-Debian-8-Jessie-9-Stretch
http://www.credativ.de/blog/howto-icinga2-mit-graphite-und-grafana-unter-debian

Grundinstallation Raspbian
(http://docs.icinga.org/icinga2/latest/doc/module/icinga2/chapter/getting-started#getting-started)

Download RASPBIAN JESSIE LITEhttps://www.raspberrypi.org/downloads/raspbian/

Auf SD-Karte installieren mit Win32DiskImager

SD-Karte in RaspberryPi einsetzen und booten
Mit Putty verbinden zum RaspberryPi
Einloggen mit Login: pi Passwort: raspberry
Raspberry Konfigurieren mit “sudo raspi-config”

Expand Filesystem
Internationalisation Options

Change Localede@utf-8
Change Timezone Europe/Berlin
Change Keyboard Layout
Change Wi-fi Country

reboot

Root account mit neuem Passwort versehen
$ sudo passwd root

Root-Login per ssh erlauben
$ nano -w /etc/ssh/sshd_config

#PermitRootLogin without-password
PermitRootLogin yes

Aktuelle Updates einspielen
# sudo apt-get update && sudo apt-get dist-upgrade

Netzwerk konfigurieren
# vim /etc/network/interfaces

allow-hotplug eth0
iface eth0 inet static
address 192.168.11.100
netmask 255.255.255.0
gateway 192.168.11.1
dns-domain example.com
dns-nameservers 192.168.11.1

Diverse kleinere Tools
# apt-get install mc htop unzip

reboot

Grundinstallation Icinga 2
Icinga 2 Core
# sudo -s
# wget -O - https://debmon.org/debmon/repo.key 2>/dev/null | apt-key add -
# echo 'deb http://debmon.org/debmon debmon-jessie main' >/etc/apt/sources.list.d/debmon.list
# apt-get update
# apt-get install icinga2

# icinga2 feature list
Disabled features: api command compatlog debuglog graphite icingastatus ido-mysql ido-pgsql livestatus notification perfdata statusdata syslog
Enabled features: checker mainlog notification
# icinga2 feature enable api command compatlog livestatus perfdata statusdata
By default Icinga 2 uses the following files and directories:

PATH
DESCRIPTION

/etc/icinga2
Contains Icinga 2 configuration files.

/etc/init.d/icinga2
The Icinga 2 init script.

/usr/sbin/icinga2
The Icinga 2 binary.

/usr/share/doc/icinga2
Documentation files that come with Icinga 2.

/usr/share/icinga2/include
The Icinga Template Library and plugin command configuration.

/var/run/icinga2
PID file.

/var/run/icinga2/cmd
Command pipe and Livestatus socket.

/var/cache/icinga2
status.dat/objects.cache, icinga2.debug files

/var/spool/icinga2
Used for performance data spool files.

/var/lib/icinga2
Icinga 2 state file, cluster log, local CA and configuration files.

/var/log/icinga2
Log file location and compat/ directory for the CompatLogger feature.

Syntax Highlighting
$ apt-get install vim-icinga2 vim-addon-manager
$ vim-addon-manager -w install icinga2
Info: installing removed addon 'icinga2' to /var/lib/vim/addons
$ vim ~/.vimrc
syntax on
$ cp /etc/nanorc ~/.nanorc
$ vim ~/.nanorc

## Icinga 2
include "/usr/share/nano/icinga2.nanorc"
Icinga Plugins (wurden bei Debian bereits installiert)
# apt-get install nagios-plugins
IDOdb
# apt-get install mysql-server mysql-client
# apt-get install icinga2-ido-mysql
# mysql -u root -p

CREATE DATABASE icinga;
GRANT SELECT, INSERT, UPDATE, DELETE, DROP, CREATE VIEW, INDEX, EXECUTE ON icinga.* TO 'icinga'@'localhost' IDENTIFIED BY 'icinga';
quit
# mysql -u root -p icinga < /usr/share/icinga2-ido-mysql/schema/mysql.sql
# icinga2 feature enable ido-mysql
Module 'ido-mysql' was enabled.
Make sure to restart Icinga 2 for these changes to take effect.
# vim /etc/icinga2/features-available/ido-mysql.conf

/**
* The db_ido_mysql library implements IDO functionality
* for MySQL.
*/

library „db_ido_mysql“

object IdoMysqlConnection „ido-mysql“ {
user = „icinga“,
password = „icinga“,
host = „localhost“,
database = „icinga“
}

# service icinga2 restart
Webserver (Apache)
# apt-get install apache2
# usermod -a -G nagios www-data
Icinga Classic-UI
# apt-get install icinga2-classicui
# a2enconf icinga2-classicui
# service apache2 restart
Finally visit Icinga Classic UI in your browser to access it: /icinga2-classicui
IcingaWeb2
# wget -O - http://packages.icinga.org/icinga.key | apt-key add -
# echo 'deb http://packages.icinga.org/debian icinga-jessie main' >/etc/apt/sources.list.d/icinga.list
# apt-get update
# apt-get install icingaweb2
# sudo mysql -p

CREATE DATABASE icingaweb2;
GRANT SELECT, INSERT, UPDATE, DELETE, DROP, CREATE VIEW, INDEX, EXECUTE ON icingaweb2.* TO 'icingaweb2'@'localhost' IDENTIFIED BY 'icingaweb2';
quit

# mysql -p icingaweb2 < /usr/share/icingaweb2/etc/schema/mysql.schema.sql
# mysql -p icingaweb2

INSERT INTO icingaweb_user (name, active, password_hash) VALUES ('icingaadmin', 1, '$1$EzxLOFDr$giVx3bGhVm4lDUAw6srGX1');
quit

# addgroup –system icingaweb2
# usermod -a -G icingaweb2 www-data
# a2enconf icingaweb2

# icingacli setup token create
# icingacli setup token show
# apt-get install php5-intl php5-imagick
# vim /etc/php5/apache2/php.ini

date.timezone = Europe/Berlin
# vim /etc/php5/cli/php.ini

date.timezone = Europe/Berlin
# service apache2 restart
Finally visit Icinga Web 2 in your browser to access the setup wizard and complete the installation: /icingaweb2/setup
Icinga Web 2 Manual Configuration
resources.ini providing the details for the Icinga Web 2 and Icinga 2 IDO database configuration. Example for MySQL:
# vim /etc/icingaweb2/resources.ini

[icingaweb2]
type = "db"
db = "mysql"
host = "localhost"
port = "3306"
dbname = "icingaweb2"
username = "icingaweb2"
password = "icingaweb2"

[icinga2]
type = "db"
db = "mysql"
host = "localhost"
port = "3306"
dbname = "icinga"
username = "icinga"
password = "icinga"

config.ini defining general application settings.
# vim /etc/icingaweb2/config.ini

[logging]
log = "syslog"
level = "ERROR"
application = "icingaweb2"

[preferences]
type = "db"
resource = "icingaweb2"

authentication.ini for e.g. using the previously created database.
# vim /etc/icingaweb2/authentication.ini

[icingaweb2]
backend = "db"
resource = "icingaweb2"

roles.ini granting the previously added icingaadmin user all permissions.
# vim /etc/icingaweb2/roles.ini

[admins]
users = "icingaadmin"
permissions = "*"
Icinga Web 2 Manual Configuration Monitoring Module
config.ini defining additional security settings.
# mkdir /etc/icingaweb2/modules/monitoring
# vim /etc/icingaweb2/modules/monitoring/config.ini

[security]
protected_customvars = "*pw*,*pass*,community"

backends.ini referencing the Icinga 2 DB IDO resource.
# vim /etc/icingaweb2/modules/monitoring/backends.ini

[icinga2]
type = "ido"
resource = "icinga2"

commandtransports.ini defining the Icinga command pipe.
# vim /etc/icingaweb2/modules/monitoring/commandtransports.ini

[icinga2]
transport = "local"
path = "/var/run/icinga2/cmd/icinga2.cmd"

Icinga Web 2 Manual Setup Login
Finally visit Icinga Web 2 in your browser to login as icingaadmin user: /icingaweb2.
Default PW is icingaadmin
Icinga Director
# apt-get install php5-curl
# service apache2 restart
# mysql -p

CREATE DATABASE director CHARACTER SET 'utf8';
GRANT ALL ON director.* TO director@localhost IDENTIFIED BY 'director';
quit;
# vim /etc/icingaweb2/resources.ini

[Director DB]
type = „db“
db = „mysql“
host = „localhost“
dbname = „director“
username = „director“
password = „director“
charset = „utf8“
# cd /usr/share/icingaweb2/modules/
# wget https://github.com/Icinga/icingaweb2-module-director/archive/master.zip
# unzip master.zip
# mv icingaweb2-module-director-master director
# rm -r master.zip
# mkdir /etc/icingaweb2/modules/director
# vim /etc/icingaweb2/modules/director/config.ini

[db]
resource = „Director DB“
# icinga2 api setup
# vim /etc/icinga2/conf.d/api-users.conf

object ApiUser „director“ {
password = „director“
//client_cn = „“

permissions = [ „*“ ]
}
# service icinga2 restart
# icingacli director migration run –verbose
Weitergehende Links zum Director:

https://github.com/Icinga/icingaweb2-module-director/tree/master/doc
https://www.unixe.de/icinga2-director-die-einrichtung/
https://www.unixe.de/icinga2-director-erste-schritte-und-nutzung/
https://www.netways.de/webinare/archiv/icinga_webinare/icinga_director_konfiguration_leicht_gemacht/


Michel Bisson
28. Dezember 2016 at 21:20

Vielen Dank Marianne,
deine Anleitung hast mir sehr geholfen die erste Schritte mit Icinga2, Icingaweb2 und Director zu machen.
Michel


Simon
23. August 2016 at 18:15

Hi,

erst mal großen Dank für deine Icinga 2 Director Tutorials. Soweit eingängig und funktional. Wie verfährst Du mit dem Director, wenn Du einem Host mehrere Dienste/Checks zuweisen willst?

Legst Du für jeden Check ein einzelnes Template an und weist das dem Host zu oder machst Du aus dein einzelnen Templates wieder ein Template das von diesen erbt?

Grüße
Simon


    Martin
    17. September 2016 at 8:56

    Dies würde mich auch interessieren.

      Simon
      22. Dezember 2016 at 17:42

      Scheinbar erhalten wir aber darauf keine Antwort mehr…

        Marianne M. Spiller
        29. Dezember 2016 at 0:55

        Darauf gibt es, zumindest im Moment, auch noch keine wirkliche Antwort von meiner Seite — ich bin wüst am Ausprobieren und stelle das Setup regelmäßig auf den Kopf… :-)

v
18. März 2016 at 15:32

Vielen Dank :)