device-monitor-dashboard

Python script to generate html report of devices' online/offline status. A cheap/fun reporting solution. This can be used for for servers, networking equipment, IOT devices, anything that's "pingable". Supports:

Linux
Windows
Raspberry Pi

Live Demo:

100% Devices Up / Failing Devices

Changelog

(5/16/2020) Update to python 3
(9/9/2018) Replace txt file format with json
(1/30/2018) Replace trunicates with jinja templating engine
(1/27/2018) Added python 3 compatibility
(10/27/2017) Updated UI, noty.js
(9/25/2017) Add support for custom names
(6/3/2017) Now providing a docker image instead of building your own
(5/27/2017) - Please see https://github.com/shaggyloris/Device-Monitor-Dashboard for extended functionality.
- Integrated SQLite DB, all controlled via web UI, API functionality to return JSON.
(5/6/17) Added validation of OS for script to run
(2/26/17) Update Easy Install to automatically install packages
(2/25/17) Added support for vertically scrolling table, adjusts circle size if on mobile device.
(2/24/17) Combined ping function to single file, added ability to check other ports. Also converted script to be more in line with python norms. Table rows now act as hyperlinks to address listed and will auto detect port if specified.
(2/20/17) Updated noty,jquery, notifications UI, mobile UI
(2/18/17) Added support to build custom docker container
(2/4/17) Easy Install script now supports Node.js, update wheel color
(2/3/17) Change status from online/offline text to colored orb indicators

Easy Install

bash -c "$(curl -sL https://raw.githubusercontent.com/circa10a/Device-Monitor-Dashboard/master/install.sh)"

Ubuntu, Nginx, Python 3 required for Easy Install
Follow the prompts!

Usage

Have a JSON file(array of objects) with hostnames, port, alias
- Example JSON file

[
   {
       "url": "www.github.com",
       "port": 443,
       "alias": "GitHub"
   },
   {
       "url": "www.reddit.com",
       "port": 443,
       "alias": "Reddit"
   },
   {
       "url": "www.google.com",
       "port": 80,
       "alias": "Google"
   },
   {
       "url": "www.apple.com",
       "port": 80,
       "alias": null
   }
]

Update the python script (variable at the top) with the path/name of your file with hostnames and output file path.(default hostnames= ./hostnames.json default output= ./index.html`)
Run python3 report.py
Ensure that you place the output HTML file in the project directory so it can find its web dependencies
- Page automcatically reloads every 60 seconds.

Docker!

docker run -d -p 80:80 -v ~/path/to/your/hostnames.json:/usr/share/nginx/html/hostnames.json --name monitor circa10a/device-monitor-dashboard

Note: Wait 5 min for cron job to execute and render an index.html

Build your own docker image:

git clone https://github.com/circa10a/Device-Monitor-Dashboard.git
cd Device-Monitor-Dashboard

Edit your hostnames.json file add your website, servers, switches, devices, etc.

docker build -t myrepo/monitor
docker run --name device-monitor -d -p 80:80 myrepo/monitor

- Known issue: Docker for Mac pings any address and returns success giving false results.

Automation

Setup a web server
Install a new cron job to run the report periodically cd $path/to/project_directory/ && python report.py &> /dev/null
Set output path in python script to write out html report to web serving directory such as /var/www/html
The page will automatically refresh every 60 seconds to reflect the new report generated by cron

circa10a/device-monitor-dashboard

circa10a

Reviews

Repository Details