Enabling SNMP alerts
About this task
Enable and configure SNMP alerts in the config_location/event-plugins/snmp.conf file.
Multiple instances of the
snmp.conf file results in multiple instances of an event plugin.
The SNMP configuration file can have any name provided the file has the .conf file extension, contains the valid event plugin identifier
[snmp], and resides in the event-plugins directory location.
All configuration files are loaded, so differentiate the file names such as snmp1.conf, snmp2.conf, and so on.
Multiple plugin instances facilitate flexibility when setting up alerts to SNMP targets for development and production clusters.
All OpsCenter event plugins support multiple configurations files and subsequent plugin instances.
Import the OpsCenter MIB (DATASTAX-OPSCALERT-MIB.txt) located in the event-plugins directory into the infrastructure monitoring application of choice, such as a Nagios application. The MIB is a formal specification of the fields within OpsCenter traps. Installing the MIB is mandatory for using the SNMP traps effectively; without doing so, the field titles will not render properly. Refer to the installation and configuration instructions provided by the application vendor.
In a terminal, open snmp.conf for editing.
Enable the SNMP plugin for sending traps.
Optional: The engine ID that uniquely identifies the SNMP engine is commented out by default. By default, if the
engine_idis unset, OpsCenter creates a local engine ID based on the local IP address. If you prefer to manually set the
engine_id, uncomment the
engine_id. Change the last four octets (
01:02:03:04) of the
engine_idstring to a unique octet string for each OpsCenter installation.
[snmp] ... engine_id=80:00:00:00:05:50:60:70:80
target_ip, enter the IPv4 address of the SNMP receiver.
If you do not want to accept the remaining default configuration values, consult the following table for assistance with completing the fields relevant to each of your OpsCenter installations:
Table 1. SNMP configuration fields SNMP configuration options Description
Enables (1) or disables (0) the SNMP plugin instance. Default: 0 (disabled).
Comma-delimited list of event severities for which the SNMP plugin should fire. If not specified, all levels are listened for by default. Available options: DEBUG INFO WARN ERROR CRITICAL ALERT
Comma-delimited list of cluster names for which the plugin should fire. If no cluster is specified, the alert is called for events on all clusters by default.
SNMP engine ID that uniquely identifies the SNMP engine. The last four octets of the ID (01:02:03:04 by default) must be unique between multiple OpsCenter installations. Default: 80:00:00:00:05:01:02:03:04 for the Octets default format scheme. SNMP version is not relevant to this setting. For more details on SNMP management, see RFC3411.
The fifth octet in the
engine_iddetermines the format scheme that specifies the nature of the remaining trailing octets. Available format schemes:
01: IPv4 Address scheme
02: IPv6 Address scheme
03: MAC Address scheme
04: Text Address scheme **
05: Octets scheme (default)
IPv4 address of the SNMP trap target. Default: 127.0.0.1
Only IPv4 is supported at this time.
Listening port on the SNMP manager to receive SNMP traps. Default: 162.
When set to 1, this SNMP plugin instance will use the SNMPv3 configuration options (
privacy_key) with SNMP authentication. When set to 0, this SNMP plugin instance will use the
community_namewith SNMPv1/2c authentication. Default: 0 (uses SNMPv1/2c).
SNMPv1/2c-specific configuration. Community name for authentication with the SNMP trap target. Default:
Username for SNMPv3 authentication. Default:
SNMPv3 authentication hashing algorithm. Specifies the authentication protocol to use with SNMPv3. Available options:
SNMPv3 authentication key. Authentication key as configured for your OpsCenter installation in your monitoring software. Default:
SNMPv3 privacy protocol. Available standards-compliant options:
NoPrivAvailable Extended Security Options (ESO) from the SNMP Research Group:
Privacy key as configured for your OpsCenter install in your monitoring software. Default: