Zuletzt aktualisiert: 16.07.2026 · Lesezeit: 4-6 Minuten
Mit Ansible und Icinga automatisierst du den Aufbau deiner kompletten Monitoring-Umgebung. Die Collection netways.icinga bündelt acht Rollen, die genau diese wiederkehrenden Schritte für dich übernehmen. Wir zeigen dir, was die Collection kann, wo ihre Grenzen liegen und wie du mit dem Full-Stack-Playbook in wenigen Minuten eine Testumgebung aufsetzt.
Vorstellung der Collection
Wenn du ein Monitoring-System wie Icinga betreibst, kennst du das Spiel: ein Master hier, ein paar Satellites dort, dazu Agents auf jedem überwachten Host, ein Webinterface, eine Datenbank und das Cache-Backend. Alles von Hand zu installieren und zu konfigurieren ist mühsam, fehleranfällig und kaum reproduzierbar. Genau hier kommt die Ansible Collection netways.icinga ins Spiel.
In einem Satz
Mit der netways.icinga Collection setzt du deine komplette Icinga Umgebung auf. Vom blanken System bis hin zur IcingaWeb2 inklusive Director.
Welches Problem löst sie?
Die Automatisierung deiner Icinga Installation wird durch die mitgelieferten Rollen erheblich vereinfacht. Statt jeden Schritt manuell auf jedem Host nachzubilden, übernimmt die Collection die wiederkehrenden Aufgaben für dich.
So werden Repositories eingebunden. Monitoring Plugins werden installiert und icinga2 wird aufgesetzt.
Im Kern besteht die Collection aktuell aus acht Rollen:
- netways.icinga.repos – verwaltet die Paket-Repositories und ist die Grundlage für alles Weitere.
- netways.icinga.icinga2 – installiert und konfiguriert deine Icinga 2 Instanzen (Master, Satellite, Agent). Das Herzstück der Collection.
- netways.icinga.icingadb – richtet IcingaDB ein, das moderne Daten-Backend.
- netways.icinga.icingadb_redis – installiert Redis als Cache-Backend für IcingaDB.
- netways.icinga.icingaweb2 – installiert und konfiguriert Icinga Web 2 samt Modulen.
- netways.icinga.monitoring_plugins – bringt die Monitoring-Plugins auf das System.
- netways.icinga.ifw – Icinga for Windows, um auch Windows-Hosts einzubinden.
- netways.icinga.icinga_kubernetes – Anbindung an Kubernetes-Umgebungen.
Dazu kommt ein Inventory-Plugin (netways.icinga.icinga), mit dem du Icinga selbst als dynamische Inventarquelle für Ansible nutzen kannst.
Für wen ist sie gedacht?
Für jeden, der genug Linux-Systeme betreibt, um nicht 100 Server einzeln von Hand einbinden zu wollen. Je mehr Hosts du hast, desto größer dein Gewinn. Über die Rolle ifw (Icinga for Windows) bindest du auch Windows-Hosts mit in die Überwachung ein. Dein Icinga-Master selbst läuft allerdings nur unter Linux.
Wie funktioniert sie grob?
Jede Rolle deckt eine Komponente ab und lässt sich für sich betrachten. die Collection sorgt vor allem dafür, dass das Zusammenspiel einfacher wird. Ob ein Host zum Master oder zum Agent wird, entscheidest du über die Definition des API-Features von Icinga 2. Die Rolle gibt dir dabei mehr an die Hand als nur die Feature Konfiguration aus der Icinga Doku. Etwa die Rolle als Master oder Agent und den Zertifikatsnamen, die du direkt über die Rollenparameter steuerst.
Was bringt dir das konkret?
Der Nutzen liegt vor allem in zwei Dingen: einer vereinfachte und reproduzierbaren Installation sowie dem mühelosen Anbinden vieler Agenten. Gerade Letzteres ist in der Praxis Gold wert. Es spart dir enorm viel Zeit und verlangt nur wenig Konfigurationsaufwand, weil sich die immer gleichen Schritte über dein Inventar skalieren lassen.
Die offensichtliche Stärke ist die Vereinfachung der initialen Konfiguration. Was früher viele manuelle und fehleranfällige Schritte waren, steckt jetzt in wiederverwendbaren Rollen. Es gibt jedoch auch Schwächen, die du kennen solltest. Ein Konfigurationsfehler zieht sich über alle betroffenen Maschinen hinweg. Dieselbe Automatisierung, die das Ausrollen beschleunigt, verteilt auch Fehler schnell und großflächig.
Auch wenn Ansible sauber durchläuft, heißt das nicht zwangsläufig, dass deine Icinga-Konfiguration vollständig und korrekt ist. Es kann passieren, dass die Konfiguration zwar fehlerfrei angewendet wird, am Ende aber schlicht nichts Sinnvolles bewirkt. Um die Rollen wirklich sinnvoll einzusetzen, brauchst du ein gewisses Maß an Icinga 2-Wissen. Die Collection nimmt dir die Handarbeit ab, nicht aber das Verständnis dafür, was du da eigentlich baust.
Lieber gemeinsam automatisieren?
Unsere Consultants bauen dir ein auf deine Umgebung zugeschnittenes Ansible-Setup für Icinga, inklusive Übergabe und Doku.
Kostenlose Erstberatung →
Installation
Der einfachste Weg führt über die Ansible Galaxy, hier kannst du mit nur einem Befehl die Collection erlangen:
ansible-galaxy collection install netways.icinga Alternativ ist eine Installation auch über das Git-Repository möglich:
ansible-galaxy collection install git+https://github.com/NETWAYS/ansible-collection-icinga.git,0.4.6Das Full-Stack-Playbook
Die Collection bietet ein schon fertiges Demo-Playbook. Es richtet auf einem einzelnen Host eine komplette Master Instanz ein. Also Icinga2 mit eigener CA, IcingaDB, IcingaDB Redis, die Datenbank, Icinga Web 2 und den Director.
Wichtig ist, dass du deinen Zielhost vorher sauber in einem Inventar einpflegst. Lege dir dazu eine Datei inventory.ini an. Achte darauf, dass am Zeilenanfang immer zuerst der Name des Hosts steht:
[icinga]
dein-host ansible_hosts=deine.host.ip ansible_user=dein_userDanach startest du das Playbook und gibst den Hostnamen aus deinem Inventar mit:
ansible-playbook -i inventory.ini netways.icinga.full_stack -e _target=<inventory_hostname des Zielhosts> --ask-become-passDas Flag –-ask-become-pass ist hier wichtig, weil das Playbook Pakete installiert und dafür sudo-Rechte auf dem Zielhost braucht. Ansible fragt dich beim Start nach dem sudo-Passwort.
Das Playbook ist ausdrücklich als Testumgebung gedacht und läuft auf Debian/Ubuntu. Dein Login für Icinga Web 2 ist anschließend admin/admin. Für deine Produktionsumgebung ist es nicht gedacht – dafür baust du dir ein eigenes, an deine Umgebung angepasstes Playbook.
Fazit zur Ansible Icinga Collection
Die netways.icinga Collection nimmt dir die mühsame manuelle Einrichtung von Icinga ab und verpackt sie in saubere, wiederholbare Playbooks. Dein Mehrwert ist nicht nur die Zeitersparnis beim ersten Aufsetzen, sondern die Reproduzierbarkeit. Deine Monitoring-Infrastruktur steht als Code da, lässt sich Versionieren und jederzeit identisch neu erzeugen.
Gleichzeitig ersetzt die Collection kein Icinga-Wissen. Sie nimmt dir die Handarbeit ab, nicht das Verständnis. Wenn du das im Hinterkopf behältst, hast du ein extrem praktisches Werkzeug an der Hand, das besonders dann glänzt, wenn du viele Hosts anbinden musst.
