How akkadius/glass-isc-dhcp works
Glass is a web interface and REST API for monitoring and administering an ISC DHCP server. Operators view live lease and pool statistics, search lease details, inspect streamed DHCP logs, edit and snapshot configuration, and control the server; administrative actions can be protected by Basic authentication. Runtime monitoring parses lease and log data, enriches MAC addresses with OUI vendors, and supports threshold alerts. The README documents alert destinations and capabilities not fully visible in the sampled code; those relationships are shown only where documented.
Main entry points: app.js Glass server · authorize.js Admin authorization · dhcp-leases.js Lease file reader · dhcp-log-watcher.js DHCP log watcher
Components 23
Web and API
- Glass server
app.js - Dashboard
routes/index.js - REST API
api
DHCP Monitoring
- Pool statistics
routes/get_stats.js - Active lease API
api/get_active_leases.js - Lease search
routes/dhcp_lease_search.js - Lease file reader
core/dhcp-leases.js - Lease parser
core/lease-parser.js - OUI lookup
core/oui-reader.js - DHCP log watcher
core/dhcp-log-watcher.js - WebSocket streaming
app.js
Administration
- Configuration editor
routes/dhcp_config_save.js - Config snapshots
routes/dhcp_config_snapshots.js - Service controls
routes/dhcp_start_stop_restart.js - Admin authorization
core/authorize.js
Alerts and Settings
- Alert settings
routes/glass_alerts.js - Alert configuration
routes/glass_alert_settings_save.js - Threshold alerting
app.js - Alert delivery
app.js
Other components
- Network operator
- DHCP files and logs
- ISC DHCP server
- Email, Slack, SMS
Connections 27
- Network operator → Glass server: uses
README.md - Glass server → Dashboard: routes requests
app.js - Glass server → Pool statistics: routes requests
app.js - Glass server → REST API: serves endpoints
app.js - REST API → Active lease API: exposes
api/get_active_leases.js - Network operator → Lease search: searches leases
README.md - Active lease API → Lease parser: cleans leases
api/get_active_leases.js - Lease search → Lease file reader: reads lease data
routes/dhcp_lease_search.js - Lease file reader → Lease parser: parses leases
core/dhcp-leases.js - Lease file reader → DHCP files and logs: reads leases
- Lease parser → OUI lookup: looks up vendors
core/lease-parser.js - Network operator → DHCP log watcher: views live logs
README.md - DHCP log watcher → WebSocket streaming: broadcasts logs
core/dhcp-log-watcher.js - WebSocket streaming → Network operator: streams logs
README.md - DHCP log watcher → DHCP files and logs: tails log
core/dhcp-log-watcher.js - Network operator → Configuration editor: edits configuration
README.md - Configuration editor → Admin authorization: checks access
routes/dhcp_config_save.js - Network operator → Config snapshots: views snapshots
README.md - Network operator → Service controls: controls service
README.md - Service controls → Admin authorization: checks access
routes/dhcp_start_stop_restart.js - Service controls → ISC DHCP server: runs service actions
routes/dhcp_start_stop_restart.js - Network operator → Alert settings: configures alerts
README.md - Alert settings → Admin authorization: checks access
routes/glass_alerts.js - Alert configuration → Admin authorization: checks access
routes/glass_alert_settings_save.js - Threshold alerting → Alert delivery: sends notifications
app.js - Alert delivery → Email, Slack, SMS: delivers alerts
README.md - Pool statistics → ISC DHCP server: measures pools
routes/get_stats.js