Sensu SNMP Trap Check Extension

Creates a SNMPv2 trap listener as part of the Sensu client process. This SNMP trap extension loads MIBs and attempts to translate SNMP traps into Sensu check results.

Inspiration

This SNMP trap extension was inspired by the work done by Toby Jackson on SNMPTrapHandler.

Installation

sensu-install -e snmp-trap

Edit /etc/sensu/conf.d/extensions.json to load it.

{
  "extensions": {
    "snmp-trap": {
      "version": "0.0.2"
    }
  }
}

Configuration

param type default description
:bind :string 0.0.0.0 IP to bind the SNMP trap listener to
:port :integer 1062 Port to bind the SNMP trap listener to
:community :string "public" SNMP community string to use
:handlers :array ["default"] Handlers to specify in Sensu check results
:mibs_dir :string "/etc/sensu/mibs" MIBs directory to import and load MIBs from