https://techcorner.max-it.de/index.php?action=history&feed=atom&title=OPNsense_-_Netdata_Echtzeit-MonitoringOPNsense - Netdata Echtzeit-Monitoring - Versionsgeschichte2026-10-06T21:35:21ZVersionsgeschichte dieser Seite in maxTechCornerMediaWiki 1.43.9https://techcorner.max-it.de/index.php?title=OPNsense_-_Netdata_Echtzeit-Monitoring&diff=3833&oldid=previmported>TechCorner-Redaktion: Neuer Artikel: Netdata-Plugin (os-netdata 1.2), Stand OPNsense 26.72026-10-06T00:00:00Z<p>Neuer Artikel: Netdata-Plugin (os-netdata 1.2), Stand OPNsense 26.7</p>
<p><b>Neue Seite</b></p><div>{{Steckbrief<br />
| gilt_fuer = OPNsense 26.1/26.7 mit Plugin os-netdata 1.2 (Netdata 2.x)<br />
| bereich = IT-Security<br />
| dauer = ca. 10 Minuten<br />
| rechte = Administrator (OPNsense-WebUI)<br />
| stand = Oktober 2026<br />
}}<br />
'''Netdata''' ist ein Open-Source-Werkzeug für '''Echtzeit-Monitoring''': Es erfasst sekündlich Hunderte Messwerte zu CPU, Arbeitsspeicher, Datenträgern, Netzwerkschnittstellen, Paketen, Interrupts, TCP-Verbindungen und Diensten und stellt sie in einem interaktiven Web-Dashboard dar. Mit dem Plugin '''os-netdata''' läuft Netdata direkt auf der OPNsense – ideal, um Lastspitzen, Engpässe und Fehler auf der Firewall '''live''' zu analysieren, etwa bei Performance-Problemen, DDoS-Verdacht oder nach Hardwarewechseln.<br />
<br />
== Wofür Netdata auf der Firewall? ==<br />
* '''Fehlersuche in Echtzeit:''' Auflösung von einer Sekunde – kurze Lastspitzen, die in klassischen 5-Minuten-Graphen untergehen, werden sichtbar.<br />
* '''Ohne Konfiguration:''' Netdata erkennt Schnittstellen, Datenträger und Systemwerte automatisch.<br />
* '''Alarme:''' Vordefinierte Health-Checks warnen z. B. bei voller Festplatte, hoher Last, Paketverlusten oder Fehlern auf Schnittstellen.<br />
* '''Ergänzung zum Langzeit-Monitoring:''' Für Trends über Wochen und Monate sowie zentrale Alarmierung bleiben Systeme wie Zabbix, LibreNMS oder Prometheus/[[Grafana]] die richtige Wahl – angebunden z. B. per [[OPNsense - Net-SNMP Monitoring per SNMP|SNMP]].<br />
<br />
Die OPNsense bringt unter ''Reporting'' bereits eigene Graphen (Health, Traffic, Insight/NetFlow) mit. Netdata ergänzt diese um deutlich feinere Auflösung und viele zusätzliche Systemmetriken.<br />
<br />
[[Datei:OPNsense-Netdata.png|thumb|center|750px|Netdata auf der OPNsense: Echtzeit-Metriken im Sekundentakt, erreichbar per SSH-Tunnel, über die LAN-Adresse mit Firewall-Regel oder hinter einem Reverse Proxy mit Anmeldung – als Ergänzung zum Langzeit-Monitoring.]]<br />
<br />
== Schritt 1: Plugin installieren ==<br />
'''System → Firmware → Plugins''': '''os-netdata''' installieren und die Seite neu laden. Die Einstellungen befinden sich unter '''Services → Netdata'''.<br />
<br />
== Schritt 2: Netdata konfigurieren ==<br />
{| class="wikitable"<br />
! Feld !! Standard !! Empfehlung<br />
|-<br />
| '''Enable''' || aus || aktivieren<br />
|-<br />
| '''Listen Address''' || <code>127.0.0.1</code> || Standard beibehalten und per SSH-Tunnel zugreifen – oder die LAN- bzw. Management-Adresse der Firewall eintragen (IPv6 möglich)<br />
|-<br />
| '''Listen Port''' || <code>19999</code> || Standard<br />
|}<br />
'''Save''' bzw. '''Apply''' – der Dienst startet.<br />
<br />
{{Hinweis|Das Netdata-Dashboard hat '''keine eigene Anmeldung'''. Jeder, der die Adresse erreicht, sieht alle Messwerte der Firewall – inklusive Schnittstellen, Verbindungen und Prozesse. Netdata daher '''nie''' auf der WAN-Adresse lauschen lassen und den Zugriff per Firewall-Regel auf Administrator-Systeme beschränken.}}<br />
<br />
== Schritt 3: Zugriff einrichten ==<br />
=== Variante A: SSH-Tunnel (sicherste Variante) ===<br />
Bei <code>Listen Address 127.0.0.1</code> ist Netdata nur lokal erreichbar. Vom Admin-PC aus:<br />
<syntaxhighlight lang="bash"><br />
ssh -L 19999:127.0.0.1:19999 root@192.168.10.1<br />
# danach im Browser: http://127.0.0.1:19999<br />
</syntaxhighlight><br />
Voraussetzung ist ein aktivierter SSH-Zugang unter ''System → Settings → Administration'' (idealerweise mit Schlüsseln statt Passwort).<br />
<br />
=== Variante B: Zugriff aus dem Management-Netz ===<br />
# '''Listen Address''' auf die LAN- oder Management-Adresse der Firewall setzen, z. B. <code>192.168.10.1</code>.<br />
# '''Firewall → Rules''', Interface ''LAN'': Pass, TCP, Quelle = Alias ''Admin-PCs'', Ziel ''This Firewall'', Port <code>19999</code>. Andere Quellen nicht freigeben bzw. explizit blockieren.<br />
# Dashboard unter <code><nowiki>http://192.168.10.1:19999</nowiki></code> aufrufen.<br />
<br />
=== Variante C: Hinter einem Reverse Proxy mit Anmeldung ===<br />
Soll das Dashboard per HTTPS mit Anmeldung erreichbar sein, kann es hinter Caddy (Access List, Basic Auth oder Forward Auth mit authentik) bzw. HAProxy/NGINX veröffentlicht werden – Upstream <code>http://127.0.0.1:19999</code>. Details: [[OPNsense - Caddy Reverse Proxy]].<br />
<br />
== Schritt 4: Das Dashboard nutzen ==<br />
* '''Übersicht:''' CPU-Last, Load, RAM, Netzwerk-Durchsatz und Datenträger auf einen Blick.<br />
* '''Network Interfaces:''' Durchsatz, Pakete, Fehler und Drops pro Schnittstelle (z. B. <code>igc0</code>, <code>vlan0.10</code>) – Drops und Fehler deuten auf Überlast, Duplex- oder Kabelprobleme hin.<br />
* '''IPv4/IPv6, TCP:''' Verbindungsaufbau, Resets, SYN-Cookies, ICMP – auffällige Anstiege können auf Scans oder Angriffe hinweisen.<br />
* '''CPU-Details und Interrupts:''' Zeigen, ob einzelne Kerne durch Netzwerk-Interrupts ausgelastet sind (relevant für Tuning bei hohem Durchsatz).<br />
* '''Alerts:''' Aktive und vergangene Alarme der Health-Checks.<br />
Netdata speichert die Messwerte standardmäßig für einen begrenzten Zeitraum lokal; für längere Historie und zentrale Auswertung kann Netdata an Netdata Cloud oder an Prometheus angebunden werden. Seit Netdata 2.x ist dabei das neue Dashboard aktiv; eine Anmeldung bei Netdata Cloud ist für die lokale Nutzung nicht erforderlich.<br />
<br />
== Ressourcen und Betrieb ==<br />
* Netdata ist sehr effizient, belegt aber je nach Anzahl der Metriken einige Prozent CPU und mehrere Hundert MB RAM. Auf kleinen Appliances nur bei Bedarf (z. B. zur Fehlersuche) aktivieren.<br />
* Auf Systemen mit RAM-Disk für <code>/var</code> gehen Daten beim Neustart verloren – das ist für Echtzeit-Analysen unkritisch.<br />
* Updates kommen mit der OPNsense-Firmware bzw. dem Plugin-Paket.<br />
<br />
== Typische Probleme ==<br />
{| class="wikitable"<br />
! Symptom !! Lösung<br />
|-<br />
| Dashboard nicht erreichbar || Listen Address prüfen (Standard nur 127.0.0.1), Firewall-Regel auf Port 19999, Dienststatus unter ''Services → Netdata''.<br />
|-<br />
| Seite lädt, aber keine Daten || Browser-Cache leeren; Netdata nach Firmware-Update neu starten.<br />
|-<br />
| Hohe CPU-Last durch Netdata || Auf schwacher Hardware nur temporär betreiben; alternativ SNMP-basiertes Monitoring nutzen.<br />
|}<br />
<br />
== Fazit ==<br />
Netdata macht aus der OPNsense ein gläsernes System: Jede Lastspitze, jeder Paketverlust und jeder Engpass wird sekundengenau sichtbar. Als Werkzeug für Fehlersuche und Leistungsanalyse ist es hervorragend – solange der Zugriff strikt auf Administratoren beschränkt bleibt. Für Langzeit-Monitoring und Alarmierung ergänzt man es mit einem zentralen System über SNMP.<br />
<br />
== Unterstützung von m.a.x. it ==<br />
Sie möchten Ihre Firewalls und Server zentral überwachen oder Performance-Probleme auf der OPNsense analysieren lassen? m.a.x. it unterstützt Sie mit [https://www.max-it.de/it-services/opnsense/ OPNsense-Firewall-Services von m.a.x. it] und einer [https://www.max-it.de/it-services/managed-firewall/ Managed Firewall von m.a.x. it] inklusive Monitoring.<br />
<br />
== Siehe auch ==<br />
* [[OPNsense - Net-SNMP Monitoring per SNMP]]<br />
* [[OPNsense - Maltrail Erkennung von Schadverkehr]]<br />
* [[OPNsense - Caddy Reverse Proxy]]<br />
* [[Monitoring]]<br />
* [[Grafana]]<br />
* [[Prometheus]]<br />
* [[Installation von InfluxDB und Grafana auf Debian 9]]<br />
<br />
== Links und Quellen ==<br />
* [https://learn.netdata.cloud/ Netdata – offizielle Dokumentation]<br />
* [https://github.com/netdata/netdata Netdata auf GitHub]<br />
* [https://github.com/opnsense/plugins/tree/master/net-mgmt/netdata Quellcode des Plugins os-netdata]<br />
* [https://www.max-it.de/it-services/opnsense/ m.a.x. it – OPNsense-Firewall-Services]<br />
<br />
{{Uebermax}}<br />
[[Kategorie:IT-Security]]<br />
</div>imported>TechCorner-Redaktion