feat: Add SNMP Monitor (#4717)
Frank Elsinga
4 months ago
committed by
GitHub
commit
4aef6780ed
@ -0,0 +1,16 @@
|
|||||||
|
exports.up = function (knex) {
|
||||||
|
return knex.schema
|
||||||
|
.alterTable("monitor", function (table) {
|
||||||
|
table.string("snmp_oid").defaultTo(null);
|
||||||
|
table.enum("snmp_version", [ "1", "2c", "3" ]).defaultTo("2c");
|
||||||
|
table.string("json_path_operator").defaultTo(null);
|
||||||
|
});
|
||||||
|
};
|
||||||
|
|
||||||
|
exports.down = function (knex) {
|
||||||
|
return knex.schema.alterTable("monitor", function (table) {
|
||||||
|
table.dropColumn("snmp_oid");
|
||||||
|
table.dropColumn("snmp_version");
|
||||||
|
table.dropColumn("json_path_operator");
|
||||||
|
});
|
||||||
|
};
|
||||||
@ -0,0 +1,63 @@
|
|||||||
|
const { MonitorType } = require("./monitor-type");
|
||||||
|
const { UP, log, evaluateJsonQuery } = require("../../src/util");
|
||||||
|
const snmp = require("net-snmp");
|
||||||
|
|
||||||
|
class SNMPMonitorType extends MonitorType {
|
||||||
|
name = "snmp";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @inheritdoc
|
||||||
|
*/
|
||||||
|
async check(monitor, heartbeat, _server) {
|
||||||
|
let session;
|
||||||
|
try {
|
||||||
|
const sessionOptions = {
|
||||||
|
port: monitor.port || "161",
|
||||||
|
retries: monitor.maxretries,
|
||||||
|
timeout: monitor.timeout * 1000,
|
||||||
|
version: snmp.Version[monitor.snmpVersion],
|
||||||
|
};
|
||||||
|
session = snmp.createSession(monitor.hostname, monitor.radiusPassword, sessionOptions);
|
||||||
|
|
||||||
|
// Handle errors during session creation
|
||||||
|
session.on("error", (error) => {
|
||||||
|
throw new Error(`Error creating SNMP session: ${error.message}`);
|
||||||
|
});
|
||||||
|
|
||||||
|
const varbinds = await new Promise((resolve, reject) => {
|
||||||
|
session.get([ monitor.snmpOid ], (error, varbinds) => {
|
||||||
|
error ? reject(error) : resolve(varbinds);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
log.debug("monitor", `SNMP: Received varbinds (Type: ${snmp.ObjectType[varbinds[0].type]} Value: ${varbinds[0].value})`);
|
||||||
|
|
||||||
|
if (varbinds.length === 0) {
|
||||||
|
throw new Error(`No varbinds returned from SNMP session (OID: ${monitor.snmpOid})`);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (varbinds[0].type === snmp.ObjectType.NoSuchInstance) {
|
||||||
|
throw new Error(`The SNMP query returned that no instance exists for OID ${monitor.snmpOid}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
// We restrict querying to one OID per monitor, therefore `varbinds[0]` will always contain the value we're interested in.
|
||||||
|
const value = varbinds[0].value;
|
||||||
|
|
||||||
|
const { status, response } = await evaluateJsonQuery(value, monitor.jsonPath, monitor.jsonPathOperator, monitor.expectedValue);
|
||||||
|
|
||||||
|
if (status) {
|
||||||
|
heartbeat.status = UP;
|
||||||
|
heartbeat.msg = `JSON query passes (comparing ${response} ${monitor.jsonPathOperator} ${monitor.expectedValue})`;
|
||||||
|
} else {
|
||||||
|
throw new Error(`JSON query does not pass (comparing ${response} ${monitor.jsonPathOperator} ${monitor.expectedValue})`);
|
||||||
|
}
|
||||||
|
} finally {
|
||||||
|
if (session) {
|
||||||
|
session.close();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
module.exports = {
|
||||||
|
SNMPMonitorType,
|
||||||
|
};
|
||||||
Loading…
Reference in new issue