Sending SNMP Traps

SNMP traps report the status of processes to network monitoring solutions.

Sending a Trap with a Chain Definition

This example shows how to send an SMNP trap from a Chain Definition.

  1. Navigate to Definitions > Chains.
  2. Click .
  3. Select the leftmost Chain icon in the diagram and enter JC_SendTrap in the Name field.
  4. Select the name of Step 1 in the diagram and enter Retrieve System Info in the Name field.
  5. Select the Step and choose System_Info in the Process Definition field.
  6. Add a second Step after the first and name it Send Trap On Error.
  7. Select the Step and choose System_SNMP_SendTrap in the Process Definition field.

  8. With the Step still selected, expand Parameter Mappings on the right and enter the following values into the fields.

    Field Value
    Host

    The host for your network monitoring tool. For example: snmp.example.com
    Port The port for your network monitoring tool. For example: 162
    Community PUBLIC
    ID =jobId
    Data ='The chain process '+jobId+' failed, upper-most chain ID is:'+topLevelJobId
  9. Add a status handler after the first Step, then choose Go to > Go to Send Trap on Error for statuses Canceled, Error, and Killed.
  10. For the same status handler, choose Go to > Go to end of chain > Mark chain Completed for status Completed.
  11. Click Save & Close.

To test this Chain definition, do this:

  1. Submit the Chain Definition JC_SendTrap.
  2. On the Times and Dates screen, click Once, and set the Start field to five minutes in the future.
  3. Click Submit.
  4. Right-click the Chain Definition and choose Monitor Related Processes from the context menu.
  5. Fully expand the Chain Definition.
  6. Cancel the Generate an overview of the system Chain Process.
  7. Wait for the Chain to finish executing.
  8. Use your network monitoring solution to inspect the trap.