Skip to content

networkables/mason

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mason

Mason mascot

The network toolbox


Mason is a network discovery and monitoring tool. It includes common network tools such as ping, traceroute, and snmp data fetching providing visibility of networks. Discovered devices are reguarly monitored by ping with historical data graphed for analysis.

Go Report Card


Quickstart

  1. Download pre-built binary (coming soon)
  2. Grant admin network permissions to the binary (instead of running mason as root): sudo ./mason sys setcap
  3. Start Mason as a server: ./mason server
  4. Open a browser at http://localhost:4380/

Features

  • Single binary with no external runtime dependencies
  • Can be used as a server or a cli tool
  • Multiple core networking tools
    • Ping
    • Traceroute
    • SNMP
    • DNS Checks
    • TCP Port Scaning
    • TLS certificate information
  • Default configuration designed to be productive on the initial run
  • Core tools are additional exposed via command line and as network services
  • Built in Web and Terminal UIs
  • Low memory requirements ( 25-50 MB )
  • Discovery Techniques
    • ARP Requests over address space for local LANs
    • Ping (ICMPv4) requests over address space for known/discovered networks
    • SNMP probes for ARP tables and network interfaces on discovered devices
  • Device monitoring
    • Ping requests on regular intervals with recording of response time statistics
    • Different monitoring intervals for servers vs. client devices
  • Charting of ping response times over time

Screenshots

Dashboard / Start Page

Mason Dashboard

Device

Devices List Mason Devices Table

Device Detail Mason Device Detail

Device Detail (Ping Response Time) Mason Device Detail Ping

Tools

Ping Mason Tools Ping

Traceroute Mason Tools Traceroute

TLS Information Mason Tools TLS

Support

Mason is still in initial development and has plenty of rough edges. If you find a bug or have an issue, please open an Github issue.

nettools library

The nettools package contains the basic network tools so you can build your own network tooling

  • Send and receive ARP requests
  • DNS resolution
  • Send and receive ICMP4 Echo requests
  • TCP Port scanning for a target
  • SNMP information retrival
  • TLS certiicate fetching and details parsing
  • Traceroute using ICMP4 to a target