How-To Setup Northbound SNMP Trap Delivery

Use Case

Setting up the delivery of SONARPLEX events as northbound SNMP Traps for integration into 3rd party software like alert consoles or other monitoring tools. 

Example Setup

The instructions are based on the following example setup. Only events of type NOTIFICATION and no SOFT state events should be sent.

SONARPLEX Sender

This is the device that should send events northbound to the Trap Receiver.

LocationCologne
IP-Address172.16.0.100

Primary SNMP Trap Receiver

IP-Address172.16.10.254
SNMP UDP Port

162

SNMP CommunityHow-ToSNMPTraps

Secondary Trap Receiver

The backup receiver.

IP-Address192.168.100.254
SNMP UDP Port

8000

Step-by-step guide

Enable the SNMP trap delivery on the Sender.

  1. Open the in the administrative Web Interface (http://172.16.10.254:81) and choose Configuration :: Status Delivery Configuration for Distributed Monitoring
  2. Configure the settings like shown below.
ParameterSetting
Deliver following events as Traps

Service Notifications

Host Notifications

Admin Notifications

Acknowledgements

Suppress SOFT state alerts

Trap Destinations(s)172.16.10.254:161, 192.168.100.254:8000
Trap Community StringHow-ToSNMPTraps
Debug LevelWARN

Test the delivery

  1. Open the user web interface (http://172.16.0.100) and choose Monitoring :: Services and choose any service

  2. Choose Send custom service notification (notifications are disabled for the service if this link is not visible)
  3. Fill the form with some example comment and send the custom test notification by clicking Commit
  4. A trap is now sent and should be seen in the trap receiver software

Get the Azeti TRAP MIB

Ideally import the AZETI-TRAP-MIB into the receiving software if you require OID translation.

The MIB file can be downloaded in the administrative web interface of the sending SONARPLEX device, choose System :: MIBs and click on AZETI-TRAP-MIB.txt to download it.

Troubleshooting

Check the following list for troubleshooting possible delivery problems.

  • correct ip address, port and SNMP community string for destination
  • trap receiver is reachable via SNMP from the SONARPLEX, no blocking firewalls in between
  • set debug level to DEBUG and check the logfile Global Event Handler [global-event-handler.log], see Admin GUI :: Status :: Logs for errors
The following macros are not currently supported in the footer:
  • style