New Plugin - SNMP

---

And another plugin is ready. Today it’s pimatic-snmp.
With this plugin you can request values from snmp devices like switches, servers and many many more.

You can find the plugin on github and npm.

Plugin Configuration

{
      "plugin": "snmp",
      "debug": false
}

The plugin has the following configuration properties:

Device Configuration

The following device can be used:

SnmpSensor

The SnmpSensor displays the output of your specified command to the gui.

{
		"id": "snmp1",
		"class": "SnmpSensor",
		"name": "Snmp Sensor",
		"host": "",			
		"oid": ""
}

If you already created a SnmpSensor device and you change the oid later, all attributes from this device need to be deleted, before the new attributes are shown.

Please note, that the oid must be provided as array like [1,3,6,2,0]. The oid for your device can be found be searching the mib file(s) width are mostly provided by the manufactur.

nice!
does this plugin support autodiscover devices?

@n3ro not yet, but i will put this on my todo list. discovering devices would be possible i think, but discover oids or exacte value will be a pain in the ass, because most devices have sooo many oids.

@thost96 hehe^^

Maybe you find the definitions for multiple snmp devices in the checkmk configs.

https://mathias-kettner.de/checkmk_devel_snmpscan.html

I would love to hear more about taking apart the MIB file for the adresses, until now i cannot add any entry to the device!
(Readynas MIB file here )

@Stokstaart your provied mib doesn’t have any object identifiers in it, so this will not work. Try this oid list: http://www.oidview.com/mibs/4526/READYNAS-MIB.html

@thost96 Thanks! I tried to add one of the objects but i keep getting a “No description was given” error…
On the edit device page, what should be put in the field under “Add a property”? Should this be the name or the Object Identifier??
and of course, for the next field the same…??

Edit*) Typo

@Stokstaart under add a property you don’t need to add anything. The attributes will be created automatically after the first snmp get request. Make sure, when you change the oid requested, all attributes need to be cleared!

Could you please post your device config?

@thost96
Sure, here’s the config right after adding the device…

 {
      "host": "192.168.178.200",
      "attributes": {},
      "id": "snmp3",
      "name": "SNMP3",
      "class": "SnmpSensor"
    }

Looks like i’m missing the OID, but it was greyed out when i was creating the device!

Any idea hwat i am doing wrong??

@Stokstaart okay, the device config schema has a mistake. I will fix this and release a new version today

@thost96 No problem! Just glad it wasn’t me

@Stokstaart I release version 0.1.2 of pimatic-snmp which should fix this error. I also created a issue on github. Please reopen this, if your error still occurs.

Please not, that the oid must follow this format: .1.2.840.10006.300.43.1.3.0

@thost96 Okay, updated, restarted but no joy:
When i configure the nasMgrSoftwareVersion OID in the device it stays empty…Am i doing something wrong or is this not going to work for my ReadyNas?

{
      "host": "192.168.178.200",
      "oid": "1.3.6.1.4.1.4526.18.1",
      "attributes": {},
      "id": "snmp",
      "name": "SNMP",
      "class": "SnmpSensor"
    }

@Stokstaart try this: "oid": ".1.3.6.1.4.1.4526.18.1",

Or maybe your readyNas uses another snmp community than "public"

Hi, If I put into the config:

    {
      "id": "mikrotik-router",
      "class": "SnmpSensor",
      "name": "Mikrotik router",
      "host": "10.0.0.1",
      "community": "communa",
      "oid": ".1.3.6.1.2.1.1.3.0",
      "attributes": { }
    }

Plugin of it done this:

    {
      "id": "mikrotik-router",
      "class": "SnmpSensor",
      "name": "Mikrotik router",
      "host": "10.0.0.1",
      "community": "communa",
      "oid": ".1.3.6.1.2.1.1.3.0",
      "attributes": {
        ".1.3.6.1.2.1.1.3.0": {
          "type": "string",
          "description": ".1.3.6.1.2.1.1.3.0",
          "value": "0",
          "acronym": ".1.3.6.1.2.1.1.3.0",
          "label": ".1.3.6.1.2.1.1.3.0",
          "discrete": true
        }
      }
    }

But value is also empty.

@thost96 okay, adding the “.” in front of the OID right now gives me back the firmware version (i think…) ( @wutu i changed the update interval…)

But now no matter which OID i give the Device or New Device i always get the firmware back… Any ideas?

Change interval not helped for me.

I think the reason, why the value isn’t displayed directly, is that the function for reading the data from the device is only execute after the interval and not directly. I will try to fix this.

@Stokstaart Did you cleared the attributes after changing the oid?

EDIT: I published v0.1.3 which should fix the error mentioned above. Please try your device configuration again after updating to the last version.

Hello,
Nice new Plugin.

By the way, just tried with my NAS from Qnap.
Here are some OID’s

(".1.3.6.1.4.1.24681.1.2.12.0", 			"ModelName");
(".1.3.6.1.4.1.24681.1.2.2.0", 				"SystemTotalMem", "CapacityMB");
(".1.3.6.1.4.1.24681.1.2.3.0", 				"SystemFreeMem", "CapacityMB");
(".1.3.6.1.4.1.24681.1.2.17.1.4.1", 			"SysVolumeTotalSize", "CapacityGB");
(".1.3.6.1.4.1.24681.1.2.17.1.5.1", 			"SysVolumeFreeSize", "CapacityGB");
(".1.3.6.1.4.1.24681.1.2.4.0", 				"SystemUptime");
(".1.3.6.1.4.1.24681.1.2.5.0", 				"CPU-Temperature", "Temperature");
(".1.3.6.1.4.1.24681.1.2.6.0", 				"System-Temperature", "Temperature");
(".1.3.6.1.4.1.24681.1.2.15.1.3.1", 			"System-FanSpeed", "FanSpeed");
(".1.3.6.1.4.1.24681.1.2.11.1.3.1", 			"HDTemperature1", "Temperature");
(".1.3.6.1.4.1.24681.1.2.11.1.3.2", 			"HDTemperature2", "Temperature");
(".1.3.6.1.4.1.24681.1.2.11.1.3.3", 			"HDTemperature3", "Temperature");
(".1.3.6.1.4.1.24681.1.2.11.1.3.4", 			"HDTemperature4", "Temperature");
(".1.3.6.1.4.1.24681.1.2.11.1.7.1", 			"HDSmartInfo1", "SmartStatus");
(".1.3.6.1.4.1.24681.1.2.11.1.7.2", 			"HDSmartInfo2", "SmartStatus");
(".1.3.6.1.4.1.24681.1.2.11.1.7.3", 			"HDSmartInfo3", "SmartStatus");
(".1.3.6.1.4.1.24681.1.2.11.1.7.4", 			"HDSmartInfo4", "SmartStatus"); 

Is there anywhere a list of OID’s for some other devices?

And another question:
Is it possible to set the variable to number? so that you could see the graph?
I just can set it to string. If it’s number it has “NaN”.

Mit freundlichen Grüßen
Chris

@chris Must be because of the C/ XXX F in the value returned from the Qnap.
I changed my Fanspeed to number and was instantly suprised with a sparkline and had the abality to plot a graph!