torrus_action_snmpv1trap(7)

torrus_action_snmpv1trap7

Scripts for sending snmp traps (version 2c and 1 respectively) from monitor action. "action_snmpv1trap" is obsolete as the preferred snmp version is 2c.

Part of torrus_action_snmptrap(7).

Usage

 <action name="snmptrap">
   <param name="action-type" value="exec" />
   <param name="command" value="$TORRUS_BIN/action_snmptrap" />
   <param name="launch-when" value="set, clear" />
 </action>

Overview

This program is designed for usage from a monitor action only. It takes the arguments from environment variables, as described in action-type "exec" in Torrus XML Configuration Guide. In addition, some values may be supplied via command-line arguments (see section OPTIONS below).

Site-specific variables must be specified in the file snmptrap-siteconfig.pl. Default values are installed by the first run of "make install". Subsequent runs of "make install" do not override this file.

Options

--host=HOSTNAME

Sets the hostname of the destination host.

--community=COMMUNITY

Sets the community string to use when sending the trap.

--port=PORT

Sets the destination UDP port.

--enterprise=OID

Sets the "enterprise" field of the SNMPv1 trap to a given OID (see RFC 1157 for more details). This option is only available for "action_snmpv1trap" and will be ignored for "action_snmptrap".

--severity=SEVERITY

Sets the optional severity SNMP variable to some integer value.

Files

/etc/torrus/conf/snmptrap-siteconfig.pl

Torrus site configuration script for SNMP traps.

Notes

See more documentation at Torrus home page: http://torrus.org

Releases

10 releases since Debian 4.0 (Etch); the text changed 8 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7
  5. 8
  6. 9
  7. 10
  8. 11
  9. 12–13

Author

Stanislav Sinyagin <[email protected]>

From torrus-common 3.00-2 in Debian 13 (Trixie). Parsed by carta from the page's man source.