Accept License Agreements

This app is provided by a third party and your right to use the app is in accordance with the license provided by that third-party licensor. Splunk is not responsible for any third-party apps and does not provide any warranty or support. If you have any questions, complaints or claims with respect to this app, please contact the licensor directly.

Thank You

Downloading SNMP Modular Input
MD5 checksum (snmp-modular-input_127.tgz) ad77127b257717e11f64a8db1555358a MD5 checksum (snmp-modular-input_126.tgz) 9455e3371d845b7a47cf951a551ed21b MD5 checksum (snmp-modular-input_125.tgz) ffb30868dae228286104b9555f2d0044 MD5 checksum (snmp-modular-input_124.tgz) 7d31682a5be16ab87b9998313b380582 MD5 checksum (snmp-modular-input_123.tgz) 06d05b0e5b90e77df4b13096846aaa3b MD5 checksum (snmp-modular-input_122.tgz) fbde14c9751978c30f126f495d199706 MD5 checksum (snmp-modular-input_121.tgz) f4073f9641f8f07a8245298b9b94847c MD5 checksum (snmp-modular-input_12.tgz) 1d65dacb6179d03434c07795e6dd68bb MD5 checksum (snmp-modular-input_106beta.tgz) b81652565a1c106cb9772bc99751d084 MD5 checksum (snmp-modular-input_105beta.tgz) 1b2a3a098dd1b6218785bf0491a4de21 MD5 checksum (snmp-modular-input_104beta.tgz) 965d2a462ea7f3fed7b8a0ac0736fd7f MD5 checksum (snmp-modular-input_103beta.tgz) 9ba81ec6291a29485b9785c43d13cc7d MD5 checksum (snmp-modular-input_102beta.tgz) c1de4ac29fdefcd54e6fcd9b5d747515 MD5 checksum (snmp-modular-input_101beta.tgz) 1a4a1557872eae6cfa479ee3be30ea30 MD5 checksum (snmp-modular-input_10beta.tgz) 755069497d46020f7848b049b658ea37
To install your download
For instructions specific to your download, click the Details tab after closing this window.

Flag As Inappropriate

SNMP Modular Input

Overview
Details
SNMP Modular Input to poll attribute values and catch traps

SNMP Modular Input v1.2.7

By Damien Dallimore , damien@baboonbones.com

Overview

This is a Splunk modular input add-on for polling SNMP attributes and catching traps.

Features

  • Simple UI based configuration via Splunk Manager
  • Capture SNMP traps (Splunk becomes a SNMP trap daemon in its own right)
  • Poll SNMP object attributes
  • SNMP version 1,2c and 3 support
  • Declare objects to poll in textual or numeric format
  • Ships with a wide selection of standard industry MIBs
  • Add in your own Custom MIBs
  • Walk object trees using GET BULK
  • Optionally index bulk results as individual events in Splunk
  • Monitor 1 or more Objects per stanza
  • Create as many SNMP input stanzas as you require
  • IPv4 and IPv6 support
  • Indexes SNMP events in key=value semantic format
  • Plug in your own custom response handler for formatting or pre-processing
  • Ships with some additional custom field extractions

Dependencies

  • Splunk 5.0+
  • Supported on Windows, Linux, MacOS, Solaris, FreeBSD, HP-UX, AIX

Setup

  • Untar the release to your $SPLUNK_HOME/etc/apps directory
  • Restart Splunk

SNMP Version 3 Crypto Libraries

If you are using SNMP version 3 , you have to obtain, build and add the pycrypto package yourself :

https://pypi.python.org/pypi/pycrypto

The simplest way is to build pycrypto and drop the "Crypto" directory in $SPLUNK_HOME/etc/apps/snmp_ta/bin.
I don't recommend installing the pycrypto package to the Splunk Python runtime's site-packages, this could have unforeseen side effects.

Building and installing PyCrypto

I do not bundle the pycrypto module with the core release , because :

  • you need to build it for each separate platform
  • US export controls for encrypted software

So , here are a few instructions for building and installing pycrypto yourself :

  • Download the pycrypto package from https://pypi.python.org/pypi/pycrypto

  • Then run these 3 commands (note : you will need to use a System python 2.7 runtime , not the Splunk python runtime)

    python setup.py build
    python setup.py install
    python setup.py test
    

3) browse to where the Crypto module was installed to ie: /usr/local/lib/python2.7/dist-packages/Crypto

4) Copy the "Crypto" directory to $SPLUNK_HOME/etc/apps/snmp_ta/bin

Adding Custom MIBs

The pysnmp library is used under the hood so you need to convert your plain text MIB files
into python modules :

Many industry standard MIBs ship with the Modular Input.
You can see which MIBs are available by looking in SPLUNK_HOME/etc/apps/snmp_ta/bin/mibs/pysnmp_mibs-0.1.4-py2.7.egg

Any additional custom MIBs need to be converted into Python Modules.

You can simply do this by using the build-pysnmp-mib tool that is part of the pysnmp installation. Note ,that you will need to install pysnmp version 4.2.5 in order to get the utility tools , as the latest releases of pysnmp no longer contain these tools.
https://pypi.python.org/pypi/pysnmp/4.2.5

build-pysnmp-mib -o SOME-CUSTOM-MIB.py SOME-CUSTOM-MIB.mib

build-pysnmp-mib is just a wrapper around smidump.

So alternatively you can also execute :

smidump -f python MYMIB.mib | libsmi2pysnmp > MYMIB.py

Then you can either copy the generated python files to SPLUNK_HOME/etc/apps/snmp_ta/bin/mibs or build a Python "egg" of
the generated python files(maybe tidier if you have many python files) and copy the egg to that same location.

In the configuration screen for the SNMP input in Splunk Manager , there is a field called “MIB Names” (see above).
Here you can specify the MIB names you want applied to the SNMP input definition ie: IF-MIB,DNS-SERVER-MIB,BRIDGE-MIB
The MIB Name is the same as the name of the MIB python module in your egg package.

Custom Response Handlers

You can provide your own custom Response Handler. This is a Python class that you should add to the
rest_ta/bin/responsehandlers.py module.

You can then declare this class name and any parameters in the SNMP Modular Input setup page.

For the most part the Default Response Handler should suffice.

But there may be situations where you want to format the response in a manner that is more convenient for handling your data ie: CSV or JSON.
Furthermore , you can also use a custom Response Handler implementation to perform preprocessing of your raw response data before sending
it to Splunk.

Logging

Any modular input log errors will get written to $SPLUNK_HOME/var/log/splunk/splunkd.log

Troubleshooting

  • You are using Splunk 5+
  • Look for any errors in $SPLUNK_HOME/var/log/splunk/splunkd.log

Release Notes

Version 1.2.7
Nov. 20, 2014

Merged in community Pull requests.

Add a new option to get subtree
Add a new option to perform rDNS for trap source
Fix to resolve missing server extractions on the SNMPv3 trap receiver

Version 1.2.6
June 16, 2014

In the destination field for polling attributes , you can now optionally specify a comma delimited list of hosts

Version 1.2.5
June 13, 2014

Fixed Bug in UI that prevented declaring custom MIB Names when in listen traps mode

Version 1.2.4
May 17, 2014

Fixed host field extraction for receiving v2 traps

Version 1.2.3
March 28, 2014

Minor code tweaks

Version 1.2.2
Feb. 23, 2014

Updated the Manager UI to be simpler and more intuitive

Version 1.2.1
Feb. 13, 2014

Minor Cosmetic fixes

Version 1.2
Oct. 30, 2013

SNMP v3 support , please follow the docs regarding pycrypto dependencies

pysnmp library update to 4.2.5

Support for plugging in custom response handlers that can format the raw SNMP data in a particular format or perform preprocessing on the raw SNMP data before indexing in Splunk. Has a default response handler which produces the same output as previous versions.Also ships with an example JSONFormatterResponseHandler.

Robustified exception handling

More detailed logging

Version 1.0.6beta
July 29, 2013

Added more lenient exception handling code so that the trap listener won't terminate when it can't resolve an OID , and will instead just index the raw OID and print the error message to splunkd.log

Version 1.0.5beta
July 15, 2013

For custom MIBS , added the ability to drop plain python(.py) files into the bin/mibs directory , no need to egg them up

Version 1.0.4beta
June 27, 2013

Tweaked the Manager UI list view

Version 1.0.3beta
June 23, 2013

Got MIB resolution working properly for traps and attribute polling , added a config field so you can declare any MIB names you want applied, any custom MIBs still need to be converted into Python modules first(see the docs) ++ Added a config option to split out "get bulk" results into individually indexed events ++ changed the setup screen layout to be better organised

Version 1.0.2beta
June 20, 2013

Renamed the manager xml file to avoid naming clashes

Version 1.0.1beta
May 30, 2013

Some minor script tweaks around custom MIB loading

Version 1.0beta
May 23, 2013

849
Installs
15,836
Downloads
Share Subscribe LOGIN TO DOWNLOAD

Subscribe Share

Splunk Certification Program

Splunk's App Certification program uses a specific set of criteria to evaluate the level of quality, usability and security your app offers to its users. In addition, we evaluate the documentation and support you offer to your app's users.

Are you a developer?

As a Splunkbase app developer, you will have access to all Splunk development resources and receive a 50GB license to build an app that will help solve use cases for customers all over the world. Splunkbase has 1000+ apps and add-ons from Splunk, our partners and our community. Find an app or add-on for most any data source and user need, or simply create your own with help from our developer portal.

Follow Us:
© 2005-2017 Splunk Inc. All rights reserved.
Splunk®, Splunk>®, Listen to Your Data®, The Engine for Machine Data®, Hunk®, Splunk Cloud™, Splunk Light™, SPL™ and Splunk MINT™ are trademarks and registered trademarks of Splunk Inc. in the United States and other countries. All other brand names, product names, or trademarks belong to their respective owners.