Hoe je een observability-beest oproept: Icinga 2 + IcingaDB + Web + Director installeren op Debian

Screenshot van de Icinga-webinterface

🌐 Ook in: English · Deutsch · Français · Español · Italiano · Português · Polski

Een nerdy homelabverhaal met Redis, te veel databases en te weinig slaap.


Inhoud

📝 Inleiding

Gefeliciteerd, reiziger. Als je dit leest, heb je besloten je homelab te monitoren als een verantwoordelijke volwassene in plaats van het eeuwenoude ritueel “zet het uit en weer aan” uit te voeren.

Deze post vat — op hoog, meta en licht sarcastisch nerdniveau — samen hoe je de volledige moderne Icinga-monitoringstack op Debian in elkaar zet:

  • Icinga 2 – de kernmotor
  • Redis – de bliksemsnelle event-brievenbus
  • IcingaDB – de glimmende nieuwe database-backend
  • MariaDB/PostgreSQL – het langetermijngeheugenkristal
  • Icinga Web 2 – de visuele glazen bol
  • Icinga Director – je configuratie-spreukenboek

Om het nog epischer te maken: vandaag nam ik deel aan een online training van een hele dag door NETWAYS uit Neurenberg, die de komende vier dagen doorgaat. Na een lange dag leren heb ik ’s avonds Icinga op mijn homelabserver geïnstalleerd — met succes! Nu alles draait, ga ik regelrecht naar bed. Ook monitoringnerds hebben hun uptime nodig.


🧱 Stap 1 – Installeer de heilige drie-eenheid: Icinga 2, Redis & SQL

🔥 Icinga 2 – De centrale daemon

Dit is het brein van je monitoringstack. Hij controleert dingen, klaagt over dingen en vertelt je of je homelabnodes UP, DOWN of in de mystieke toestand “werkt op mijn machine” zijn.

⚡ Redis – De realtime event-warpaandrijving

Het moderne Icinga gebruikt Redis als razendsnel eventtransport. Alle live data (checkresultaten, statuswijzigingen, downtimes enz.) gaat eerst naar Redis, want:

SQL is traag. Redis is cafeïne op silicium.

🗄️ SQL-database – Langetermijngeheugen

Je SQL-database bevat:

  • Monitoringgeschiedenis
  • Host-/service-objecten
  • Events & relaties

Kortom:

Redis = RAM

SQL = Schijf

Icinga 2 = CPU


🔌 Stap 2 – Verbind Icinga 2 met IcingaDB

IcingaDB is de moderne vervanger van de oude IDO-backend. Het regelt:

  • Live status uit Redis lezen
  • Gestructureerde monitoringdata naar SQL schrijven
  • Icinga Web 2 voeden met consistente objecten & geschiedenis

Het heeft een correcte:

  • Redis-verbinding (host, poort)
  • SQL-verbinding (driver, hostname, database, gebruiker)

nodig. Eenmaal geconfigureerd wordt IcingaDB het kloppende hart van je observability-pipeline.


🧙 Stap 3 – Roep de webinterface op (Icinga Web 2)

Icinga Web 2 is je dashboard voor alles wat status heeft, geschiedenis heeft en af en toe alarmerend is.

Het vereist:

  • Een webserver (Apache of nginx)
  • PHP met diverse modules
  • Een aparte database voor gebruikers, groepen, rollen

Ja: dit is niet dezelfde database als die van IcingaDB. Deze DB bevat alleen metadata voor authenticatie en autorisatie.


🔐 Stap 4 – Activeer de Icinga 2 API

De API verbindt Icinga Web 2 met Icinga 2. Je zet hem op met:

  • Generatie van de interne Icinga-CA
  • Hostcertificaten
  • Een API-gebruiker met rechten als:
    • status/*
    • objects/*
    • actions/*

Dit is meestal het moment waarop je beseft dat je meer over TLS hebt geleerd dan een sterveling ooit nodig zou moeten hebben. Welkom in monitoring.


📊 Stap 5 – IcingaDB in de webinterface

In Icinga Web 2 levert de IcingaDB-module:

  • Live status uit Redis
  • Geschiedenis uit de IcingaDB-SQL-database

Daarom configureer je twee aparte resources:

  • Icinga Web 2-DB → gebruikers & groepen
  • IcingaDB-DB → monitoringobjecten & geschiedenis

Die scheiding maakt het hele systeem schaalbaar en mooi.


🕹️ Stap 6 – Installeer de Director

De Icinga Director is je webgebaseerde motor voor configuratieautomatisering. In plaats van Icinga-DSL-bestanden met de hand te schrijven als een holbewoner, krijg je:

  • Host- & servicetemplates
  • Apply-regels
  • Importbronnen
  • Massale uitrol

Ja, de Director heeft nog een database nodig. Deze stack is eigenlijk Pokémon voor DBA’s.


🌀 Stap 7 – Herstart het universum

De laatste stap is het sysadmin-ritueel:

  • Redis herstarten
  • IcingaDB herstarten
  • Icinga 2 herstarten
  • Apache herladen

Als alles klopt, laat Icinga Web 2 eindelijk zien:

  • Live host- & servicestatussen
  • Historische data
  • Director-configuratie

Klopt er iets niet… tja, kijk in je logs. Die schreeuwen het je tot in detail toe.


🌙 Een lange trainingsdag, een late avond in het homelab

Vandaag nam ik deel aan een online training van een hele dag bij NETWAYS uit Neurenberg. En niet alleen vandaag — deze training gaat de komende vier dagen door.

En zoals elke echte nerd besloot ik na afloop van de training de verse kennis meteen toe te passen en begon ik aan de installatie van de complete Icinga 2-stack op mijn homelabserver.

Het kostte wat worstelen met Redis-poorten, databaserechten en setupwizards, maar uiteindelijk: de stack is nu volledig operationeel.

Met die achievement unlocked sluit ik dit hoofdstuk van de avond officieel af en ga ik regelrecht naar bed. Ook homelab-sysadmins hebben onderhoudsvensters nodig.


🏁 Conclusie

Je hebt met succes in elkaar gezet:

  • Icinga 2
  • Redis
  • IcingaDB
  • Icinga Web 2
  • Director
  • Drie databases en talloze configs

Je homelab heeft nu een volledig werkend observability-systeem — en je mag er nu op internet over opscheppen.

We meten nu uptime. En ons eigen verstand.


Sommige teksten en afbeeldingen op deze site zijn met hulp van AI gemaakt of door AI gegenereerd. Details