This documentation provides a comprehensive guide to using the SNMP Tools, including the SNMP OID Fetcher, SNMP Set, SNMP OID Table Fetcher, SNMP OID Subtree Fetcher, and SNMP Walker Tools. These tools are designed to facilitate the management of SNMP-enabled devices by fetching and setting SNMP Object Identifiers (OIDs) and exploring SNMP OID trees.
The SNMP OID Fetcher Tool is tailored for retrieving SNMP Object Identifiers (OIDs) or lists of OIDs based on detailed input parameters.
To use these SNMP tools in your Node-RED environment, follow these steps:
- Clone or download this repository to your local machine.
- Open Node-RED.
- Navigate to the "Manage Palette" option in the menu.
- Click on the "Install" tab.
- Choose "Install from file" and select the downloaded repository file.
- Once installed, the SNMP nodes will be available in the Node-RED palette.
Activated by any input, the tool processes the provided parameters to fetch the specified OIDs.
-
msg.host
- The network host address. -
msg.port
- The network port. -
msg.community
- The SNMP community string. -
msg.username
- (For SNMP V3 only) The username for authentication. -
msg.auth
- (For SNMP V3 only) Specifies the security level for SNMP V3 communication. Options include 'noAuthNoPriv', 'authNoPriv', and 'authPriv'. -
msg.authProtocol
- (For SNMP V3 only) Defines the authentication protocol. -
msg.authKey
- (For SNMP V3 only) The key for digest-based message integrity. -
msg.privProtocol
- (For SNMP V3 only) Specifies the encryption protocol. -
msg.privKey
- (For SNMP V3 only) The key for message encryption. -
msg.oid(s)
- Specifies the OID(s) to be fetched.
OIDs must be numeric. The prefix "iso." is equivalent to "1".
The tool provides output in msg.payload
, containing the data of the fetched OIDs.
This document provides details on the SNMP Set Tool, designed for setting specific values on network devices via SNMP.
Types can be:
Boolean
Integer
OctetString
Null
OID
IpAddress
Counter
Gauge
TimeTicks
Opaque
Integer32
Counter32
Gauge32
Unsigned32
Counter64
NoSuchObject
NoSuchInstance
EndOfMibView
To incorporate these nodes into your Node-RED workflows, start by selecting and dragging them from the Node-RED palette to your workspace. Then, adjust the input parameters to meet your specific needs. By establishing connections between these nodes, you can seamlessly execute SNMP operations.
(Similar to the SNMP OID Fetcher Tool, with the addition of msg.varbinds
for specifying variables to set.)
Numeric inputs must be actual numbers, not strings. OIDs must be numeric, with "iso." being equivalent to "1".
This guide details the SNMP OID Table Fetcher Tool, which retrieves complete tables of SNMP OIDs based on specified inputs.
Activated by any input, offering a responsive activation mechanism.
(Similar to the SNMP OID Fetcher Tool, with msg.oids
indicating the OID of the table to be fetched.)
After a successful fetch, the tool outputs the data of the fetched OID table in msg.payload
.
Introduces the SNMP OID Subtree Fetcher Tool, crafted to query all OIDs starting from a specified base OID.
Activated by any input, begins fetching operations for the specified OID subtree upon receiving a trigger.
(Similar to the SNMP OID Fetcher Tool, with msg.oids
as the base OID for subtree fetching.)
Provides the fetched OID subtree data in msg.payload
.
The SNMP Walker Tool is crafted to fetch all nodes from a specified start OID to the end of an SNMP table.
Commences a "walk" from the specified starting OID upon any input.
(Similar to the SNMP OID Fetcher Tool, with msg.oids
as the starting OID for the walk.)
The OID must be numeric. The tool's "walking" behavior provides a unique approach to OID tree traversal.
Provides the data fetched from the OID tree in msg.payload
.
{
"host": "192.168.1.1",
"community": "public",
"oids": "1.3.6.1.2.1.1"
}
This project is licensed under the MIT License.