Vollständige Schritt-für-Schritt-Anleitung zur Einbindung von Didactum Monitoring-Geräten und Sensoren in Argus (System and Network Monitoring Software) via SNMP – inklusive Konfigurationsdatei-Syntax, SNMP-Service-Definitionen für alle Sensortypen, Notifications und Web-Interface.

Hinweis zu Argus: 

Argus ist eine leichtgewichtige, Open-Source Monitoring-Software von Jeff Weisberg. Die gesamte Konfiguration erfolgt ausschließlich über Textdateien. Es gibt kein Web-Konfigurationsinterface – alle Einstellungen werden direkt in der Konfigurationsdatei vorgenommen. Argus erkennt Änderungen automatisch und lädt die Konfiguration ohne Neustart neu.

• Software: Argus 5.x (argus.tcp4me.com / github.com/jaw0/argus5)
• Konfiguration: Textdatei (/etc/argus/argus.conf oder eigener Pfad)
• Protokoll: SNMP v1 / v2c / v3 (nativ integriert – kein externes Plugin)
• Geräte: Didactum Monitoring System 100T / 300T / 500T / 550T
• Sensoren: Temperatur, Leckage, Luftfeuchtigkeit, Türkontakt, Rauch

Argus-Server

• Linux (Ubuntu 20.04 / 22.04 LTS oder Debian 11/12)
• Golang 1.18+ (für Argus 5.x – wird als Go-Binary kompiliert)
• Pakete: snmp, snmp-mibs-downloader
• UDP-Port 161 ausgehend für SNMP-Polling geöffnet
• TCP-Port für Web-Interface (Standard: 2055) geöffnet
• Netzwerkzugang zum Didactum-Gerät

Didactum-Gerät

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

Architektur & Datenfluss

[Argus Server]                   [Didactum Monitoring System]
  IP: 192.168.1.10                 IP: 192.168.1.50
  Port 2055 (Web-Interface)
  /etc/argus/argus.conf
                    --SNMP UDP/161 Polling-->
                    <-- SNMP Response ------

Wichtige Argus-Verzeichnisse & Dateien

/etc/argus/argus.conf           <-- Hauptkonfiguration (oder eigener Pfad)
/etc/argus/conf.d/              <-- Modulare Konfigurationsdateien (optional)
/var/argus/                     <-- Datenverzeichnis (Logs, RRD-Daten)
/usr/local/bin/argus            <-- Argus-Binary

Argus-Konfigurationsprinzip

Argus verwendet eine hierarchische Konfigurationsstruktur. Werte vererben sich von übergeordneten Gruppen an enthaltene Services. Dies macht die Konfiguration sehr kompakt: ein Community-String in einer Gruppe gilt automatisch für alle enthaltenen SNMP-Services.

Reihenfolge in der Konfigurationsdatei:
1. Globale Parameter (syslog, notify, webport, ...)
2. Notification-Methoden
3. Gruppen (Group) und Services (Service)

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

Einstellungen speichern. Argus unterstützt keine nativen SNMP-Traps (nur aktives Polling). Für Trap-Empfang muss ein externer snmptrapd + Skript eingesetzt werden (siehe Abschnitt 8).

Variante A – Aus dem Quellcode kompilieren (Argus 5.x / Go)

# Go installieren (falls nicht vorhanden)
sudo apt update
sudo apt install -y golang git snmp snmp-mibs-downloader

# Argus 5.x aus GitHub holen
git clone github.com/jaw0/argus5.git
cd argus5

# Kompilieren
go build -o argus ./cmd/argus/

# Binary installieren
sudo cp argus /usr/local/bin/
sudo chmod +x /usr/local/bin/argus

# Version prüfen
argus -v

Variante B – Ältere Argus-Version (Perl/C-basiert, vor Version 5)

# Download von argus.tcp4me.com/download.html
wget argus.tcp4me.com/download/argus-latest.tar.gz
tar xzf argus-latest.tar.gz
cd argus-*/
./configure
make
sudo make install

Konfigurationsverzeichnis anlegen

sudo mkdir -p /etc/argus
sudo mkdir -p /var/argus
sudo chown argus:argus /var/argus 2>/dev/null || true

Systemd-Service einrichten (für automatischen Start)

sudo nano /etc/systemd/system/argus.service

[Unit]
Description=Argus Network Monitoring
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/argus -c /etc/argus/argus.conf
Restart=always
RestartSec=10
User=root

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable argus

Schritt 1 – MIB aus dem Didactum Web-Interface laden

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

Schritt 2 – MIB auf dem Argus-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

Schritt 3 – SNMP-Verbindung testen (vor Argus-Konfiguration)

# Alle Sensor-OIDs auflisten
snmpwalk -v 2c -c didactum_argus 192.168.1.50 .1.3.6.1.4.1.46501.5.1.1

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

# Leckage-Status abfragen (0=trocken, 1=Wasser)
snmpget -v 2c -c didactum_argus 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1.7.107001

Erscheinen Werte ohne Fehlermeldung, ist SNMP bereit für Argus.

Schritt 1 – Konfigurationsdatei anlegen

sudo nano /etc/argus/argus.conf

Schritt 2 – Globale Parameter eintragen

# ================================================================
# Argus Monitoring – Globale Konfiguration
# Datei: /etc/argus/argus.conf
# Dokumentation: jaw0.github.io/argus5docs/docs/
# ================================================================

# Syslog-Facility für Argus-Meldungen
syslog:         local1

# Web-Interface Port (Argus eigenes Web-UI)
# Erreichbar unter: 192.168.1.10
port:           2055

# Datenverzeichnis
datadir:        /var/argus

# Standard-Prüfintervall (Sekunden)
frequency:      300

# Standard-Wiederholungsversuche bei Fehler
retries:        3

# Standard-Timeout (Sekunden)
timeout:        10

# ----------------------------------------------------------------
# Benachrichtigungen
# ----------------------------------------------------------------
# E-Mail-Benachrichtigung bei Service-Ausfall
notify:         mail:admin@ihredomain.de

# Optionale zweite Benachrichtigungsmethode
# notify:       mail:monitoring-team@ihredomain.de

# ----------------------------------------------------------------
# Notification-Methoden Definition
# ----------------------------------------------------------------
Notif "email-admin" {
    send:       mail
    address:    admin@ihredomain.de
}

Die gesamte Didactum-Konfiguration wird als Gruppen-Struktur in der Konfigurationsdatei definiert. Werte wie hostname und community werden von der übergeordneten Gruppe an alle enthaltenen Services vererbt.

Vollständige Didactum-Konfiguration

Den folgenden Block ans Ende der argus.conf anfügen (nach den globalen Parametern):

# ================================================================
# Didactum Monitoring System – Argus Konfiguration
# ================================================================

Group "Didactum" {

    # ============================================================
    # Didactum Monitor 01
    # IP und Community werden an alle enthaltenen Services vererbt
    # ============================================================
    Group "Monitor-01" {
        hostname:   192.168.1.50
        community:  didactum_argus

        # Grundprüfung: Ist das Gerät erreichbar?
        Service Ping {
            info:       Didactum Monitoring System 01
            frequency:  60
        }

        # --------------------------------------------------------
        # Temperatursensor 01 (digital, Sensor-ID 101001)
        # Rohwert ÷ 10 = Grad Celsius
        # Warnung ab 28,0 °C (OID-Wert 280)
        # Kritisch ab 35,0 °C (OID-Wert 350)
        # --------------------------------------------------------
        Service UDP/SNMPv2c {
            label:      Temperatur-Sensor-01
            info:       Raumtemperatur Serverraum (Rohwert x0.1 = Grad C)
            oid:        .1.3.6.1.4.1.46501.5.1.1.7.101001
            maxvalue:   280
            frequency:  300
        }

        # Temperatursensor-Status (0=OK, 1=Alarm, 2=Kein Signal)
        Service UDP/SNMPv2c {
            label:      Temp-Status-Sensor-01
            info:       Status Temperatursensor 01 (0=OK 1=Alarm 2=Fehler)
            oid:        .1.3.6.1.4.1.46501.5.1.1.6.101001
            maxvalue:   0
            frequency:  300
        }

        # --------------------------------------------------------
        # Leckagesensor 01 (Sensor-ID 107001)
        # 0 = trocken = OK
        # 1 = Wasser erkannt = DOWN (maxvalue: 0 → Alarm bei Wert > 0)
        # --------------------------------------------------------
        Service UDP/SNMPv2c {
            label:      Leckage-Sensor-01
            info:       Wassersensor 01 – 0=trocken 1=Wasser erkannt
            oid:        .1.3.6.1.4.1.46501.5.1.1.7.107001
            maxvalue:   0
            frequency:  120
            retries:    1
        }

        # --------------------------------------------------------
        # Luftfeuchtigkeit 01 (Sensor-ID 102001)
        # Wert direkt in % (kein Teiler)
        # Warnung ab 80 %, kritisch ab 90 %
        # --------------------------------------------------------
        Service UDP/SNMPv2c {
            label:      Luftfeuchtigkeit-Sensor-01
            info:       Luftfeuchtigkeit Serverraum (direkt in %)
            oid:        .1.3.6.1.4.1.46501.5.1.1.7.102001
            maxvalue:   80
            frequency:  300
        }

        # --------------------------------------------------------
        # Türkontakt 01 (Sensor-ID 104001)
        # 0 = geschlossen = OK
        # 1 = geöffnet = Warnung
        # --------------------------------------------------------
        Service UDP/SNMPv2c {
            label:      Tuerkonakt-01
            info:       Tuerkonakt 01 – 0=geschlossen 1=geoeffnet
            oid:        .1.3.6.1.4.1.46501.5.1.1.7.104001
            maxvalue:   0
            frequency:  60
        }

        # --------------------------------------------------------
        # Rauchmelder 01 (Sensor-ID 106001)
        # 0 = kein Rauch = OK
        # 1 = Alarm = DOWN
        # --------------------------------------------------------
        Service UDP/SNMPv2c {
            label:      Rauchmelder-01
            info:       Rauchmelder 01 – 0=OK 1=Alarm
            oid:        .1.3.6.1.4.1.46501.5.1.1.7.106001
            maxvalue:   0
            frequency:  60
            retries:    1
        }

        # --------------------------------------------------------
        # Analoger Temperatursensor (neuere Didactum-Modelle)
        # Enterprise OID: .1.3.6.1.4.1.39052
        # --------------------------------------------------------
        # Service UDP/SNMPv2c {
        #     label:    Temp-Analog-Sensor-01
        #     info:     Analoger Temperatursensor (Rohwert x0.1 = Grad C)
        #     oid:      .1.3.6.1.4.1.39052.5.2.1.7.201001
        #     maxvalue: 280
        # }

        # --------------------------------------------------------
        # Potentialfreier Kontakt (Sensor-ID 101003)
        # 0 = offen, 1 = geschlossen
        # --------------------------------------------------------
        # Service UDP/SNMPv2c {
        #     label:    Kontakt-01
        #     info:     Potentialfreier Kontakt 01
        #     oid:      .1.3.6.1.4.1.39052.5.1.1.7.101003
        #     maxvalue: 0
        # }

    }
    # Ende Group "Monitor-01"


    # ============================================================
    # Didactum Monitor 02 (zweites Gerät – auskommentiert)
    # ============================================================
    # Group "Monitor-02" {
    #     hostname:   192.168.1.51
    #     community:  didactum_argus
    #
    #     Service Ping
    #
    #     Service UDP/SNMPv2c {
    #         label:    Temperatur-Sensor-01
    #         oid:      .1.3.6.1.4.1.46501.5.1.1.7.101001
    #         maxvalue: 280
    #     }
    #     Service UDP/SNMPv2c {
    #         label:    Leckage-Sensor-01
    #         oid:      .1.3.6.1.4.1.46501.5.1.1.7.107001
    #         maxvalue: 0
    #     }
    # }

}
# Ende Group "Didactum"

Erläuterung der wichtigsten Parameter

Temperaturschwellwerte – Wichtiger Hinweis

Das Didactum-Gerät überträgt Temperaturwerte als Rohwert × 10. 25,5 °C entspricht dem OID-Wert 255. Argus vergleicht den Rohwert direkt, daher müssen alle Schwellwerte ebenfalls × 10 angegeben werden:

Erweiterte Konfiguration: Zweistufige Temperaturüberwachung

Argus unterstützt keinen separaten Warning/Critical-Zustand nativ. Für zweistufige Überwachung können zwei separate Services definiert werden:

# Warnung: Temperatur über 28°C
Service UDP/SNMPv2c {
    label:      Temp-Warnung-28Grad
    info:       Warnung: Temperatur über 28.0 Grad C
    oid:        .1.3.6.1.4.1.46501.5.1.1.7.101001
    maxvalue:   280
    frequency:  300
}

# Kritisch: Temperatur über 35°C (niedrigere Frequenz, sofortiger Alarm)
Service UDP/SNMPv2c {
    label:      Temp-Kritisch-35Grad
    info:       KRITISCH: Temperatur über 35.0 Grad C!
    oid:        .1.3.6.1.4.1.46501.5.1.1.7.101001
    maxvalue:   350
    frequency:  60
    retries:    1
}

Argus unterstützt SNMPv3 nativ über den Service-Typ UDP/SNMPv3. Alle SNMPv3-Parameter vererben sich ebenfalls von Gruppen an Services.

Group "Didactum-v3" {
    hostname:       192.168.1.50

    # SNMPv3 Zugangsdaten (werden an alle enthaltenen Services vererbt)
    snmpuser:       isyvmon_user
    snmppass:       IhrAuthPasswort
    snmpauth:       SHA
    snmpprivpass:   IhrPrivPasswort
    snmppriv:       AES

    Service Ping

    Service UDP/SNMPv3 {
        label:      Temperatur-Sensor-01-v3
        info:       Temperatursensor mit SNMPv3 Verschlüsselung
        oid:        .1.3.6.1.4.1.46501.5.1.1.7.101001
        maxvalue:   280
        frequency:  300
    }

    Service UDP/SNMPv3 {
        label:      Leckage-Sensor-01-v3
        info:       Leckagesensor mit SNMPv3 Verschlüsselung
        oid:        .1.3.6.1.4.1.46501.5.1.1.7.107001
        maxvalue:   0
        frequency:  120
    }
}

Argus sendet Benachrichtigungen wenn ein Service als DOWN erkannt wird. Notifications können global oder pro Gruppe bzw. Service definiert werden.

Globale Notification (gilt für alle Services)

# Am Anfang der argus.conf eintragen:
notify:     mail:admin@ihredomain.de

Notification nur für Didactum-Gruppe

Group "Didactum" {
    hostname:   192.168.1.50
    community:  didactum_argus

    # Nur für diese Gruppe und ihre Services
    notify:     mail:datacenter-team@ihredomain.de

    Service UDP/SNMPv2c {
        label:    Leckage-Sensor-01
        oid:      .1.3.6.1.4.1.46501.5.1.1.7.107001
        maxvalue: 0
        # Dieser Service überschreibt die Gruppen-Notification:
        notify:   mail:notfall@ihredomain.de
    }
}

Notification-Methoden definieren

# In der argus.conf – nach den globalen Parametern, vor den Groups:

# E-Mail via lokalen Mailserver
Notif "email-admin" {
    send:       mail
    address:    admin@ihredomain.de
}

# Mehrere Empfänger
Notif "email-team" {
    send:       mail
    address:    admin@ihredomain.de
    address:    monitoring@ihredomain.de
}

# Externes Skript aufrufen (z.B. für SMS oder Slack)
Notif "alarm-skript" {
    send:       exec
    exec:       /etc/argus/scripts/didactum-alarm.sh
}

Alarm-Skript für erweiterte Benachrichtigung

sudo mkdir -p /etc/argus/scripts
sudo nano /etc/argus/scripts/didactum-alarm.sh

#!/bin/bash
# ================================================================
# Didactum Alarm-Skript für Argus
# Argus übergibt: $1 = Service-Name, $2 = Status, $3 = Info
# ================================================================

SERVICE="$1"
STATUS="$2"
INFO="$3"
EMPFAENGER="admin@ihredomain.de"

BETREFF="[Didactum ALARM] $SERVICE ist $STATUS"
NACHRICHT="Zeitpunkt: $(date '+%Y-%m-%d %H:%M:%S')
Service:   $SERVICE
Status:    $STATUS
Info:      $INFO
Server:    Didactum Monitor (192.168.1.50)"

echo "$NACHRICHT" | mail -s "$BETREFF" "$EMPFAENGER"

sudo chmod +x /etc/argus/scripts/didactum-alarm.sh

Postfix für Mailversand installieren

sudo apt install postfix mailutils -y
# Konfigurationstyp: "Internet Site" oder "Satellite system"
# Test:
echo "Test Argus Monitoring" | mail -s "Test" admin@ihredomain.de

Argus bringt ein eigenes, eingebautes Web-Interface mit. Es zeigt den Status aller konfigurierten Services in Echtzeit. Kein Apache, Nginx oder anderer Webserver wird benötigt.

Schritt 1 – Web-Port in argus.conf setzen

# In der argus.conf (globale Parameter):
port:   2055

Schritt 2 – Argus starten

sudo argus -c /etc/argus/argus.conf

# oder als Systemd-Dienst:
sudo systemctl start argus

Schritt 3 – Web-Interface aufrufen

192.168.1.10

Das Web-Interface zeigt alle konfigurierten Gruppen und Services. Grüne Einträge = OK, rote Einträge = DOWN.

Schritt 4 – Firewall für Web-Port öffnen

sudo ufw allow 2055/tcp
sudo ufw allow 161/udp  # SNMP ausgehend (falls UFW genutzt)

Web-Interface absichern (optional)

# Zugriffskontrolle in argus.conf:
# Nur bestimmte IP-Adressen dürfen das Web-Interface aufrufen
allow:  192.168.1.0/24
deny:   all

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 und Argus-Parametern

Sensor-ID herausfinden: 

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

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.

eqvalue als Alternative: 

Statt maxvalue: 0 kann für Binär-Sensoren (Leckage, Rauch) auch eqvalue: 0 genutzt werden – der Service ist dann nur UP wenn der Wert exakt 0 ist.

Argus-Konfiguration testen (ohne Start)

# Konfiguration auf Syntaxfehler prüfen
argus -c /etc/argus/argus.conf -t

# Argus im Vordergrund mit Debug-Ausgabe starten
argus -c /etc/argus/argus.conf -d
# Mit Strg+C beenden

Argus-Dienst starten und Status prüfen

sudo systemctl start argus
sudo systemctl status argus

# Logs einsehen
sudo journalctl -u argus -f --since "10 minutes ago"

# Syslog (wenn syslog: local1 gesetzt)
sudo tail -f /var/log/syslog | grep argus

SNMP direkt testen

# Einfacher Verbindungstest
snmpget -v 2c -c didactum_argus 192.168.1.50 sysDescr.0

# Temperaturwert abfragen
snmpget -v 2c -c didactum_argus 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1.7.101001

# Alle Sensoren auflisten
snmpwalk -v 2c -c didactum_argus 192.168.1.50 \
    .1.3.6.1.4.1.46501.5.1.1

# SNMPv3 testen
snmpget -v 3 -l authPriv -u isyvmon_user \
    -a SHA -A "IhrAuthPasswort" \
    -x AES -X "IhrPrivPasswort" \
    192.168.1.50 .1.3.6.1.4.1.46501.5.1.1.7.101001

Web-Interface prüfen

# Browser öffnen:
192.168.1.10

# Oder per curl testen:
curl -s 192.168.1.10 | head -20

Konfiguration nach Änderung neu laden

# Argus erkennt Dateiänderungen automatisch.
# Falls sofortige Übernahme gewünscht:
sudo systemctl reload argus
# oder:
sudo kill -HUP $(pgrep argus)

Didactum-Gerät

• SNMP aktiviert (v2c oder v3)
• Community String gesetzt (nicht „public"): didactum_argus
• SNMP-Port 161 zugänglich
• MIB-Datei heruntergeladen
• snmpwalk-Test vom Argus-Server erfolgreich

Argus-Server

• Argus 5.x installiert und Binary unter /usr/local/bin/argus vorhanden
• Pakete snmp, snmp-mibs-downloader installiert
• MIB-Datei unter /usr/share/snmp/mibs/ gespeichert
• UDP-Port 161 ausgehend geöffnet
• TCP-Port 2055 für Web-Interface geöffnet
• Postfix / Mailversand funktioniert (Test-Mail erhalten)

Argus-Konfiguration

• /etc/argus/argus.conf angelegt
• Globale Parameter: syslog, port, notify, frequency gesetzt
• Group "Didactum" → Group "Monitor-01" mit hostname und community
• Service Ping für Erreichbarkeitsprüfung
• UDP/SNMPv2c-Service für Temperatursensor (maxvalue × 10)
• UDP/SNMPv2c-Service für Leckagesensor (maxvalue: 0)
• UDP/SNMPv2c-Service für Luftfeuchtigkeit
• UDP/SNMPv2c-Service für Türkontakt
• UDP/SNMPv2c-Service für Rauchmelder
• Konfiguration mit argus -t validiert (kein Fehler)

Tests & Betrieb

• Argus-Dienst läuft: systemctl status argus
• Web-Interface erreichbar: 192.168.1.10
• Alle Didactum-Services erscheinen grün im Web-Interface
• Temperaturschwellwert korrekt (Rohwert × 10 berücksichtigt)
• Test-Alarm ausgelöst und E-Mail empfangen
• Systemd autostart aktiviert: systemctl enable argus