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!
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!).
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.
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.
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 :-)
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
Dies würde mich auch interessieren.
Scheinbar erhalten wir aber darauf keine Antwort mehr…
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… :-)
Vielen Dank :)
7 Comments
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 listDisabled 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 ~/.vimrcsyntax 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-pluginsIDOdb
# apt-get install mysql-server mysql-client# apt-get install icinga2-ido-mysql# mysql -u root -pCREATE 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-mysqlModule '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 restartWebserver (Apache)
# apt-get install apache2# usermod -a -G nagios www-dataIcinga Classic-UI
# apt-get install icinga2-classicui
# a2enconf icinga2-classicui
# service apache2 restartFinally visit Icinga Classic UI in your browser to access it:
/icinga2-classicuiIcingaWeb2
# 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 icingaweb2INSERT 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/setupIcinga 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
icingaadminuser 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
icingaadminuser:/icingaweb2.Default PW is
icingaadminIcinga Director
# apt-get install php5-curl
# service apache2 restart
# mysql -pCREATE 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/
Vielen Dank Marianne,
deine Anleitung hast mir sehr geholfen die erste Schritte mit Icinga2, Icingaweb2 und Director zu machen.
Michel