TP-Link VX231v Tracker - Dokumentation
Eine Sammlung von Python-Skripten zur Erfassung, Speicherung und Visualisierung der Router-Daten.
Ausgangspunkt war der Bedarf, DSL-Leitungswerte und verbundene Netzwerk-Clients kontinuierlich aufzuzeichnen, um Verbindungsabbrüche und Fehlerraten im zeitlichen Verlauf nachvollziehen zu können.
Da der TP-Link VX231v keine offizielle API für diese Zwecke bereitstellt, automatisiert dieses Skript-Set den Datenabruf über die am Router verfügbaren Schnittstellen.
Ist auf dem Router der superadmin-Zugang aktiviert (Zur Anleitung) können die Leitungswerte per Telnet und SNMP in Sekunden erfasst werden.
Für Daten, die darüber nicht zugänglich sind oder falls der superadmin-Zugang nicht aktiviert ist, erfolgt ein automatisiertes Auslesen der Daten aus der Weboberfläche des Router, was allerdings deutlich länger dauert.
Beispiel für einen Statusreport
Beispiel für das Browser-Dashboard
Funktionsumfang
- Datenerfassung: Automatisierter Abruf von Systemzuständen, DSL-Werten und Client-Listen primär per Telnet und SNMP. Für Daten, die darüber nicht zugänglich sind, erfolgt ein Auslesen der Weboberfläche des Routers.
- Datenspeicherung: Alle erfassten Messwerte, verbundenen Geräte und System-Logs werden fortlaufend in einer SQLite-Datenbank gespeichert.
- Reporting: Die gesammelten Daten der letzten 24 Stunden können als HTML-Statusbericht aufbereitet werden. Der Bericht enthält unter anderem aktuelle Verbindungsparameter, Auszüge aus dem Event-Log und ein Anwesenheitsdiagramm der Clients. Der Versand kann automatisiert per E-Mail erfolgen.
- Lokales Browser-Dashboard: Ein integrierter lokaler Webserver ermöglicht die interaktive grafische Visualisierung der historisierten DSL-Parameter über frei wählbare Zeiträume.
Dokumentationsübersicht
- Setup & Installation - Systemvoraussetzungen (inkl. Aktivierung des Superadmin-Zugangs) und Installation.
- Konfiguration - Syntax der
config.ini, Startparameter und Einrichtung der automatisierten Ausführung. - Auswertungen - Statusreport - Erläuterung der Inhalte und Parameter des generierten HTML-Berichts.
- Auswertungen - Browser-Dashboard - Nutzung der lokalen, interaktiven Ansicht für historische Daten.
- Lokalisierung - Anleitung zur Anpassung der Tabellenansicht auf andere Sprachen.
Weitere Informationen unter vx-info.md.