Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mfcodeworks/server-monitoring-script
Monitor System Info With Python Script
https://github.com/mfcodeworks/server-monitoring-script
json monitoring monitoring-scripts monitoring-tool python python-script script
Last synced: about 2 months ago
JSON representation
Monitor System Info With Python Script
- Host: GitHub
- URL: https://github.com/mfcodeworks/server-monitoring-script
- Owner: mfcodeworks
- License: apache-2.0
- Created: 2018-10-08T07:46:05.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-01-30T02:40:22.000Z (almost 5 years ago)
- Last Synced: 2023-05-13T02:15:27.303Z (over 1 year ago)
- Topics: json, monitoring, monitoring-scripts, monitoring-tool, python, python-script, script
- Language: Python
- Homepage:
- Size: 24.4 KB
- Stars: 61
- Watchers: 7
- Forks: 29
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Server Monitoring Script
[](https://github.com/mfsoftworks/Server-Monitoring-Script/blob/master/LICENSE.md) [](https://travis-ci.com/mfsoftworks/Server-Monitoring-Script)
[](https://codecov.io/gh/mfsoftworks/Server-Monitoring-Script) 
## Purpose
The Python script is designed to be run as a cronjob on every boot to run in the background.
The script will gather information:
- UUID (Unique for each system to avoid overlapping hostname for multi-network monitoring)
- Hostname
- CPU
- Memory
- Network Usage
- Network Cards
- Hard Drives
- System OS
- System Uptime
- UTC Timestamp
The script will produce a JSON output at intervals for use with any software or server accepting a JSON input.
Example:
```json
{
"hostname": "HOME-LAPTOP1",
"system": {
"name": "Windows",
"version": "10"
},
"uptime" : 231199,
"cpu_count": 4,
"cpu_usage": 17.9,
"memory_total": 8440942592,
"memory_used": 6244225024,
"memory_used_percent": 74.0,
"drives": [
{
"name": "C:\\",
"mount_point": "C:\\",
"type": "NTFS",
"total_size": 536224985088,
"used_size": 167306108928,
"percent_used": 31.2
},
{
"name": "D:\\",
"mount_point": "D:\\",
"type": "NTFS",
"total_size": 463332921344,
"used_size": 49498419200,
"percent_used": 10.7
}
],
"network_up": 54,
"network_down": 4150,
"network_cards": [
{
"address": "127.0.0.1",
"address6": "::1",
"mac": "",
"name": "Loopback Pseudo-Interface 1",
"netmask": "255.0.0.0"
},
{
"address": "10.15.62.112",
"address6": "fe80::844d:a87:54ea:2100",
"mac": "1C-39-47-A6-4C-5E",
"name": "Ethernet",
"netmask": "255.255.0.0"
}
],
"timestamp" : "2018-10-10T01:41:21+00:00",
"uuid" : 180331603484325
}
```
The script includes a function to POST JSON to a remote server.
This script can be installed on several machines that report to a central monitoring server.
The destination, checking interval, sending attempts after failure and timeout between resending attempts can be set through arguments, use `python3 monitor.py -h` for more.
## Usage
Clone the script with `git clone`.
Install Python.
If any library is missing do `pip3 install` *library*.
To test the script output run with `python3 monitor.py`.
### **Linux Autostart**
Create a cron job to run the script on every boot.
Edit cron with `crontab -e`.
Add the script at the bottom of the cron list as `@reboot /usr/bin/python3 /path/to/script/monitor.py &`.
### **Windows Autostart**
`Windows/monitor.bat` and `Windows/monitor.vbs` scripts are included.
`monitor.bat` will call python to launch `monitor.py`.
`monitor.vbs` silently calls `monitor.bat` to run in the background.
To create an autostart for Windows open start menu and search for `Task Scheduler`.
Select `Create Task`.
Enter a name e.g. monitor.
Add new trigger at login.
Add a new action and select the `Windows/monitor.vbs` script.
**Unselect** Stop task if it runs longer than 3 days.
Select Okay.
A new task will be created that runs the python monitoring script in the background every time a user starts the system and logs in.
## Author
MF Softworks
mf.nygmarosebeauty.com