Vollständige Schritt-für-Schritt-Anleitung zur Einbindung von Didactum Monitoring-Geräten und Sensoren in isyVmon via SNMP – inklusive Host-Anlage, Check-Kommandos, Service-Konfiguration, SNMP Traps und E-Mail-Alarmierung.

Hinweis zur Software: isyVmon basiert vollständig auf Nagios (Monitoring-Engine) und Centreon (Web-Interface). Alle hier beschriebenen Konfigurationsschritte gelten daher auch für reine Nagios- und Centreon-Installationen. Konfigurationsdateien und Menüpfade sind identisch.

• Software: isyVmon (iT-CUBE SYSTEMS) – basierend auf Nagios + Centreon
• Protokoll: SNMP v1 / v2c / v3 via check_snmp Plugin
• Geräte: Didactum Monitoring System 100T / 300T / 500T / 550T
• Sensoren: Temperatur, Leckage, Luftfeuchtigkeit, Türkontakt, Rauch

isyVmon-Server

• isyVmon als Virtual Appliance oder Hardware Appliance installiert
• Web-Interface erreichbar (Standard: <Server-IP>/centreon)
• Nagios-Plugins installiert (Paket nagios-plugins oder monitoring-plugins)
• Paket snmp und snmp-mibs-downloader installiert
• UDP-Port 161 ausgehend geöffnet (SNMP Polling)
• UDP-Port 162 eingehend geöffnet (SNMP Traps)

Didactum-Gerät

• Monitoring System 100T / 300T / 500T oder 550T
• SNMP aktiviert (v2c oder v3)
• Netzwerkzugang zum isyVmon-Server
• MIB-Datei im Web-Interface verfügbar

Architektur

[isyVmon / Nagios + Centreon]    [Didactum Monitoring System]
  IP: 192.168.1.10                  IP: 192.168.1.50
  Web: 192.168.1.10/centreon
                      --SNMP Polling UDP 161-->
                      <--SNMP Traps UDP 162---

Wichtige Verzeichnisse auf dem isyVmon-Server

/usr/local/nagios/etc/          <-- Nagios Konfiguration
/usr/local/nagios/etc/objects/  <-- Hosts, Services, Commands
/usr/lib/nagios/plugins/        <-- check_snmp und andere Plugins
/usr/share/snmp/mibs/           <-- MIB-Dateien
/var/log/nagios/nagios.log      <-- Nagios Logfile

Hinweis: 

Pfade können je nach isyVmon-Version und Installationstyp leicht abweichen. Alternative Pfade: /etc/nagios/, /etc/centreon/.

Schritt 1 – Web-Interface öffnen

Im Browser aufrufen: 192.168.1.50 (IP des Didactum-Geräts anpassen)

Schritt 2 – SNMP-Einstellungen aufrufen

Systemeinstellungen → SNMP

Schritt 3 – Folgende Werte eintragen

SNMPv3-Einstellungen (optional, erhöhte Sicherheit)

Schritt 1 – Auf dem isyVmon-Server per SSH einloggen

ssh root@192.168.1.10

Schritt 2 – SNMP-Pakete installieren

sudo apt update
sudo apt install -y snmp snmp-mibs-downloader nagios-plugins

# check_snmp verfügbar prüfen
ls /usr/lib/nagios/plugins/check_snmp
/usr/lib/nagios/plugins/check_snmp --help | head -10

Schritt 3 – SNMP-Verbindung zum Didactum-Gerät testen

# Alle Sensoren auflisten
snmpwalk -v 2c -c didactum_isyvmon 192.168.1.50 .1.3.6.1.4.1.46501

# Temperaturwert direkt abfragen (Rohwert ÷ 10 = Grad Celsius)
snmpget -v 2c -c didactum_isyvmon 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1.7.101001

# check_snmp Plugin direkt testen
/usr/lib/nagios/plugins/check_snmp \
    -H 192.168.1.50 -C didactum_isyvmon -P 2 \
    -o .1.3.6.1.4.1.46501.5.1.1.7.101001 \
    -w 280 -c 350 -l "Temperatur"
# Erwartete Ausgabe: SNMP OK - 235

Schritt 1 – MIB aus dem Didactum Web-Interface laden

Systemeinstellungen → SNMP → "MIB-Datei herunterladen" → didactum.mib

Schritt 2 – MIB auf dem Server installieren

sudo cp didactum.mib /usr/share/snmp/mibs/
echo "mibdirs /usr/share/snmp/mibs" | sudo tee -a /etc/snmp/snmp.conf
echo "mibs ALL" | sudo tee -a /etc/snmp/snmp.conf

# Test mit MIB-Namen
snmpwalk -v 2c -c didactum_isyvmon -m ALL 192.168.1.50 \
    DIDACTUM-MIB::sensorValue

isyVmon (Centreon) verwaltet SNMP-Zugangsdaten als Makros, die Hosts und Kommandos zugewiesen werden.

Navigation im isyVmon/Centreon Web-Interface

Configuration → Commands → Macros

Oder direkt beim Host-Template (empfohlen):

Configuration → Hosts → Templates → "Didactum-Template" bearbeiten
→ Macros → Add Macro

Für SNMPv3 zusätzlich:

Variante A – Über das Centreon Web-Interface (empfohlen)

Configuration → Hosts → Add

Auf Save klicken.

Variante B – Direkt als Nagios-Konfigurationsdatei

sudo nano /usr/local/nagios/etc/objects/didactum-hosts.cfg

# ================================================================
# Didactum Monitoring System – Nagios Host-Konfiguration
# ================================================================

define host {
    host_name               didactum-monitor-01
    alias                   Didactum Monitoring System 01
    address                 192.168.1.50
    check_command           check-host-alive
    max_check_attempts      3
    check_interval          5
    retry_interval          1
    check_period            24x7
    notification_interval   60
    notification_period     24x7
    notification_options    d,u,r
    contact_groups          admins
    hostgroups              didactum-monitoring

    # SNMP Custom Variables (für Makros in Kommandos)
    _SNMPCOMMUNITY          didactum_isyvmon
    _SNMPVERSION            2
    _SNMPPORT               161
}

define hostgroup {
    hostgroup_name  didactum-monitoring
    alias           Didactum Monitoring Geräte
    members         didactum-monitor-01
}

Variante A – Über das Centreon Web-Interface

Configuration → Commands → Checks → Add

Kommando: Didactum Temperatur

Auf „Describe arguments" klicken und folgende Argumente beschreiben:

Kommando: Didactum Leckage

Kommando: Didactum Sensor-Status allgemein

Variante B – Direkt als Nagios-Konfigurationsdatei

sudo nano /usr/local/nagios/etc/objects/didactum-commands.cfg

# ================================================================
# Didactum SNMP Check-Kommandos – Nagios Konfiguration
# ================================================================

# Temperatursensor mit Warning/Critical-Schwellen
# ARG1 = OID, ARG2 = Warning (×10), ARG3 = Critical (×10)
define command {
    command_name    check_didactum_temperature
    command_line    $USER1$/check_snmp -H $HOSTADDRESS$ \
                    -C $ARG4$ -P 2 \
                    -o $ARG1$ -w $ARG2$ -c $ARG3$ \
                    -l "Temperatur" -u "0.1Grad"
}

# Leckagesensor (0=OK, 1=KRITISCH)
define command {
    command_name    check_didactum_leakage
    command_line    $USER1$/check_snmp -H $HOSTADDRESS$ \
                    -C $ARG2$ -P 2 \
                    -o $ARG1$ -w 0:0 -c 1:1 \
                    -l "Leckage"
}

# Sensor-Status (0=OK, 1=Alarm, 2=Kein Signal)
define command {
    command_name    check_didactum_status
    command_line    $USER1$/check_snmp -H $HOSTADDRESS$ \
                    -C $ARG3$ -P 2 \
                    -o $ARG1$ -w 0:0 -c 1:2 \
                    -l "$ARG2$"
}

# Luftfeuchtigkeit mit Schwellen in %
define command {
    command_name    check_didactum_humidity
    command_line    $USER1$/check_snmp -H $HOSTADDRESS$ \
                    -C $ARG4$ -P 2 \
                    -o $ARG1$ -w $ARG2$ -c $ARG3$ \
                    -l "Luftfeuchtigkeit" -u "%"
}

# Türkontakt (0=geschlossen=OK, 1=offen=WARNING)
define command {
    command_name    check_didactum_door
    command_line    $USER1$/check_snmp -H $HOSTADDRESS$ \
                    -C $ARG2$ -P 2 \
                    -o $ARG1$ -w 1:1 \
                    -l "Tuerkonakt"
}

Variante A – Über das Centreon Web-Interface

Configuration → Services → Add

Service: Temperatursensor

Service: Leckagesensor

Service: Luftfeuchtigkeit

Service: Türkontakt

Service: Temperatursensor-Status

Variante B – Direkt als Nagios-Konfigurationsdatei

sudo nano /usr/local/nagios/etc/objects/didactum-services.cfg

# ================================================================
# Didactum Services – Nagios Konfiguration
# ================================================================

# --- Temperatursensor -------------------------------------------
define service {
    host_name               didactum-monitor-01
    service_description     Didactum Temperatur Sensor 01
    check_command           check_didactum_temperature!.1.3.6.1.4.1.46501.5.1.1.7.101001!280!350!didactum_isyvmon
    max_check_attempts      3
    check_interval          5
    retry_interval          1
    check_period            24x7
    notification_interval   60
    notification_period     24x7
    notification_options    w,c,r
    contact_groups          admins
    servicegroups           didactum-sensoren
}

# --- Temperatursensor-Status -----------------------------------
define service {
    host_name               didactum-monitor-01
    service_description     Didactum Temp Status Sensor 01
    check_command           check_didactum_status!.1.3.6.1.4.1.46501.5.1.1.6.101001!Temp-Status!didactum_isyvmon
    max_check_attempts      3
    check_interval          5
    retry_interval          1
    check_period            24x7
    notification_interval   60
    notification_period     24x7
    notification_options    c,r
    contact_groups          admins
}

# --- Leckagesensor ---------------------------------------------
define service {
    host_name               didactum-monitor-01
    service_description     Didactum Leckage Sensor 01
    check_command           check_didactum_leakage!.1.3.6.1.4.1.46501.5.1.1.7.107001!didactum_isyvmon
    max_check_attempts      1
    check_interval          2
    retry_interval          1
    check_period            24x7
    notification_interval   30
    notification_period     24x7
    notification_options    c,r
    contact_groups          admins
    servicegroups           didactum-sensoren
}

# --- Luftfeuchtigkeit ------------------------------------------
define service {
    host_name               didactum-monitor-01
    service_description     Didactum Luftfeuchtigkeit Sensor 01
    check_command           check_didactum_humidity!.1.3.6.1.4.1.46501.5.1.1.7.102001!80!90!didactum_isyvmon
    max_check_attempts      3
    check_interval          5
    retry_interval          1
    check_period            24x7
    notification_interval   60
    notification_period     24x7
    notification_options    w,c,r
    contact_groups          admins
    servicegroups           didactum-sensoren
}

# --- Türkontakt ------------------------------------------------
define service {
    host_name               didactum-monitor-01
    service_description     Didactum Tuerkonakt 01
    check_command           check_didactum_door!.1.3.6.1.4.1.46501.5.1.1.7.104001!didactum_isyvmon
    max_check_attempts      1
    check_interval          1
    retry_interval          1
    check_period            24x7
    notification_interval   30
    notification_period     24x7
    notification_options    w,r
    contact_groups          admins
    servicegroups           didactum-sensoren
}

define servicegroup {
    servicegroup_name   didactum-sensoren
    alias               Didactum Sensor-Services
}

Nagios/isyVmon empfängt keine Traps direkt. Der Weg führt über snmptrapd → Nagios Passive Check.

Schritt 1 – snmptrapd installieren und konfigurieren

sudo apt install snmptrapd -y
sudo nano /etc/snmp/snmptrapd.conf

authCommunity execute,log,net didactum_isyvmon
traphandle .1.3.6.1.4.1.46501 /etc/nagios/scripts/didactum-trap-handler.sh

Schritt 2 – Trap-Handler-Skript erstellen

sudo mkdir -p /etc/nagios/scripts
sudo nano /etc/nagios/scripts/didactum-trap-handler.sh

#!/bin/bash
# ================================================================
# Didactum SNMP Trap Handler für Nagios/isyVmon
# ================================================================

NAGIOS_CMD="/var/run/nagios/nagios.cmd"
HOST="didactum-monitor-01"
SERVICE="Didactum SNMP Trap"
STATE=2  # CRITICAL

TIMESTAMP=$(date +%s)
MESSAGE="CRITICAL: Didactum SNMP Trap empfangen von $1 – $*"

# Passive Check-Result an Nagios übergeben
echo "[$TIMESTAMP] PROCESS_SERVICE_CHECK_RESULT;$HOST;$SERVICE;$STATE;$MESSAGE" \
    >> $NAGIOS_CMD

sudo chmod +x /etc/nagios/scripts/didactum-trap-handler.sh

Schritt 3 – Passiven Service in Nagios/Centreon anlegen

sudo nano /usr/local/nagios/etc/objects/didactum-trap-service.cfg

define service {
    host_name               didactum-monitor-01
    service_description     Didactum SNMP Trap
    check_command           check_dummy!0!"Warte auf SNMP Traps..."
    active_checks_enabled   0
    passive_checks_enabled  1
    max_check_attempts      1
    check_interval          10
    check_period            24x7
    notification_interval   30
    notification_period     24x7
    notification_options    c,r
    contact_groups          admins
}

Schritt 4 – snmptrapd starten

sudo systemctl enable snmptrapd
sudo systemctl start snmptrapd

Alle Didactum-OIDs beginnen mit .1.3.6.1.4.1.46501 (ältere Firmware) bzw. .1.3.6.1.4.1.39052 (neuere Modelle). Die Sensor-ID wird am Ende angehängt.

OID-Felder je Sensor

Sensortypen mit OIDs

Sensor-ID herausfinden: 

Im Didactum Web-Interface unter Systembaum → Sensor auswählen → Details. Diese ID wird ans Ende der OID angehängt.

Temperaturschwellwerte in check_snmp: 

check_snmp arbeitet mit dem Rohwert. Schwellwerte müssen × 10 eingegeben werden. 28 °C = Eingabewert 280, 35 °C = Eingabewert 350.

MIB-Prefix je Modell: 

Ältere Geräte verwenden .1.3.6.1.4.1.46501, neuere Modelle eventuell .1.3.6.1.4.1.39052. Entnehmen Sie die genauen OIDs der MIB-Datei Ihres Geräts.

Schritt 1 – Kontakt anlegen

Im Centreon/isyVmon Web-Interface:

Configuration → Users → Contacts → Add

Schritt 2 – Kontaktgruppe anlegen

Configuration → Users → Contact Groups → Add
  Group Name: admins
  Members: admin

Schritt 3 – Mailversand auf dem Server sicherstellen

sudo apt install postfix mailutils -y
# Konfigurationstyp wählen: "Internet Site"
# Test:
echo "Testmail isyVmon" | mail -s "Test" admin@ihredomain.de

Schritt 4 – Nagios-Notification-Commands prüfen

# Standard-Commands sind in der Nagios-Konfiguration bereits vorhanden:
grep -A5 "notify-service-by-email" /usr/local/nagios/etc/objects/commands.cfg

Die Standard-Notification-Kommandos von Nagios senden automatisch E-Mails, wenn ein Service den Status WARNING, CRITICAL oder UNKNOWN annimmt und ein Kontakt zugewiesen ist.

Alle Änderungen über das Centreon/isyVmon Web-Interface müssen exportiert werden, damit Nagios sie übernimmt.

Variante A – Über das Centreon Web-Interface (empfohlen)

Configuration → Pollers → Central → Export configuration

Folgende Optionen aktivieren:

• Generate Configuration Files: Ja
• Run monitoring engine debug (-v): Ja (für ersten Test)
• Move Export Files: Ja
• Restart Monitoring Engine: Ja
• Method: Restart

Auf Export klicken. Centreon generiert die Nagios-Konfigurationsdateien und startet Nagios neu.

Variante B – Direkt per Kommandozeile

# Konfiguration auf Syntaxfehler prüfen
sudo nagios -v /usr/local/nagios/etc/nagios.cfg

# Nagios neu laden (kein vollständiger Neustart erforderlich)
sudo systemctl reload nagios

# Bei Fehler: vollständigen Neustart
sudo systemctl restart nagios

# Status prüfen
sudo systemctl status nagios

Variante C – Direkt in isyVmon-Konfigurationsdatei einbinden

sudo nano /usr/local/nagios/etc/nagios.cfg

Folgende Zeilen hinzufügen (falls nicht vorhanden):

cfg_file=/usr/local/nagios/etc/objects/didactum-hosts.cfg
cfg_file=/usr/local/nagios/etc/objects/didactum-commands.cfg
cfg_file=/usr/local/nagios/etc/objects/didactum-services.cfg
cfg_file=/usr/local/nagios/etc/objects/didactum-trap-service.cfg

check_snmp direkt testen

# Temperaturwert (erwartet: SNMP OK - 235)
/usr/lib/nagios/plugins/check_snmp \
    -H 192.168.1.50 -C didactum_isyvmon -P 2 \
    -o .1.3.6.1.4.1.46501.5.1.1.7.101001 \
    -w 280 -c 350 -l "Temperatur"

# Leckage-Status (erwartet: SNMP OK - 0)
/usr/lib/nagios/plugins/check_snmp \
    -H 192.168.1.50 -C didactum_isyvmon -P 2 \
    -o .1.3.6.1.4.1.46501.5.1.1.7.107001 \
    -w 0:0 -c 1:1 -l "Leckage"

Nagios-Konfiguration validieren

sudo nagios -v /usr/local/nagios/etc/nagios.cfg
# Erwartete Ausgabe: "Things look okay - No serious problems..."

Service-Status im Centreon/isyVmon Web-Interface prüfen

Monitoring → Services → By Host
→ Host: didactum-monitor-01
→ Status der Didactum-Services sehen

Fehlermeldungen und Lösungen

Nagios-Log einsehen

sudo tail -f /var/log/nagios/nagios.log
sudo tail -f /var/log/nagios/host-perfdata

Didactum-Gerät

• SNMP aktiviert (v2c oder v3)
• Community String gesetzt (nicht „public")
• Trap-Empfänger-IP auf isyVmon-Server gesetzt
• Trap-Port 162 eingetragen
• MIB-Datei heruntergeladen
• snmpwalk-Test vom isyVmon-Server erfolgreich

isyVmon / Nagios Server

• Pakete snmp, snmp-mibs-downloader, nagios-plugins installiert
• MIB-Datei unter /usr/share/snmp/mibs/ gespeichert
• check_snmp direkt auf der Kommandozeile erfolgreich getestet
• Firewall: UDP 161 ausgehend, UDP 162 eingehend geöffnet

Centreon / isyVmon Web-Interface

• SNMP Community als Host-Makro hinterlegt
• Host „didactum-monitor-01" angelegt (IP, Community, Template)
• Check-Kommandos für alle Sensortypen definiert
• Services für Temperatur, Leckage, Luftfeuchtigkeit, Türkontakt angelegt
• Kontakt mit E-Mail-Adresse und Kontaktgruppe angelegt
• Kontaktgruppe den Services zugewiesen
• Konfiguration exportiert (Configuration → Pollers → Export)

Tests & Validierung

• nagios -v: Konfiguration fehlerfrei
• Monitoring-Ansicht: Services zeigen aktuellen Status
• Temperaturschwellwert: Rohwert × 10 korrekt eingegeben
• Test-Alarm ausgelöst und E-Mail empfangen
• SNMP-Trap-Empfang getestet (optional)