@daemonitor/plugins 1.1.3 → 1.1.5

package/dist/plugins/monitoring/SnmpPlugin.js

@@ -21,9 +21,39 @@ const OID = {
     supplyLevel: "1.3.6.1.2.1.43.11.1.1.9", // prtMarkerSuppliesLevel (walk)
 };
 const PRINTER_STATUS = { "1": "other", "2": "unknown", "3": "idle", "4": "printing", "5": "warmup" };
+// Generic SYSTEM / IF-MIB OIDs (switches, APs, anything SNMP-capable).
+const SYS = {
+    descr: "1.3.6.1.2.1.1.1.0", // sysDescr
+    uptime: "1.3.6.1.2.1.1.3.0", // sysUpTime (timeticks, 1/100s)
+    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)
+};
+// 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 = {
+    cpuUsage: "1.3.6.1.4.1.24681.1.2.1.0", // systemCPU-Usage e.g. "3.5 %"
+    cpuTemp: "1.3.6.1.4.1.24681.1.2.5.0", // cpu-Temperature e.g. "67 C/152 F"
+    sysTemp: "1.3.6.1.4.1.24681.1.2.6.0", // systemTemperature
+    model: "1.3.6.1.4.1.24681.1.2.12.0", // e.g. "TS-963X"
+    hdNumber: "1.3.6.1.4.1.24681.1.2.10.0", // installed disk count
+    hdDescr: "1.3.6.1.4.1.24681.1.2.11.1.2.", // + index
+    hdTemp: "1.3.6.1.4.1.24681.1.2.11.1.3.",
+    hdStatus: "1.3.6.1.4.1.24681.1.2.11.1.4.", // 0 = ready/ok
+    hdSmart: "1.3.6.1.4.1.24681.1.2.11.1.7.", // "GOOD" / "Warning"
+};
 function slug(s) {
     return s.replace(/[^a-zA-Z0-9_.-]+/g, "-").replace(/^-+|-+$/g, "");
 }
+// QNAP reports temps as "67 C/152 F" and percentages as "3.5 %" — pull the number.
+function parseC(s) {
+    const m = /(-?\d+(?:\.\d+)?)\s*C/.exec(s || "");
+    return m ? Math.round(Number(m[1])) : undefined;
+}
+function parseNum(s) {
+    const m = /(-?\d+(?:\.\d+)?)/.exec(s || "");
+    return m ? Number(m[1]) : undefined;
+}
 async function snmpGet(t, oid, timeout = 8000) {
     try {
         const { stdout } = await pexec("snmpget", ["-v", t.version || "2c", "-c", t.community || "public", "-Ovq", "-t", "2", "-r", "1", t.ip, oid], { timeout });
@@ -86,6 +116,114 @@ async function collectPrinter(t) {
         warnPct,
     };
 }
+// Generic SNMP device (switch/AP/…): identity, uptime, and enabled-port link
+// state so a down uplink or dead switch surfaces. Reachability via SNMP is more
+// reliable than ICMP — many devices drop ping but answer SNMP.
+async function collectDevice(t) {
+    const [descr, name, uptimeRaw, oper, admin] = await Promise.all([
+        snmpGet(t, SYS.descr),
+        snmpGet(t, SYS.name),
+        snmpGet(t, SYS.uptime),
+        snmpWalk(t, SYS.ifOper),
+        snmpWalk(t, SYS.ifAdmin),
+    ]);
+    if (descr == null && name == null && !oper.length) {
+        return { name: t.name, ip: t.ip, kind: t.kind || "device", reachable: false };
+    }
+    // Only count ADMIN-enabled ports; an enabled port that's operationally down is
+    // a real link-down (ignore the many disabled ports on a big switch).
+    let portsTotal = 0;
+    let portsUp = 0;
+    for (let i = 0; i < oper.length; i++) {
+        if (Number(admin[i]) === 1) {
+            portsTotal++;
+            if (Number(oper[i]) === 1)
+                portsUp++;
+        }
+    }
+    // sysUpTime timeticks → seconds
+    const upSecs = uptimeRaw != null ? Math.round((Number(String(uptimeRaw).replace(/[^0-9]/g, "")) || 0) / 100) : undefined;
+    return {
+        name: t.name,
+        ip: t.ip,
+        kind: t.kind || "device",
+        reachable: true,
+        sysDescr: descr || undefined,
+        sysName: name || undefined,
+        uptimeSecs: upSecs,
+        portsUp,
+        portsTotal,
+    };
+}
+// Walk that keeps each row's index (numeric OID suffix) — needed to resolve the
+// hrStorage table entries for the data volumes.
+async function snmpWalkIndexed(t, oid, timeout = 10000) {
+    try {
+        const { stdout } = await pexec("snmpwalk", ["-v", t.version || "2c", "-c", t.community || "public", "-On", "-t", "2", "-r", "1", t.ip, oid], { timeout });
+        return stdout.split("\n").map((l) => {
+            const m = /^(\S+)\s*=\s*[^:]+:\s*(.*)$/.exec(l.trim());
+            if (!m)
+                return null;
+            const idx = m[1].startsWith(oid) ? m[1].slice(oid.length).replace(/^\./, "") : m[1];
+            return { idx, val: m[2].trim().replace(/^"|"$/g, "") };
+        }).filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+// QNAP NAS: CPU load, cpu/system temps, per-disk health + temp, and data-volume
+// fullness. Uses the QNAP enterprise MIB by exact OID (walk times out) plus
+// HOST-RESOURCES for CPU load and volume sizes.
+async function collectQnap(t) {
+    const tempWarn = t.tempWarnC ?? 70;
+    const volWarn = t.volumeWarnPct ?? 90;
+    const [model, cpuTemp, sysTemp, hdNumRaw, cpuLoads, storDescrs] = await Promise.all([
+        snmpGet(t, QNAP.model),
+        snmpGet(t, QNAP.cpuTemp),
+        snmpGet(t, QNAP.sysTemp),
+        snmpGet(t, QNAP.hdNumber),
+        snmpWalk(t, "1.3.6.1.2.1.25.3.3.1.2"), // hrProcessorLoad (per core)
+        snmpWalkIndexed(t, "1.3.6.1.2.1.25.2.3.1.3"), // hrStorageDescr
+    ]);
+    if (model == null && cpuTemp == null && !cpuLoads.length) {
+        return { name: t.name, ip: t.ip, kind: "qnap", reachable: false };
+    }
+    // CPU: average per-core load.
+    const cores = cpuLoads.map(Number).filter((n) => !isNaN(n));
+    const cpuPct = cores.length ? Math.round(cores.reduce((a, b) => a + b, 0) / cores.length) : undefined;
+    // Disks — iterate 1..hdNumber (bounded).
+    const hdN = Math.min(Number(hdNumRaw) || 0, 24);
+    const disks = [];
+    for (let i = 1; i <= hdN; i++) {
+        const [st, tp, sm, ds] = await Promise.all([
+            snmpGet(t, QNAP.hdStatus + i), snmpGet(t, QNAP.hdTemp + i), snmpGet(t, QNAP.hdSmart + i), snmpGet(t, QNAP.hdDescr + i),
+        ]);
+        if (st == null && tp == null)
+            continue;
+        disks.push({ slot: i, descr: ds || undefined, tempC: parseC(tp), status: st != null ? Number(st) : undefined, smart: sm || undefined });
+    }
+    const badDisks = disks.filter((d) => (d.status != null && d.status !== 0) || (d.smart && !/good|normal/i.test(d.smart)) || (d.tempC != null && d.tempC >= tempWarn));
+    // Volumes — the CACHEDEVn_DATA mounts from hrStorage.
+    const volumes = [];
+    for (const row of storDescrs.filter((r) => /CACHEDEV\d+_DATA$/.test(r.val))) {
+        const [units, size, used] = await Promise.all([
+            snmpGet(t, `1.3.6.1.2.1.25.2.3.1.4.${row.idx}`), snmpGet(t, `1.3.6.1.2.1.25.2.3.1.5.${row.idx}`), snmpGet(t, `1.3.6.1.2.1.25.2.3.1.6.${row.idx}`),
+        ]);
+        const u = parseNum(units) || 1, sz = parseNum(size) || 0, us = parseNum(used) || 0;
+        if (sz > 0)
+            volumes.push({ mount: row.val, totalGB: Math.round((sz * u) / 1e9), usedGB: Math.round((us * u) / 1e9), pct: Math.round((us / sz) * 100) });
+    }
+    const fullVols = volumes.filter((v) => v.pct >= volWarn);
+    return {
+        name: t.name, ip: t.ip, kind: "qnap", reachable: true,
+        model: model || undefined,
+        cpuPct, cpuTempC: parseC(cpuTemp), sysTempC: parseC(sysTemp),
+        disks, badDisks: badDisks.map((d) => ({ slot: d.slot, status: d.status, smart: d.smart, tempC: d.tempC })),
+        volumes, fullVolumes: fullVols,
+        tempWarnC: tempWarn, volumeWarnPct: volWarn,
+    };
+}
 export function createSnmpPlugin() {
     let refreshTimer = null;
     const targetsOf = (plugin) => {
@@ -97,7 +235,9 @@ export function createSnmpPlugin() {
     const refreshFn = async (plugin) => {
         await Promise.all(targetsOf(plugin).map(async (t) => {
             try {
-                const data = t.kind === "printer" || !t.kind ? await collectPrinter(t) : { name: t.name, ip: t.ip, kind: t.kind };
+                const data = t.kind === "qnap" ? await collectQnap(t)
+                    : t.kind === "printer" || !t.kind ? await collectPrinter(t)
+                        : await collectDevice(t);
                 await plugin.send(data, `snmp-${slug(t.name || t.ip)}`);
             }
             catch (e) {

package/package.json

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