Was ist LAN-Agent
Kurz gesagt: Der LAN-Agent ist ein kleines Programm, das Sie auf einem beliebigen Rechner im internen Netzwerk des Kunden installieren. Über das Internet verbindet er sich mit ePulz.io, fordert die Liste der Adressen an, die er prüfen soll, prüft sie lokal und sendet die Ergebnisse zurück. Dadurch überwachen Sie auch Geräte, an die das Cloud-Monitoring nicht herankommt (NAS, Kameras, interne Server, lokale Webanwendungen).
Wann Sie den LAN-Agent benötigen
- Überwachung von NAS und Heim- oder Firmenservern - Synology, QNAP, eigener Rechner mit ZFS-Speicher
- IP-Kameras, Zutrittssysteme, Alarmanlagen im Geschäft oder Büro
- Interne Webanwendungen - Grafana, Jira, GitLab, Bookstack hinter der Firewall
- Netzwerkinfrastruktur - Router, Switches, Access Points (AP), VPN-Gateway
- IoT-Geräte und Gateways - Modbus- und MQTT-Gateways und Ähnliches
- MSP-Szenario - Verwaltung des Monitorings für mehrere Kunden mit einer einheitlichen Bereitstellung
So funktioniert es
- Im Dashboard erstellen Sie einen Agenten und erhalten ein Token (einen eindeutigen Schlüssel)
epulzio_…- es wird nur einmal angezeigt. - Den Installationsbefehl führen Sie auf einem Gerät im Kundennetzwerk aus (Raspberry Pi, Mini-PC, NAS, ein Rechner mit Docker).
- Alle 30 Sekunden fragt der Agent ePulz.io nach neuen Aufgaben und führt die lokalen Checks aus.
- Die Ergebnisse sendet er über HTTPS zurück - dieselbe sichere Verbindung, die jeder Browser nutzt.
- Wenn sich der Zustand eines Geräts ändert, löst ePulz.io die Standard-Benachrichtigung aus (E-Mail, Telegram, Webhook).
Was der Agent sendet (und was niemals)
Der Agent sendet genau drei Dinge:
- Heartbeat - Agent-Version, Hostname und Name des Betriebssystems
- Ergebnisse der Checks, die Sie selbst eingerichtet haben - up/down-Status, Antwortzeit in ms und gegebenenfalls eine Fehlermeldung
- Sonst nichts. Er scannt niemals das Netzwerk, liest keine Dateien und sammelt weder Datenverkehr noch Gerätedaten. Jede einzelne IP-Adresse, die er anspricht, definieren Sie im Dashboard.
- Eingeschränktes Token: Das Agent-Token erlaubt nur das Herunterladen der eigenen Check-Liste und das Übermitteln der Ergebnisse. Es hat keinen Zugriff auf Ihr Konto, Ihre Abrechnung oder andere Monitore, und Sie können es im Dashboard jederzeit widerrufen (Revoke).
- Läuft ohne Root-Rechte: Der Dienst läuft als unprivilegierter Systembenutzer mit einem systemd-Sandbox (NoNewPrivileges, ProtectSystem=strict). Root wird nur bei der Installation benötigt.
- Vollständig auditierbar: Der gesamte Agent ist eine einzige Python-Datei (~600 Zeilen, nur Standardbibliothek) - vor dem Ausführen können Sie jede Zeile lesen.
Drei Arten von LAN-Checks
| Typ | Ziel | Was er erkennt |
|---|---|---|
| lan_ping | 192.168.1.10 | Das Gerät antwortet auf ICMP (ein einfacher Netzwerktest). Der günstigste Check. |
| lan_tcp | 10.0.0.50:5432 | Ein bestimmter Port ist offen. Auch wenn das Gerät läuft, kann der Dienst selbst (Datenbank, SSH und Ähnliches) ausgefallen sein. |
| lan_http | http://nas.local | Die HTTP- oder HTTPS-Anwendung antwortet korrekt (Codes 2xx/3xx). Geeignet für eine NAS-Oberfläche oder ein internes Dashboard. |
Was passiert, wenn ein Agent ausfällt
ePulz.io prüft jede Minute, ob die Agenten ein Lebenszeichen (Heartbeat) senden. Wenn sich ein Agent länger als 5 Minuten nicht meldet, erhalten Sie eine E-Mail und eine Telegram-Nachricht: "LAN-Agent X ist offline". Wenn der Agent zurückkehrt, erhalten Sie eine Bestätigung, dass er wieder online ist. So passiert es Ihnen nicht, dass Sie den falschen Eindruck haben, alles würde laufen, nur weil ein Agent keine Daten mehr sendet.
Loslegen
Im nächsten Schritt zeigen wir Ihnen die Installation des Agenten und das Erstellen des ersten LAN-Monitors.
Nächster Schritt:
Installation des LAN-Agenten auf einem Gerät im Kundennetzwerk.
Agent installieren ->