Features Deep Dive - skydashnet/skydash-monitoring GitHub Wiki

Features Deep Dive

This page provides a more detailed explanation of the key features available in Skydash.NET and the underlying technology that powers them.

1. Real-time Dashboard

The core of Skydash.NET is its real-time dashboard, which provides live insights into your MikroTik device's performance.

  • Live Metrics: The dashboard displays real-time CPU load, RAM usage, and network uptime.
  • Traffic Graphs: It features interactive charts for monitoring live upload and download speeds on active Ethernet interfaces. It also includes a dedicated table for monitoring active PPPoE user traffic.
  • WebSocket Powered: All real-time data is pushed from the backend to the frontend using a persistent WebSocket connection, managed by the ws library on the server and handled by the MikrotikProvider on the client. This ensures low latency and high-frequency updates without constant HTTP polling.

2. User Management (PPPoE & Hotspot)

Skydash.NET offers comprehensive management modules for both PPPoE and Hotspot services.

  • PPPoE Management:
    • View a summary of total, active, and inactive secrets.
    • See a complete list of all configured PPPoE secrets and their current status.
    • (New) Usernames in the list are now clickable, leading to a dedicated User Detail Page that shows specific information about that user, including their connected ODP asset.
    • Add new PPPoE users with an intelligent IP allocation system from a predefined pool.
  • Hotspot Management:
    • View a summary of total registered and currently active Hotspot users.
    • Monitor a live list of active users, including their uptime, data usage for the session, and live upload/download speeds.
    • Generate bulk hotspot vouchers with a specific user profile.

3. Asset Management & GIS Mapping

Visualize and manage your physical network infrastructure with an integrated mapping system.

  • Asset CRUD: Perform full Create, Read, Update, and Delete operations for network assets like ODP, ODC, JoinBox, and Servers.
  • Interactive Map: All assets are plotted on an interactive Leaflet map, with custom icons for each asset type, making it easy to visualize your network topology.
  • KML Import: Bulk-import assets directly from a .kml file (e.g., from Google Earth). The system automatically parses the file and creates the assets in your workspace.
  • Asset-to-User Connection: Link PPPoE users to specific ODP assets to easily track which user is connected to which distribution point.

4. WhatsApp Bot Interaction

Control and monitor your network on the go using the integrated WhatsApp Bot.

  • Setup: The bot is powered by @whiskeysockets/baileys and can be enabled or disabled from the settings page.

  • (New) Advanced Commands: The bot's capabilities have been significantly expanded:

    • .reboot: Securely reboot the active router with a two-step confirmation (.reboot then .reboot confirm).
    • .backup <filename>: Create a configuration backup of the router and save it on the device with the specified name.
    • .speedtest: Intelligently finds the best server and runs a live internet speed test, returning Ping, Jitter, Download, and Upload speeds.
  • (New) Proactive Alarms: The bot can now act as a 24/7 network guard.

    • CPU Load Alarm: Set a threshold (e.g., .set alarm cpu 85) to get a notification if the router's CPU usage is too high.
    • Device Offline Alarm: Enable notifications (.set alarm offline) to be alerted immediately if the application cannot connect to your active router.

5. Security & Authentication

Security is a core aspect of Skydash.NET.

  • 2FA Login: User authentication is secured with a two-factor authentication system that sends a one-time password (OTP) to the user's registered WhatsApp number upon login.
  • Session Management: Users can view all their active sessions across different devices and browsers, with the ability to terminate any session remotely for added security.
  • Secure Password Handling: All user passwords are securely hashed using bcrypt.js before being stored in the database.

6. Workspace & Device System

The application is designed for multi-device and multi-user environments.

  • Multi-Device Support: Add and manage multiple MikroTik devices within a single workspace.
  • Active Device Selection: Choose which device is currently being monitored by the dashboard and the bot.
  • Workspace Cloning: Easily share your entire workspace setup (including devices, assets, IP pools, etc.) with another user by generating a temporary, unique code.

7. (New) Network Inspection Tools

  • ARP Table Viewer: A dedicated page to view the live ARP table from the active MikroTik device. This is crucial for identifying all connected devices, diagnosing IP conflicts, and enhancing network security.
⚠️ **GitHub.com Fallback** ⚠️