SNMP (Simple Network Management Protocol)
The SNMP Device Driver provides communications via Simple Network Management Protocol (SNMP) allowing to exchange management information with SNMP-compliant network devices. All versions of SNMP protocol (v1, v2(c) and v3) are supported including secure communications introduced in SNMP version 3.
Like with all other types of devices, data collected from SNMP devices is converted into unified form to allow accessing them from different Iotellect facilities. See Devices article for more information about the "normalized" representation of devices in Iotellect.
There are two basic SNMP monitoring methods described further in this section: polling and event (Trap/Inform) monitoring.
Refer to SNMP Global Settings subsection for details about global settings used by SNMP service.
 | To use SNMP device driver on a Linux-based Iotellect Server, make sure that localhost is correctly configured in 127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4 |
Selected Entities Mode
SNMP device driver has a special behaviour when Active Entities switch in Generic Device Properties is set to Selected Entities.
Normally, when Active Entities is set to All Entities, the driver performs SNMP walk to discovery what variables are available in each asset (MIB file).
If Active Entities is set to Selected Entities, Variables list in device account properties contains all variables that are defined in an asset (MIB file). In this case, driver directly reads selected variables according to MIB file without performing SNMP walk.
Thus, for devices that provide large volume of SNMP information Selected Entities mode is recommended to speed up device synchronization and avoid storage of unnecessary values.
Driver Information
Driver Plugin ID: | com.tibbo.linkserver.plugin.device.snmp |
Global Settings
See SNMP Global Settings.
User Level Settings
None defined.
Device Account Properties
Device properties define SNMP communication parameters for the particular device. They comprise:
Host Address (
address) property that specifies IP Address or Host Name of the network host to be monitoredPolling Settings that are used to periodically obtain current status of the SNMP device (poll it).
Device Assets
The driver creates one root asset for every MIB file supported by the device. Supported MIB files are detected automatically by polling the SNMP agent.
 | Assets for MIBs that are marked as Default in MIB Directory will be enabled automatically. |
Device Settings
SNMP device settings present results of the last polling operation.
Device Operations
Get SNMP Variables. This operation serves for pulling values of raw SNMP OIDs from the device. The connection settings defined in device account are used.
Set SNMP Variables. This operation serves for pushing values of raw SNMP OIDs into the device. The connection settings defined in device account are used
| The Get and Set operations address fully indexed scalar variables. It means you have add |
Device Events
SNMP devices generate two different types of events: Service Outage (indicating SNMP downtime as described in Network Host device driver chapter) and SNMP notification (see below).
SNMP Notification
SNMP driver generates events on reception of SNMP notifications (both traps and informs). Refer to SNMP Notifications Monitoring section for details.
| Since SNMP driver listens for the notifications from all network hosts (not only hosts that match to a certain Device account), the Trap events are generated in the Network Management context instead of Device context. |
Event Name | trap |
Permissions | Accessible at User permission level |
Records | 1 |
The trap event has the following format:
Field Name | Field Type | Notes |
agentAddress | String | SNMP Agent Address, i.e. IP address of the object generating the trap. |
version | String | Trap version. |
type | String | Trap type (Trap or Inform). |
enterprise | String | Enterprise. Corporation or organization that originated the trap. This is the object identifier (OID) assigned to the vendor implementing the agent. Equals to the value of the sysObjectID variable, and it is unique for each implementer of an SNMP agent. |
genericTrap | Integer | Generic Trap Type ID. Integer, see table below. |
specificTrap | Integer | Specific Trap Type ID. Defined when Generic Trap Type is set to Enterprise. |
oid | String | Trap OID. |
timestamp | Date | Elapsed time, in hundredths of a second, from the last reinitialization of the agent to the event generating the trap. |
variableBindings | Data Table | Variable Bindings. Extra information, dependent on generic-trap type. |
engineID | String | SNMP engine ID of the trap originator. Only compatible with SNMPv3, and must be configured on the device. |
The following Generic Trap Type ID values are defined for genericTrap field:
Value | Name | Description |
0 | coldStart | The agent is reinitializing. Configuration data or MIB variable values, or both, might have changed. Restart the measurement epochs. |
1 | warmStart | The agent is reinitializing but configuration data or MIB variable values have not changed. |
2 | linkDown | The agent has detected that a known communications interface has been disabled. |
3 | linkUp | The agent has detected that a known communications interface has been enabled. |
4 | authenticationFailure | A message was received that could not be authenticated. |
5 | egpNeighborLoss | An Exterior Gateway Protocol (EGP) neighbor was lost. |
6 | enterpriseSpecific | Vendor-specific trap. Specific Trap Type ID should be defined. |
Connection Handling
This driver makes the device Online if SNMP polling operation reports no errors.
Synchronization Details
The synchronization procedure executes SNMP polling operations, refer to SNMP polling section for details.
Was this page helpful?