iReasoning product documentation

MIB Browser Version 16 User Guide

Learn how to query SNMP agents, work with MIB modules, monitor devices, and automate trap handling with iReasoning MIB Browser.

iReasoning MIB Browser is a desktop tool for managing SNMP-enabled devices and applications. It loads standard and proprietary MIB modules, tolerates some malformed MIB files, runs SNMP queries and updates, visualizes device data, and processes incoming notifications through a built-in Trap Receiver and rule engine. It is powered by the iReasoning SNMP API.

Major features

Requirements

Download and run MIB Browser

  1. Download the appropriate MIB Browser installer or archive. On Windows, run setup.exe. On macOS, Linux, or another UNIX platform, use the package provided for that platform or extract the archive to the directory of your choice.
  2. Start the application:
    • Windows: Open MIB Browser from its application shortcut.
    • Linux or UNIX: Open the MIB Browser installation directory and run browser.sh.
    • macOS 10.8 or later: Download mibbrowser.pkg, then install it in /Applications from Terminal:
      sudo installer -store -pkg mibbrowser.pkg -target /
      On earlier macOS versions, extract mibbrowser.zip, open the ireasoning/mibbrowser directory, and run browser.sh.

Enterprise Edition

Enterprise Edition can run the Trap Receiver and Watches as a system service. A Watch can send email or SNMP traps when a MIB object crosses a configured threshold.

On Windows, the service starts automatically. On Linux and macOS, configure the operating system to run $INSTALL_DIR/lib/runserver.sh at startup.

The MIB Browser interface

Toolbar

MIB Browser toolbar

MIB tree pane

MIB tree pane

The MIB tree area contains the tree pane at the top and the properties pane at the bottom.

Result pane

Result pane

Query results appear in a table. If an octet string is shown in hexadecimal format, double-click it to switch display modes.

Buttons on the right toolbar:

Stop button

Stop pending SNMP queries.

Clear Table button

Clear the result table.

Raw Data button

Open a dialog that shows the raw SNMP query results.

Find button

Find strings in the result pane.

Save button

Save values from the result pane to an XML file.

Open button

Load values from an XML file into the result pane.


Trap Receiver

Main window

Open the Trap Receiver from MIB Browser, or start it as a standalone window.

Trap Receiver window

The upper pane lists received traps. Select a trap to view its details in the lower pane.

Column Description
Description A summary of the received trap.
Source The IP address of the device that sent the trap.
Time The date and time when the Trap Receiver received the trap.
Severity The trap's assigned severity: Low, Medium, or High.
Ack Indicates whether the trap has been acknowledged.
Trap Receiver controls

Trap Filter button

Filter received traps by source IP address or trap OID.

Start Trap Receiver button

Start listening for traps. The button is disabled while the Trap Receiver is running. Opening the window does not start the receiver automatically.

Stop button

Stop listening for traps.

Add Trap Rule

Add a rule for processing traps. When a trap is selected, MIB Browser pre-fills applicable fields with data from that trap.

MIB Browser evaluates all applicable rules unless one marks the trap as ignored. Rules run in name order, so renaming a rule changes its position. For example, if rules A and B match the same trap and set different severities, B runs after A and determines the final severity.

Add Rule dialog

Rule conditions

Trap OID

For an SNMPv2 trap, use its snmpTrapOID. For an SNMPv1 trap, use enterpriseOID + '.0.' + specific.
Wildcards * and ? are supported. * matches any sequence of digits and periods; ? matches zero or one digit. For example, .1.3.6.4.155.12.* matches OIDs below .1.3.6.4.155.12. The pattern .1.3.6.4.155.12.? matches suffixes from 0 through 9, but not 11.

Allowed trap source IPs

Enter source IP patterns separated by commas. Wildcards * and ? are supported. For example, 1.2.3.* matches addresses from 1.2.3.0 through 1.2.3.255, while 1.2.3.? matches 1.2.3.0 through 1.2.3.9.

Variable-binding values contain

Enter one or more keywords separated by commas or vertical bars. The condition matches when any keyword occurs in a raw variable-binding value. Raw values use the format received from the agent and are not translated for display.

Rule actions

Play sound

Play a sound when the rule conditions match.

Run command

Run a system command when the rule conditions match. Use an absolute path if the executable is not available on PATH. You can include tokens in the command.

Send email

Send email when the rule conditions match. SMTP must first be configured in the SMTP tab of Trap Receiver Settings.

Issue SNMP request

Send an SNMP GET or SET request to an agent when the rule conditions match.

Send SNMP trap

Send an SNMPv1, SNMPv2c, or SNMPv3 trap when the rule conditions match.

Suppression tab

Suppression provides a cancellation window before a rule performs external actions. It is useful when a second, related trap reports that a problem has cleared, or when an operator acknowledges the original trap before notifications and automated actions should run.

To configure suppression for a rule:

  1. Open Add Rule or Edit Rule, configure the rule's Conditions and Actions, and then select the Suppression tab.
  2. Select Enable action suppression and enter a positive number in Delay actions for ... minutes.
  3. Optionally enter one or more related-trap conditions under Match any of the following. These conditions use OR logic: a match in any field cancels the pending actions. If every field is empty, acknowledging the original trap can still cancel them.
  4. Click Save Rule. A matching trap now creates pending actions instead of running them immediately.
Suppression cancellation conditions
Original trap is acknowledged Acknowledge the original trap in the Trap Receiver during the delay window. Its pending rule actions and delayed system-wide email are cancelled.
Trap OID Enter the OID of a related or clearing trap, or use Browse.... The same * and ? wildcard rules described for rule conditions are supported.
Trap source IPs Enter one or more source IP patterns separated by commas. Wildcards are supported.
Variable-binding values contain Enter one or more text values separated by commas or vertical bars. A related trap matches when a raw variable-binding value contains any entered value.

During the delay window, sound, rule-generated email, command execution, SNMP requests, and outgoing trap actions are held. If the window expires without cancellation, the actions run once. The rule's severity and description changes are applied immediately because they describe the received trap rather than perform an external action.

System-wide email forwarding: When Enable forwarding traps via email is selected in SMTP settings, a trap that matches a suppression-enabled rule also delays the system-wide email. This works even when the rule has no action selected on its Actions tab. If the original trap is acknowledged or a related trap matches during the window, the system-wide email is not sent. A related trap that cancels pending work is treated as a clearing event and does not trigger external actions of its own during that evaluation.

If several suppression-enabled rules match the same trap, each rule's own actions use its configured delay. The single system-wide email waits for the longest applicable delay and is cancelled when any applicable rule's cancellation condition is met. Traps that do not match a suppression-enabled rule continue to use immediate system-wide email forwarding.

Manage Rules

Edit or delete existing rules.

Clear Table button

Remove all rows from the trap table.

Export Table to CSV

Export table data to a CSV file.

Options

Open the Trap Receiver settings.


Options

Command-line tools

Command-line tools are located in $INSTALL_DIR\bin.


Keyboard shortcuts

Ctrl-L

Load a MIB file.

Ctrl-F

Find a MIB node.

Ctrl-G

Run an SNMP GET operation.

Ctrl-N

Run an SNMP GET-NEXT operation.

Ctrl-E

Run a Get Subtree operation.

Ctrl-S

Run an SNMP SET operation.

Ctrl-W

Run an SNMP walk.

Ctrl-P

Stop current operation.

Enter

When the Operations list or Go button has focus, press Enter to repeat the last operation.

Ctrl-T

Open Table View.

Ctrl-R

Plot a graph.

Ctrl-D

Add to Watches.

Ctrl-O

Open the Watches pane.

Ctrl-I

Open the Trap Receiver pane.


Choose an edition

Personal Edition is free for private use on one workstation. You may redistribute the complete package for private use, but you may not use this edition for commercial or professional work.

Professional Edition adds management and monitoring features and is licensed for commercial or professional use.

Enterprise Edition adds service-based operation, advanced Trap Receiver capabilities, and enhanced monitoring.


Feature comparison

Feature Personal Edition Professional Edition Enterprise Edition

Runs on Windows, macOS, Linux, and other UNIX platforms

Included

Included

Included

Supports basic SNMP operations

Included

Included

Included

Table view for MIB tables

Included

Included

Included

SNMPv3 USM user management

Included

Included

Trap Receiver

Included

Included

Included

Trap Sender

Included

Included

Included

Supports IPv6

Included

Included

Included

Supports SNMPv1/v2c

Included

Included

Included

Supports loading any standard or private MIB

Included

Included

Included

Maximum number of loaded MIBs

10

No restrictions

No restrictions

Free

Included

Supports SNMPv3

Included

Included

SNMP expressions

Included

Included

Watches

Included

Included

Address Groups

Included

Included

Network discovery

Included

Included

ICMP Ping tool

Included

Included

ICMP Traceroute tool

Included

Included

Performance graph

Included

Included

Port view

Included

Included

Switch port mapper

Included

Included

Device snapshot

Included

Included

Cisco device snapshot

Included

Included

Device comparison

Included

Included

Trap forwarding by email

Included

Included

Periodic MIB table refresh

Included

Included

Dynamic table-row creation and deletion

Included

Included

Rule engine for processing traps

Included

Included

Run the Trap Receiver and Watches as a service

Included

Watch actions

Included

Email template

Included