Seminar LibreNMS – API, Automatisierung und Integrationen

Inhaltsverzeichnis

• Seminarprofil
• Lernziele
• Seminarinhalte
• Praxisübungen
• Zielgruppe und Voraussetzungen

Seminarprofil

Wiederkehrende Arbeiten an einer Monitoring-Umgebung lassen sich besser beherrschen, wenn Geräteinformationen und Änderungen strukturiert verarbeitet werden. Dieses Seminar führt von einfachen API-Abfragen zu einem kontrollierten Abgleich zwischen einer vorbereiteten Inventarliste und LibreNMS. Änderungen werden vor ihrer Ausführung geprüft und anschließend anhand des tatsächlichen Zustands bestätigt.

Die Übungen verwenden Python und einen bereitgestellten Inventardatensatz. Lesende und schreibende Vorgänge werden getrennt betrachtet, Fehlerantworten ausgewertet und Wiederholungen so gestaltet, dass keine ungewollten Duplikate entstehen. Zugangsdaten bleiben außerhalb des Programmcodes und werden nur für die vorgesehenen Aufgaben eingesetzt.

Weitere Laborstationen ergänzen die klassische SNMP-Überwachung um Service-Checks und ausgewählte Anwendungsmetriken. Mit einer vorbereiteten Oxidized-Instanz wird die Verbindung von Gerätebestand und versionierten Konfigurationsständen nachvollzogen. Dabei bleibt klar, welche Funktion LibreNMS selbst bereitstellt und welche Aufgabe ein eigenständiges Zusatzsystem übernimmt.

Lernziele

• Die für einen konkreten Prozess geeigneten API-Endpunkte und Datenfelder auswählen.
• Authentifizierte API-Aufrufe mit nachvollziehbarer Fehlerbehandlung umsetzen.
• Gerätebestände wiederholbar abgleichen und Änderungen vorab anzeigen.
• Service-Checks und unterstützte Anwendungsmetriken fachgerecht einbinden.
• Die Inventar- und Konfigurationsintegration mit Oxidized kontrollieren.

Seminarinhalte

API-Zugriff und Datenmodell

• API-Version, verfügbare Endpunkte und Antwortstrukturen der Laborversion prüfen.
• Einen Token für ein geeignetes Benutzerkonto erstellen und geschützt bereitstellen.
• Geräte, Ports und ausgewählte Zustandsinformationen lesend abfragen.

Robuste Automatisierung mit Python

• HTTP-Status, Zeitüberschreitungen und fehlerhafte Antworten gezielt behandeln.
• Filter und gegebenenfalls angebotene Seitennavigation je Endpunkt berücksichtigen.
• Protokolle so gestalten, dass Änderungen nachvollziehbar und Geheimnisse geschützt bleiben.

Geräteinventar abgleichen

• Soll- und Ist-Bestand anhand eindeutiger Merkmale vergleichen.
• Geplante Änderungen zunächst als Vorschau ausgeben und anschließend gezielt ausführen.
• Wiederholte Ausführung, Duplikate und einen abgebrochenen Abgleich kontrolliert behandeln.

Service- und Anwendungsüberwachung

• Ausgewählte Monitoring-Plugins für DNS-, HTTP- oder Zertifikatsprüfungen einbinden.
• Ausführungsort und Rückgabewerte der Prüfungen ausdrücklich kontrollieren.
• Eine unterstützte Anwendungsmetrik über SNMP Extend mit begrenzten Rechten erfassen.

Oxidized und Konfigurationsstände

• Eine vorbereitete Oxidized-Instanz mit dem LibreNMS-Gerätebestand verbinden.
• Gerätezuordnung und Gruppen prüfen sowie Konfigurationsstände in LibreNMS anzeigen.
• Versionen und Unterschiede auswerten; Gerätezugangsdaten weiterhin im zuständigen Zusatzsystem verwalten.

Zusammenhängender Integrationsablauf

• Geräteaufnahme, Gruppenprüfung und ergänzende Service-Prüfung verbinden.
• Ein Testereignis an einen vorbereiteten API-Empfänger übermitteln.
• Tokenfehler, nicht erreichbare Zielsysteme und teilweise ausgeführte Änderungen untersuchen.

Praxisübungen

1. Ein Inventar mit gültigen, bereits vorhandenen und absichtlich fehlerhaften Geräteangaben einlesen.
2. Eine lesende Bestandsaufnahme und eine verständliche Änderungsvorschau erstellen.
3. Die freigegebenen Laboränderungen ausführen und den zweiten Durchlauf auf Duplikate prüfen.
4. Einen Service-Check sowie eine unterstützte Anwendungsmetrik integrieren.
5. Für ein Laborgerät die Konfigurationshistorie aus Oxidized anzeigen und einen Schnittstellenfehler kontrolliert behandeln.

Zielgruppe und Voraussetzungen

System- und Netzwerkadministration, DevOps-Teams sowie Verantwortliche für Schnittstellen und Monitoring-Automatisierung.

Sichere LibreNMS-Grundkenntnisse, Linux-Praxis und grundlegende Programmiererfahrung mit Python. HTTP, JSON und die Verwaltung von Zugangsdaten sollten bekannt sein. Der Kurs ist keine Einführung in die Programmierung.