parent
4e27497960
commit
92def89fdc
49
README.md
49
README.md
|
@ -1,32 +1,37 @@
|
||||||
# Monit Dashboard
|
# Monit Dashboard
|
||||||
|
|
||||||
## Description
|
## Description
|
||||||
Python web application to get a dashboard of a bunch of [Monit][monit]
|
|
||||||
servers at a glance.
|
Python web application to get a dashboard of a bunch of [Monit] servers at a
|
||||||
|
glance.
|
||||||
|
|
||||||
## How does it work?
|
## How does it work?
|
||||||
Every 300 seconds the application ask for the data served by the
|
|
||||||
Monit built-in web server in a XMl report from each configured server.
|
Every 300 seconds (hardcoded) the application ask for the data served by the
|
||||||
Then, thanks to the built-in web server, it is displayed in a single
|
Monit built-in web server in a XMl report from each configured server. Then,
|
||||||
HTML page.
|
thanks to the built-in web server, it is displayed in a single HTML page.
|
||||||
|
|
||||||
## Pre requisites
|
## Pre requisites
|
||||||
|
|
||||||
### Debian GNU/Linux
|
### Debian GNU/Linux
|
||||||
|
|
||||||
#### Web.py framework
|
#### Web.py framework
|
||||||
|
|
||||||
- `apt install python-webpy`
|
- `apt install python-webpy`
|
||||||
|
|
||||||
#### Python libraries
|
#### Python libraries
|
||||||
|
|
||||||
- `apt install python-xmltodict python-requests`
|
- `apt install python-xmltodict python-requests`
|
||||||
|
|
||||||
### CentOS
|
### CentOS
|
||||||
|
|
||||||
#### Python PIP
|
#### Python PIP
|
||||||
|
|
||||||
- `yum install epel-release`
|
- `yum install epel-release`
|
||||||
- `yum install python-pip`
|
- `yum install python-pip`
|
||||||
|
|
||||||
#### Web.py framework
|
#### Web.py framework
|
||||||
|
|
||||||
- `pip install web.py`
|
- `pip install web.py`
|
||||||
|
|
||||||
#### Python libaries
|
#### Python libaries
|
||||||
|
@ -34,26 +39,30 @@ HTML page.
|
||||||
- `yum install python-requests python-xmltodict python-simplejson`
|
- `yum install python-requests python-xmltodict python-simplejson`
|
||||||
|
|
||||||
## Requisites
|
## Requisites
|
||||||
- Config file `conf/servers.json` prior run. You might find a sample
|
|
||||||
file at `conf/servers.json.example`.
|
- Config file `conf/servers.json` prior run. You might find a sample file at
|
||||||
|
`conf/servers.json.example`.
|
||||||
- Please see [Config](#config) section for further details.
|
- Please see [Config](#config) section for further details.
|
||||||
|
|
||||||
## Run
|
## Run
|
||||||
|
|
||||||
`./bin/monit-dashboard.py`
|
`./bin/monit-dashboard.py`
|
||||||
|
|
||||||
By default, it will be reachable at http://localhost:8080. You might
|
By default, it will be reachable at <http://localhost:8080>. You might change
|
||||||
change the port by adjusting `app.run(port=8080)` in
|
the port by adjusting `app.run(port=8080)` in `bin/monit-dashboard.py` file.
|
||||||
`bin/monit-dashboard.py` file.
|
|
||||||
|
|
||||||
## References
|
## References
|
||||||
|
|
||||||
- [web.py 0.3 tutorial][webpy-tutorial]
|
- [web.py 0.3 tutorial][webpy-tutorial]
|
||||||
- [Learn Python the hard way, ex 50][lpthw]
|
- [Learn Python the hard way, ex 50][lpthw]
|
||||||
- [A template example][template-example]
|
- [A template example][template-example]
|
||||||
- [How to change HTTP server port][port]
|
- [How to change HTTP server port][port]
|
||||||
|
|
||||||
## Config
|
## Config
|
||||||
|
|
||||||
- Placed in `conf/servers.json`
|
- Placed in `conf/servers.json`
|
||||||
- Sample settings as follows:
|
- Sample settings as follows:
|
||||||
|
|
||||||
```
|
```
|
||||||
{
|
{
|
||||||
"My server to monit": {
|
"My server to monit": {
|
||||||
|
@ -65,21 +74,23 @@ change the port by adjusting `app.run(port=8080)` in
|
||||||
```
|
```
|
||||||
|
|
||||||
# Credits
|
# Credits
|
||||||
|
|
||||||
- [Original idea][idea]
|
- [Original idea][idea]
|
||||||
- Frontend support: Júlia Vázquez
|
- Frontend support: Júlia Vázquez
|
||||||
- [Icons][icons]
|
- [Icons]
|
||||||
- [Accordion menu][accordion]
|
- [Accordion menu][accordion]
|
||||||
|
|
||||||
# License
|
# License
|
||||||
|
|
||||||
[AGPL][license]
|
[AGPL][license]
|
||||||
|
|
||||||
|
[accordion]: http://www.w3schools.com/howto/howto_js_accordion.asp
|
||||||
|
[icons]: https://commons.wikimedia.org/wiki/User:House
|
||||||
|
[idea]: https://imil.net/blog/2016/03/16/Fetch-monit-status-in-JSON/
|
||||||
|
[license]: LICENSE
|
||||||
|
[lpthw]: https://learnpythonthehardway.org/book/ex50.html
|
||||||
[monit]: https://mmonit.com/monit/
|
[monit]: https://mmonit.com/monit/
|
||||||
|
[port]: https://stackoverflow.com/questions/14444913/web-py-specify-address-and-port
|
||||||
|
[template-example]: https://stackoverflow.com/questions/28508869/using-web-py-to-dynamically-output-values-from-process-initiated-by-form-submiss
|
||||||
[webpy]: http://webpy.org/
|
[webpy]: http://webpy.org/
|
||||||
[webpy-tutorial]: http://webpy.org/tutorial3.en
|
[webpy-tutorial]: http://webpy.org/tutorial3.en
|
||||||
[port]: https://stackoverflow.com/questions/14444913/web-py-specify-address-and-port
|
|
||||||
[lpthw]: https://learnpythonthehardway.org/book/ex50.html
|
|
||||||
[template-example]: https://stackoverflow.com/questions/28508869/using-web-py-to-dynamically-output-values-from-process-initiated-by-form-submiss
|
|
||||||
[idea]: https://imil.net/blog/2016/03/16/Fetch-monit-status-in-JSON/
|
|
||||||
[icons]: https://commons.wikimedia.org/wiki/User:House
|
|
||||||
[accordion]: http://www.w3schools.com/howto/howto_js_accordion.asp
|
|
||||||
[license]: LICENSE
|
|
||||||
|
|
|
@ -1,7 +1,11 @@
|
||||||
#!/usr/bin/python
|
#!/usr/bin/python
|
||||||
|
|
||||||
import web
|
import web
|
||||||
import requests, xmltodict, json, os, sys
|
import requests
|
||||||
|
import xmltodict
|
||||||
|
import json
|
||||||
|
import os
|
||||||
|
import sys
|
||||||
import datetime
|
import datetime
|
||||||
|
|
||||||
urls = ('/', 'index',
|
urls = ('/', 'index',
|
||||||
|
@ -11,13 +15,14 @@ urls = ('/', 'index',
|
||||||
app = web.application(urls, globals())
|
app = web.application(urls, globals())
|
||||||
render = web.template.render('templates/', base="layout")
|
render = web.template.render('templates/', base="layout")
|
||||||
|
|
||||||
## Uncomment to turn debug off
|
# Uncomment to turn debug off
|
||||||
web.config.debug = False
|
web.config.debug = False
|
||||||
|
|
||||||
## Variables
|
# Variables
|
||||||
output = []
|
output = []
|
||||||
|
|
||||||
## Functions
|
# Functions
|
||||||
|
|
||||||
|
|
||||||
def getMonit():
|
def getMonit():
|
||||||
output = []
|
output = []
|
||||||
|
@ -30,7 +35,8 @@ def getMonit():
|
||||||
|
|
||||||
for site in cf:
|
for site in cf:
|
||||||
s = cf[site]
|
s = cf[site]
|
||||||
r = requests.get(s['url'] + xmlQuery, auth = (s['user'], s['passwd']))
|
r = requests.get(s['url'] + xmlQuery,
|
||||||
|
auth=(s['user'], s['passwd']))
|
||||||
|
|
||||||
allstat = json.loads(json.dumps(xmltodict.parse(r.text)['monit']))
|
allstat = json.loads(json.dumps(xmltodict.parse(r.text)['monit']))
|
||||||
|
|
||||||
|
@ -50,22 +56,28 @@ def getMonit():
|
||||||
print(datetime.datetime.now())
|
print(datetime.datetime.now())
|
||||||
return(output)
|
return(output)
|
||||||
|
|
||||||
## Classes
|
# Classes
|
||||||
|
|
||||||
|
|
||||||
class monitDashboard(web.application):
|
class monitDashboard(web.application):
|
||||||
|
|
||||||
def run(self, port=8080, *middleware):
|
def run(self, port=8080, *middleware):
|
||||||
func = self.wsgifunc(*middleware)
|
func = self.wsgifunc(*middleware)
|
||||||
return web.httpserver.runsimple(func, ('0.0.0.0', port))
|
return web.httpserver.runsimple(func, ('0.0.0.0', port))
|
||||||
|
|
||||||
|
|
||||||
class index(object):
|
class index(object):
|
||||||
|
|
||||||
def GET(self):
|
def GET(self):
|
||||||
return render.index(output=getMonit(), now=datetime.datetime.now())
|
return render.index(output=getMonit(), now=datetime.datetime.now())
|
||||||
|
|
||||||
|
|
||||||
class help(object):
|
class help(object):
|
||||||
|
|
||||||
def GET(self):
|
def GET(self):
|
||||||
return render.help()
|
return render.help()
|
||||||
|
|
||||||
## Main
|
# Main
|
||||||
if __name__ == "__main__":
|
if __name__ == "__main__":
|
||||||
app = monitDashboard(urls, globals())
|
app = monitDashboard(urls, globals())
|
||||||
app.run(port=8080)
|
app.run(port=8080)
|
||||||
|
|
|
@ -1,15 +1,18 @@
|
||||||
$def with (content)
|
$def with (content)
|
||||||
|
|
||||||
<html>
|
<html>
|
||||||
|
|
||||||
<head>
|
<head>
|
||||||
<title>Monit Dashboard</title>
|
<title>Monit Dashboard</title>
|
||||||
<link rel="stylesheet" type="text/css" href="static/monit-dashboard.css" />
|
<link rel="stylesheet" type="text/css" href="static/monit-dashboard.css" />
|
||||||
<meta http-equiv="refresh" content="300">
|
<meta http-equiv="refresh" content="300">
|
||||||
</head>
|
</head>
|
||||||
|
|
||||||
<body>
|
<body>
|
||||||
|
|
||||||
$:content
|
$:content
|
||||||
|
|
||||||
<a href="/">Home</a> | <a href="/help">Help</a>
|
<a href="/">Home</a> | <a href="/help">Help</a>
|
||||||
</body>
|
</body>
|
||||||
|
|
||||||
</html>
|
</html>
|
Loading…
Reference in a new issue