Skip to main content

Network Topology Monitoring

The src/network-metrics module provides a live snapshot of the network infrastructure in which the system operates. Unlike "telemetry" which comes from the devices themselves, this module runs on the server and scans its own environment.

Automatic Discovery​

The active part (network-topology.engine.ts) performs:

  1. ICMP Ping: Checking availability of the default gateway and external DNS servers (8.8.8.8) to identify internet connection.
  2. Interface Scanning: Mapping all server network cards (NICs) (IP addresses, MAC).

Graph Mapping (Nodes & Edges)​

The system builds a network graph for visual use in the Dashboard:

  • Nodes: The server itself, router (Gateway), Internet (Cloud), and identified devices.
  • Edges (Connections): Lines representing the logical relationship, including Latency data and estimated bandwidth.

Use Cases​

  • Troubleshooting: Identifying whether slowness is due to ISP disconnection or server load itself.
  • Alerts: Creating an alert when the Gateway is unavailable but the server is operational (LAN issue).