Just getting started? Checkout the wiki

An object oriented Ruby wrapper around the C netsnmp libraries. It provides classes for manager sessions, agents, pdus, varbinds, MIB inspection, and more.

The gem also includes some useful executables including:

• net-snmp2
  • An interactive REPL for inspecting the MIB, and acting as an SNMP manager.
  • Supports managing multiple agents at once.
  • Implemented on top of Pry, so it inherits all of Pry's goodness.
• mib2rb
  • A mib2c like tool that uses ERB files to format and display the system MIB.
  • mib2rb has a default template that prints the MIB details in a human-readable format, providing functionality similar to snmptranslate.

• Improved Windows support over original net-snmp gem
• Supports SNMP versions 1, 2c, and 3
• Supports both synchronous and asynchronous calls
• Supports sending of snmpv1 traps and snmpv2 traps/informs using TrapSession
• Integrates well with eventmachine, or can be used standalone.
• In Ruby 1.9, uses fibers behind the scenes to emulate synchronous calls asynchronously
• MIB support
• Convenience methods such as session.walk, session.get_columns, and session.table
• SNMP Agent support
• Trap handler support

• TrapHandler & Agent support doesn't work on default Windows build of net-snmp libraries, due to certain functions not being exported in the dll.
  • I've submitted this as a feature request
  • The patch has been accepted!
    • These changes are now available in net-snmp master, as well as v5.7-patches
    • You can build either of these from source if you need trap handler & agent support on Windows...
    • Or, you can wait until they release an official binary of v5.7
    • Or, you can try my pre-built DLL
• The wiki has the best documentation for now.
  • All the specs are passing, so that's another good place to go for information.
  • There is also the built-in net-snmp2 program you can run. This is an interactive Pry shell that is very useful for digging around the code and getting a feel for how to do things.