monitor
A simple & straightforward server/pc monitor;
Installation
If you haven't yet, install NodeJS and npm (tons of tuts online)
npm i -g @jsmrcaga/monitor
(depending on settings, sudo might be required)
Usage
monitor will launch a server to monitor and log to the terminal.
To launch monitor without logs, simply use monitor &
API
GET /perfs
Returns all performance information and host general information :
{
// RAM with free -m
"ram": {
"total":,
"used":,
"free":,
"shared":,
"buffer":,
"available":,
"usage": <percent>
},
// os.cpus()
"cpu": {
"cpus": [
{
"model": "Intel(R) Core(TM) i5-7360U CPU @ 2.30GHz",
"speed": 2300,
"times": {
"user": 111715970,
"nice": 0,
"sys": 113884460,
"idle": 595231360,
"irq": 0
},
"usage": 0.2748436802137013
},
...
],
"global": {
"user": 325727140,
"nice": 0,
"sys": 297567490,
"idle": 2659961710,
"irq": 0,
"usage": 0.1898403796275011
}
},
// disk from df -m
"disk": {
"blocks": "115411",
"used": "83387",
"usage": 0.000009999970972777843,
"available": "24205",
"mounted": "2272833"
},
// os.networkInterfaces() + ipify.org for external
"ip": {
"ipv4": {
"address": "xxx.xxxx.xx.x",
"netmask": "255.255.255.0",
"family": "IPv4",
"mac": "00:00:00:00:00:00",
"internal": false,
"cidr": "xxx.xxx.xx.x/24"
},
"ipv6": {
"address": "yyyy::zzzz:zzzz:zzzz:zzzz",
"netmask": "ffff:ffff:ffff:ffff::",
"family": "IPv6",
"mac": "00:00:00:00:00:00",
"scopeid": 12,
"internal": false,
"cidr": "fe80::db97:b69a:4053:fdcc/64"
},
"external": {
"address": "xxx.xxx.xxx.xxx"
}
},
// os.uptime()
"uptime": 1918514000,
// multiple process and os functions
"info": {
"node": "v10.12.0",
"platform": "darwin",
"env": "development",
"uname": "Darwin XXXXXXXXXXX 18.2.0 Darwin Kernel Version 18.2.0: Fri Oct 5 19:41:49 PDT 2018;",
"architecture": "x64",
"hostname": "your-hostname",
"osrelease": "18.2.0"
}
}
GET /perfs/ram
Returns all RAM information
GET /perfs/cpu
Returns all CPU information
GET /perfs/disk
Returns all Disk information
GET /perfs/info
Returns all OS information