Adding event subscriptions

Add event subscriptions to expand the types of SNMP notifications that you want to test.

Before you begin

The SNMP Settings must be configured, and you must have an SNMP log target.

About this task

In addition to trapping events that are generated, you can trap events that occur from normal operations. Review your system log for events that you want to trap. Configure SNMP notifications with message IDs that are in the system log.

Procedure

  1. View the system logs and identify messages that represent events that you want to trap (see IBM MQ error logs).
  2. For each message, copy the value of the msgid and associated error message to a text file.
  3. In the IBM MQ Appliance web UI, click the Administration icon shows the administration icon and select Access > SNMP Settings.
  4. Click the Trap Event Subscriptions tab.
  5. In the Minimum Priority field, select debug for the maximum output while testing.
  6. Add event subscriptions.
    1. In the Event Subscriptions field, enter a message ID that you copied from the system log.
    2. Click Add.
    3. Optionally, click Help to see the description, level, and suggestion for the message that you added. Confirm that the help text describes the same event that is in your system log.
  7. If required, repeat the previous step to add other messages to trap.
  8. Click Apply to save the changes to the running configuration.

Results

SNMP notifications are sent for the events that match the event subscriptions.

What to do next

Review the available event codes and look for the events that you have a requirement to monitor. The SNMP settings configuration has a predefined default list of event to trap. You can force errors to test some events, such as configuring an NTP server with a host name that cannot be reached on the network.

If the appliance does not correctly generate SNMP notifications, use a packet capture to troubleshoot.