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":
},

// 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