5.39. snmptrap

The snmptrap module provides SNMP trap daemon support for reconnoiter. Reconnoiter comes with a snmptrap-based helper utility called noittrap aimed to assist with the complexities of forming valid SNMP traps to this module.

loader

C

image

snmp.so

5.39.1. Module Configuration

community
required

required

allowed

.+

The SNMP community string providing trap access.

snmptrapd_port
required

optional

allowed

\d+

The port on which traps are accepted.

5.39.2. Check Configuration

community
required

optional

allowed

.+

The SNMP community string providing trap access (overrides modules config).

Example 5.41. Simple passive checking.

The following example configures a check prepared to accept traps from host 10.1.1.1. Traps must be performed with the community name 's3cr3t'. Note that because this check is passive, the timeout and period mean nothing to reconnoiter. Though these values may be used by an upstream provider for fault detection.

      <noit>
        <modules>
          <module image="snmp" name="snmptrap">
            <config>
              <community>s3cr3t</community>
            </config>
          </module>
        </modules>
        <checks>
          <check uuid="1b4e28ba-2fa1-11d2-883f-e9b761bde3fb" module="snmptrap" name="magic"
                 period="60000" timeout="30000"/>
        </checks>
      </noit>