@daemonitor/plugins 1.1.12 → 1.1.14

package/dist/plugins/monitoring/SnmpPlugin.js

@@ -28,7 +28,26 @@ const SYS = {
     name: "1.3.6.1.2.1.1.5.0", // sysName
     ifOper: "1.3.6.1.2.1.2.2.1.8", // ifOperStatus (walk): 1=up 2=down
     ifAdmin: "1.3.6.1.2.1.2.2.1.7", // ifAdminStatus (walk): 1=up (enabled)
+    ifHCIn: "1.3.6.1.2.1.31.1.1.1.6", // ifHCInOctets (walk, Counter64)
+    ifHCOut: "1.3.6.1.2.1.31.1.1.1.10", // ifHCOutOctets (walk, Counter64)
 };
+// UCD-SNMP-MIB + HOST-RESOURCES — CPU/RAM/load on net-snmp devices (EdgeOS
+// routers, Linux hosts). All best-effort: absent on gear that doesn't ship the
+// UCD MIB (many switches), so every read is null-tolerant.
+const UCD = {
+    cpuIdle: "1.3.6.1.4.1.2021.11.11.0", // ssCpuIdle (%) → cpu% = 100 - idle
+    load1: "1.3.6.1.4.1.2021.10.1.3.1", // laLoad 1-min
+    load5: "1.3.6.1.4.1.2021.10.1.3.2",
+    load15: "1.3.6.1.4.1.2021.10.1.3.3",
+    memTotal: "1.3.6.1.4.1.2021.4.5.0", // memTotalReal (KB)
+    memAvail: "1.3.6.1.4.1.2021.4.6.0", // memAvailReal (KB, free excl. cache)
+    memBuffer: "1.3.6.1.4.1.2021.4.14.0", // memBuffer (KB)
+    memCached: "1.3.6.1.4.1.2021.4.15.0", // memCached (KB)
+    hrProcLoad: "1.3.6.1.2.1.25.3.3.1.2", // hrProcessorLoad (walk, per-core %) — CPU fallback
+};
+// Per-target previous interface-octet sample, for throughput (bps) rate calc
+// across polls. Module-level: one collectDevice call per target per cycle.
+const netPrev = {};
 // QNAP enterprise MIB (NAS-MIB, 1.3.6.1.4.1.24681.1.2). A full walk of this
 // subtree times out on QTS, so everything here is fetched by exact OID.
 const QNAP = {
@@ -167,6 +186,54 @@ async function collectDevice(t) {
     }
     // sysUpTime timeticks → seconds
     const upSecs = uptimeRaw != null ? Math.round((Number(String(uptimeRaw).replace(/[^0-9]/g, "")) || 0) / 100) : undefined;
+    // CPU / RAM / load / network — best-effort UCD-SNMP + IF-MIB counters. Absent
+    // on gear without the UCD MIB (returns "No Such Object" fast → null), so every
+    // field is optional and simply omitted when unsupported.
+    const [cpuIdle, load1, load5, load15, memTotal, memAvail, memBuffer, memCached, procLoads, hcIn, hcOut] = await Promise.all([
+        snmpGet(t, UCD.cpuIdle), snmpGet(t, UCD.load1), snmpGet(t, UCD.load5), snmpGet(t, UCD.load15),
+        snmpGet(t, UCD.memTotal), snmpGet(t, UCD.memAvail), snmpGet(t, UCD.memBuffer), snmpGet(t, UCD.memCached),
+        snmpWalk(t, UCD.hrProcLoad), snmpWalk(t, SYS.ifHCIn), snmpWalk(t, SYS.ifHCOut),
+    ]);
+    // CPU %: prefer ssCpuIdle (100 - idle); fall back to avg per-core hrProcessorLoad.
+    let cpuPct;
+    if (cpuIdle != null && !isNaN(Number(cpuIdle))) {
+        cpuPct = Math.max(0, Math.min(100, 100 - Math.round(Number(cpuIdle))));
+    }
+    else {
+        const cores = procLoads.map(Number).filter((n) => !isNaN(n));
+        if (cores.length)
+            cpuPct = Math.round(cores.reduce((a, b) => a + b, 0) / cores.length);
+    }
+    const load1n = parseNum(load1);
+    const loadavg = [parseNum(load1), parseNum(load5), parseNum(load15)].filter((n) => n != null);
+    // RAM used %: (total - free - buffers - cache) / total. memAvailReal excludes
+    // cache already on some agents; subtracting buffer+cache is safe (they default 0).
+    let memPct, memTotalMB;
+    const mTot = parseNum(memTotal), mAvail = parseNum(memAvail);
+    const mBuf = parseNum(memBuffer) || 0, mCache = parseNum(memCached) || 0;
+    if (mTot && mTot > 0 && mAvail != null) {
+        const usedKb = Math.max(0, mTot - mAvail - mBuf - mCache);
+        memPct = Math.round((usedKb / mTot) * 100);
+        memTotalMB = Math.round(mTot / 1024);
+    }
+    // Network throughput (aggregate bytes/sec, to match the OS plugin's NET
+    // metric): delta of summed HC octets vs the prior poll. First poll (or a
+    // counter reset) yields no rate.
+    let netIn, netOut;
+    const sumIn = hcIn.map(Number).filter((n) => !isNaN(n)).reduce((a, b) => a + b, 0);
+    const sumOut = hcOut.map(Number).filter((n) => !isNaN(n)).reduce((a, b) => a + b, 0);
+    if (hcIn.length || hcOut.length) {
+        const now = Date.now();
+        const prev = netPrev[t.ip];
+        if (prev && sumIn >= prev.in && sumOut >= prev.out && now > prev.ts) {
+            const dt = (now - prev.ts) / 1000;
+            if (dt > 0) {
+                netIn = Math.round((sumIn - prev.in) / dt);
+                netOut = Math.round((sumOut - prev.out) / dt);
+            }
+        }
+        netPrev[t.ip] = { in: sumIn, out: sumOut, ts: now };
+    }
     return {
         name: t.name,
         ip: t.ip,
@@ -177,6 +244,13 @@ async function collectDevice(t) {
         uptimeSecs: upSecs,
         portsUp,
         portsTotal,
+        cpuPct,
+        load1: load1n,
+        loadavg: loadavg.length ? loadavg : undefined,
+        memPct,
+        memTotalMB,
+        netIn,
+        netOut,
     };
 }
 // Walk that keeps each row's index (numeric OID suffix) — needed to resolve the

package/dist/plugins/monitoring/ThreeCXPlugin.js

@@ -77,6 +77,33 @@ async function tunnelStatus(port) {
         return { up: false };
     }
 }
+// Inbound tunnels: on the PBX, each connected SBC (and any tunnelled client) holds
+// an established session whose LOCAL port is the tunnel port (5090). Returns the
+// set of distinct peer IPs — matching a configured SBC's edge IP tells us that SBC
+// is still reaching the PBX, observed entirely from the PBX side.
+async function inboundTunnelPeers(port) {
+    try {
+        const { stdout } = await pexec("ss", ["-tn", "state", "established"], { timeout: 6000 });
+        const suffix = `:${port}`;
+        const peers = new Set();
+        for (const line of stdout.split("\n")) {
+            const cols = line.trim().split(/\s+/);
+            if (cols.length < 2)
+                continue;
+            const local = cols[cols.length - 2];
+            const peer = cols[cols.length - 1];
+            if (!local || !local.endsWith(suffix))
+                continue; // only sessions we LISTEN for on :port
+            const ip = peer.replace(/:\d+$/, "").replace(/^\[|\]$/g, "").replace(/^::ffff:/, "");
+            if (ip)
+                peers.add(ip);
+        }
+        return [...peers];
+    }
+    catch {
+        return [];
+    }
+}
 async function collect3cx(inst) {
     const role = inst.role === "sbc" ? "sbc" : "pbx";
     const name = inst.name || hostname();
@@ -133,7 +160,19 @@ async function collect3cx(inst) {
     const sip = await Promise.all(sipPorts.map(async (port) => ({ port, listening: await portListening(host, port) })));
     const sipOk = sip.every((p) => p.listening);
     const consoleProbe = { port: consolePort, listening: await portListening(host, consolePort) };
-    return { ...svcCommon, sip, sipOk, console: consoleProbe };
+    // Watch branch SBCs from the PBX side, if any are configured.
+    let sbcs = undefined;
+    let sbcTunnelCount = undefined;
+    if (Array.isArray(inst.sbcs) && inst.sbcs.length) {
+        const peers = await inboundTunnelPeers(pbxTunnelPort);
+        sbcTunnelCount = peers.length;
+        sbcs = inst.sbcs.map((s) => ({
+            name: s.name,
+            peer: s.peer,
+            connected: s.peer ? peers.includes(s.peer) : peers.length > 0,
+        }));
+    }
+    return { ...svcCommon, sip, sipOk, console: consoleProbe, ...(sbcs ? { sbcs, sbcTunnelCount } : {}) };
 }
 export function createThreeCXPlugin() {
     let refreshTimer = null;
@@ -151,6 +190,7 @@ export function createThreeCXPlugin() {
                 sipPorts: cfg.sipPorts,
                 consolePort: cfg.consolePort,
                 pbxTunnelPort: cfg.pbxTunnelPort,
+                sbcs: cfg.sbcs,
                 systemctlBin: cfg.systemctlBin,
                 uniqueId: cfg.uniqueId,
             }];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daemonitor/plugins",
-  "version": "1.1.12",
+  "version": "1.1.14",
   "description": "daemonitor plugins",
   "types": "types/index.d.ts",
   "main": "dist/index.js",