torrus_action_snmptrap

Langue: en

Version: 2009-05-14 (debian - 07/07/09)

Section: 7 (Divers)

NAME

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

SYNOPSIS

  <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>
 
 

DESCRIPTION

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.

SEE ALSO

torrus(8)

NOTES

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

AUTHOR

Stanislav Sinyagin <ssinyagin@yahoo.com>