PULSE - Monitoring Tool for JIRA
Page tree
Skip to end of metadata
  • Created by Unknown User (robert.dzido@infodesign.pl) on Sep 06, 2016
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

Protocol Overview

SNMP (Simple Network Management Protocol) is is an Internet-standard protocol for collecting and organizing information about managed devices on IP networks and for modifying that information to change device behavior. Devices that typically support SNMP include routers, switches, servers, workstations, printers, modem racks and more. Read more on Wikipedia.

Implemented features

Currently SNMP protocol allows you to add SNMP device monitoring query then read and parse its result. For example you can query your printer status/check ink or toner level or just do a server health check.

SNMP queries uses MIB trees to ask a device for a particular setting or status. For example OID 1.3.6.1.2.1.25.3.5.1.1.1 stands for current printer status (in Printer-MIB). Different devices may have different OID meaning. More details you may find in your device documentation or after contact with producent.

Protocol settings

Examples

Below you can find some screenshots showing some typical configuration. Please note it can vary depending on your device vendor and model. We recommend to check SNMP queries and results using an external software (like Open Source Net-SNMP) before implementing your service monitor.

Printer Health Check

Below you can find a Printer Status Check.

Net-SNMP query and result (printer available under 192.168.1.106 IP address queried from Windows host, SNMP version 2 is in use and community name allowed by the device is "public")

snmpget.exe -v2c -Of -c public 192.168.1.106 1.3.6.1.2.1.25.3.5.1.1.1
.iso.org.dod.internet.mgmt.mib-2.host.hrDevice.hrPrinterTable.hrPrinterEntry.hrPrinterStatus.1 = INTEGER: idle(3)

If you imitate properties above in PULSE - Monitoring Tool for JIRA SNMP protocol, you will get "3" as result of the query. Net-SNMP allows you to specify output. if you want to display only returned value (without MIB tree) you can use "-Ov" parameter. In that case output will looks like below:

snmpget.exe -v2c -Ov -c public 192.168.1.106 1.3.6.1.2.1.25.3.5.1.1.1
INTEGER: idle(3)


Default SNMP protocol port is UDP 161 and if you will not set port value during setup it will be set to default value. 

If each time you test your SNMP service you are getting notification about unreachable host it is worth to check if:

  • community name is correct,
  • host address is correct,
  • tested device is in the same network as you are,
  • specified protocol version is correct (remember that 3rd version of SNMP protocol is NOT available in PULSE - Monitoring Tool for JIRA yet),
  • port is default or the same as tested device.

if your SNMP service returns "NULL" value there are two options:

  • OID you have used is invalid,
  • SNMP server returns non-numerical value (i.e date/time). 
     

Important

Currently PULSE - Monitoring Tool for JIRA supports only numerical values returned by SNMP queries. It allows you to define "correct' or "expected" values and check if they matches to your definition. If not - test result will be set as failure. In case SNMP protocol returns text value, it will be thrown as service state description. You can always check returned value by executing a test of the specified service.



  • No labels