Back to homepage

Snmptraptools

Warning

This tools is very old and was tested under Windows XP. It might works under Windows 7 or Windows 2008. It will probably not work under more recent Operating System.

Description

Snmptraptools is a set of tools to handle SNMP traps easily under Microsoft Windows.
The project is stored on GitHub where you can download sources or setup program.

Why this program exists

The first aim of this application was to run a script (perl, batch, vbs, python, etc.) or any program when a Windows server recieves a SNMP trap.
Now, the program works using plugins in order to easily add new functionalities. The current included plugins are:

• E-mail – Send an electronic mail
• Http – Push data to a server via http post request
• Syslog – Write a syslog entry through the network
• Messagebox – Display an alert using message box
• Execute – Run an external program

Note: default configuration is to display a messagebox when a SNMP trap of OID 1.3.6.1.4.1.* is recieved.

How does it work

Main application is splitted into two programs:

• A Windows service handles recieved traps (snmptraphandler) and transmit its to next process
• The next process (snmptrapdispatcher), started and controlled by the service, looks for maching rules and then route the trap to corresponding plugin to trigger configured action

The network part is completely isolated from the rest of the application.

A third program, which is graphical, is used to define the rules and configure each plugin settings (snmptrapconfig).

Configuring

Trap filtering

The dispatcher program is able to select plugin to route trap regarding the rule define. For each rule, you define the OID and optionnaly the generic or specific trap code.

How I know what is the OID/trap code of my equipment?

The manufacturer of your equipment can provide you this information, else you can find received trap information in this log file:
[system directory]\snmptrapnetwork.log

If I prefer to deal with MIB files?

It's tidier. Use included tool import-mib.exe to import MIB-defined-trap OIDs to snmptraptools. Drag and drop mib file on this program and defined traps will be added to registry. After this operation, you must restart service to apply configuration changes.

Download

Go to GitHub project.