2015-03-04 20:55:53 +01:00
|
|
|
node-red-node-snmp
|
|
|
|
==================
|
|
|
|
|
|
|
|
A pair of <a href="http://nodered.org" target="_new">Node-RED</a> nodes that
|
|
|
|
fetch either individual oids, or a table oid from a SNMP enabled host.
|
|
|
|
|
|
|
|
Install
|
|
|
|
-------
|
|
|
|
|
2016-03-02 14:26:19 +01:00
|
|
|
Run the following command in your Node-RED user directory - typically `~/.node-red`
|
2015-03-04 20:55:53 +01:00
|
|
|
|
|
|
|
npm install node-red-node-snmp
|
|
|
|
|
|
|
|
Usage
|
|
|
|
-----
|
|
|
|
|
2016-03-02 14:26:19 +01:00
|
|
|
### snmp
|
2015-03-04 20:55:53 +01:00
|
|
|
|
|
|
|
SNMP oids fetcher. Can fetch a single or comma separated list of oids. Triggered by any input.
|
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
`msg.host` may contain the host including the port.
|
2017-04-22 16:53:04 +02:00
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
`msg.community` may contain the community. (v1 and v2c only)
|
|
|
|
|
|
|
|
`msg.username` may contain the username. (v3 only)
|
|
|
|
|
|
|
|
`msg.authkey` may contain the digest security key. (v3 only)
|
|
|
|
|
|
|
|
`msg.privkey` may contain the encryption security key. (v3 only)
|
2017-04-22 16:53:04 +02:00
|
|
|
|
2016-02-11 23:50:30 +01:00
|
|
|
`msg.oid` may contain a comma separated list of oids to search for. (no spaces)
|
2015-03-04 20:55:53 +01:00
|
|
|
|
2017-04-22 16:53:04 +02:00
|
|
|
The host configured in the edit config will override `msg.host`. Leave blank if you want to use `msg.host` to provide input.
|
|
|
|
|
|
|
|
The community configured in the edit config will override `msg.community`. Leave blank if you want to use `msg.community` to provide input.
|
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
The username configured in the edit config will override `msg.username`. Leave blank if you want to use `msg.username` to provide input.
|
|
|
|
|
|
|
|
The digest security key configured in the edit config will override `msg.authkey`. Leave blank if you want to use `msg.authkey` to provide input.
|
|
|
|
|
|
|
|
The encryption security key configured in the edit config will override `msg.privkey`. Leave blank if you want to use `msg.privkey` to provide input.
|
|
|
|
|
2017-04-22 16:53:04 +02:00
|
|
|
The oids configured in the edit config will override `msg.oid`. Leave blank if you
|
2016-03-02 14:26:19 +01:00
|
|
|
want to use `msg.oid` to provide input.
|
2015-03-04 20:55:53 +01:00
|
|
|
|
2016-02-11 23:50:30 +01:00
|
|
|
Outputs `msg.payload` containing a table of objects, and the requested `msg.oid`.
|
|
|
|
Values depends on the oids being requested.
|
2015-03-04 20:55:53 +01:00
|
|
|
|
2017-06-27 00:02:34 +02:00
|
|
|
### snmp-set
|
|
|
|
|
|
|
|
SNMP sets the value of one or more OIDs.
|
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
`msg.host` may contain the host including the port.
|
|
|
|
|
|
|
|
`msg.community` may contain the community. (v1 and v2c only)
|
|
|
|
|
|
|
|
`msg.username` may contain the username. (v3 only)
|
2017-06-27 00:02:34 +02:00
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
`msg.authkey` may contain the digest security key. (v3 only)
|
|
|
|
|
|
|
|
`msg.privkey` may contain the encryption security key. (v3 only)
|
2017-06-27 00:02:34 +02:00
|
|
|
|
|
|
|
`msg.varbinds` may contain an array of varbind JSON objects e.g.:
|
|
|
|
```
|
|
|
|
msg.varbinds = [
|
|
|
|
{
|
|
|
|
"oid": "1.3.6.1.2.1.1.5.0",
|
|
|
|
"type": "OctetString",
|
|
|
|
"value": "host1"
|
|
|
|
}, {
|
|
|
|
"oid": "1.3.6.1.2.1.1.6.0",
|
|
|
|
"type": "OctetString",
|
|
|
|
"value": "somewhere"
|
|
|
|
}
|
|
|
|
];
|
|
|
|
```
|
|
|
|
Types can be:
|
|
|
|
|
|
|
|
* `Boolean`
|
|
|
|
* `Integer`
|
|
|
|
* `OctetString`
|
|
|
|
* `Null`
|
|
|
|
* `OID`
|
|
|
|
* `IpAddress`
|
|
|
|
* `Counter`
|
|
|
|
* `Gauge`
|
|
|
|
* `TimeTicks`
|
|
|
|
* `Opaque`
|
|
|
|
* `Integer32`
|
|
|
|
* `Counter32`
|
|
|
|
* `Gauge32`
|
|
|
|
* `Unsigned32`
|
|
|
|
* `Counter64`
|
|
|
|
* `NoSuchObject`
|
|
|
|
* `NoSuchInstance`
|
|
|
|
* `EndOfMibView`
|
|
|
|
|
|
|
|
The host configured in the edit config will override `msg.host`. Leave blank if you want to use `msg.host` to provide input.
|
|
|
|
|
|
|
|
The community configured in the edit config will override `msg.community`. Leave blank if you want to use `msg.community` to provide input.
|
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
The username configured in the edit config will override `msg.username`. Leave blank if you want to use `msg.username` to provide input.
|
|
|
|
|
|
|
|
The digest security key configured in the edit config will override `msg.authkey`. Leave blank if you want to use `msg.authkey` to provide input.
|
|
|
|
|
|
|
|
The encryption security key configured in the edit config will override `msg.privkey`. Leave blank if you want to use `msg.privkey` to provide input.
|
|
|
|
|
2017-06-27 00:02:34 +02:00
|
|
|
The varbinds configured in the edit config will override `msg.varbinds`. Leave blank if you want to use `msg.varbinds` to provide input.
|
|
|
|
|
|
|
|
|
|
|
|
|
2016-03-02 14:26:19 +01:00
|
|
|
### snmp-table
|
2015-03-04 20:55:53 +01:00
|
|
|
|
|
|
|
Simple SNMP table oid fetcher. Triggered by any input.
|
2017-04-22 16:53:04 +02:00
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
`msg.host` may contain the host including the port.
|
2017-04-22 16:53:04 +02:00
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
`msg.community` may contain the community. (v1 and v2c only)
|
2017-04-22 16:53:04 +02:00
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
`msg.username` may contain the username. (v3 only)
|
|
|
|
|
|
|
|
`msg.authkey` may contain the digest security key. (v3 only)
|
|
|
|
|
|
|
|
`msg.privkey` may contain the encryption security key. (v3 only)
|
|
|
|
|
|
|
|
`msg.oid` may contain a comma separated list of oids to search for. (no spaces)
|
2015-03-04 20:55:53 +01:00
|
|
|
|
2017-04-22 16:53:04 +02:00
|
|
|
The host configured in the edit config will override `msg.host`. Leave blank if you want to use `msg.host` to provide input.
|
|
|
|
|
|
|
|
The community configured in the edit config will override `msg.community`. Leave blank if you want to use `msg.community` to provide input.
|
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
The username configured in the edit config will override `msg.username`. Leave blank if you want to use `msg.username` to provide input.
|
|
|
|
|
|
|
|
The digest security key configured in the edit config will override `msg.authkey`. Leave blank if you want to use `msg.authkey` to provide input.
|
|
|
|
|
|
|
|
The encryption security key configured in the edit config will override `msg.privkey`. Leave blank if you want to use `msg.privkey` to provide input.
|
|
|
|
|
2017-04-22 16:53:04 +02:00
|
|
|
The oid configured in the edit config will override `msg.oid`. Leave blank if you
|
|
|
|
want to use `msg.oid` to provide input.
|
|
|
|
|
|
|
|
Outputs `msg.payload` containing the table of objects, and the requested `msg.oid`.
|
|
|
|
Values depends on the oids being requested.
|
|
|
|
|
|
|
|
### snmp-subtree
|
|
|
|
|
2020-08-06 19:10:09 +02:00
|
|
|
Simple SNMP oid subtree fetcher. Triggered by any input. Reads from OID specified and any below it.
|
2017-04-22 16:53:04 +02:00
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
`msg.host` may contain the host including the port.
|
2017-04-22 16:53:04 +02:00
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
`msg.community` may contain the community. (v1 and v2c only)
|
|
|
|
|
|
|
|
`msg.username` may contain the username. (v3 only)
|
|
|
|
|
|
|
|
`msg.authkey` may contain the digest security key. (v3 only)
|
|
|
|
|
|
|
|
`msg.privkey` may contain the encryption security key. (v3 only)
|
2017-04-22 16:53:04 +02:00
|
|
|
|
|
|
|
`msg.oid` may contain the oid of a single table to search for.
|
|
|
|
|
|
|
|
The host configured in the edit config will override `msg.host`. Leave blank if you want to use `msg.host` to provide input.
|
|
|
|
|
|
|
|
The community configured in the edit config will override `msg.community`. Leave blank if you want to use `msg.community` to provide input.
|
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
The username configured in the edit config will override `msg.username`. Leave blank if you want to use `msg.username` to provide input.
|
|
|
|
|
|
|
|
The digest security key configured in the edit config will override `msg.authkey`. Leave blank if you want to use `msg.authkey` to provide input.
|
|
|
|
|
|
|
|
The encryption security key configured in the edit config will override `msg.privkey`. Leave blank if you want to use `msg.privkey` to provide input.
|
|
|
|
|
2017-04-22 16:53:04 +02:00
|
|
|
The oid configured in the edit config will override `msg.oid`. Leave blank if you
|
2016-03-02 14:26:19 +01:00
|
|
|
want to use `msg.oid` to provide input.
|
2015-03-04 20:55:53 +01:00
|
|
|
|
2016-02-11 23:50:30 +01:00
|
|
|
Outputs `msg.payload` containing the table of objects, and the requested `msg.oid`.
|
|
|
|
Values depends on the oids being requested.
|
2016-04-12 20:18:48 +02:00
|
|
|
|
|
|
|
### snmp-walker
|
|
|
|
|
2020-08-06 19:10:09 +02:00
|
|
|
Simple SNMP oid walker fetcher. Triggered by any input. Reads from OID specified to the end of the table.
|
2017-04-22 16:53:04 +02:00
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
`msg.host` may contain the host including the port.
|
|
|
|
|
|
|
|
`msg.community` may contain the community. (v1 and v2c only)
|
|
|
|
|
|
|
|
`msg.username` may contain the username. (v3 only)
|
2017-04-22 16:53:04 +02:00
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
`msg.authkey` may contain the digest security key. (v3 only)
|
|
|
|
|
|
|
|
`msg.privkey` may contain the encryption security key. (v3 only)
|
2017-04-22 16:53:04 +02:00
|
|
|
|
|
|
|
`msg.oid` may contain the oid of a single table to search for.
|
|
|
|
|
|
|
|
The host configured in the edit config will override `msg.host`. Leave blank if you want to use `msg.host` to provide input.
|
|
|
|
|
|
|
|
The community configured in the edit config will override `msg.community`. Leave blank if you want to use `msg.community` to provide input.
|
|
|
|
|
2020-10-24 03:07:16 +02:00
|
|
|
The username configured in the edit config will override `msg.username`. Leave blank if you want to use `msg.username` to provide input.
|
|
|
|
|
|
|
|
The digest security key configured in the edit config will override `msg.authkey`. Leave blank if you want to use `msg.authkey` to provide input.
|
|
|
|
|
|
|
|
The encryption security key configured in the edit config will override `msg.privkey`. Leave blank if you want to use `msg.privkey` to provide input.
|
|
|
|
|
2017-04-22 16:53:04 +02:00
|
|
|
The oid configured in the edit config will override `msg.oid`. Leave blank if you
|
|
|
|
want to use `msg.oid` to provide input.
|
|
|
|
|
|
|
|
Outputs `msg.payload` containing the table of objects, and the requested `msg.oid`.
|
|
|
|
Values depends on the oids being requested.
|