SNMP Trapd LAM v2

The v1 trap LAMbot contained both core processing and user changeable data (e.g. loading and routing modules), and presented an upgrade risk due to these functions being combined into a single file. The v2 LAMbot has been significantly simplified to allow changes to be made (e.g. the addition of custom code) without risk, and to allow core processing functionality to be modified as part of a distribution without the complexity of merging old and new LAMbots.

The core LAMbot presend() function has been reduced to the following code, with a clear placeholder for any custom code that needs to be added.

function presend(event) { 

  // ------------------------------------------------------------------------------------
  // Process the trap, and return a processed trapEvent that will be used to populate
  // attribures of the originial source event.
  // ------------------------------------------------------------------------------------

  var trapEvent = trapUtil.processSNMPTrap(event);

  // ------------------------------------------------------------------------------------
  // Discard this event if set within the processing.
  // ------------------------------------------------------------------------------------

  if ( trapEvent.discard ) {
    logger.info("Event marked for discard");
    return false;
  }

  // ------------------------------------------------------------------------------------
  // Validate the trapEvent before despatch
  // Populate the source event with the processed trap data. 
  // If the trap cannot be processed, generate an ingestion errot event. 
  // ------------------------------------------------------------------------------------

  var eventOk = trapUtil.prepareEvent(event,trapEvent);

  if ( !eventOk ) {
    logger.warning("Trap failed validation - generating ingeston alert");
    botUtil.printObj(trapEvent,"failed to validate");
    botUtil.generateIngestEvent(event,"Trap failed to validate");
    return true;
  }

  // ------------------------------------------------------------------------------------
  // If customer specific processing is needed, e.g. adding static lookup, add it here.
  // ------------------------------------------------------------------------------------
  // Custom code start: 
  // ------------------------------------------------------------------------------------
  //
  //
  // ------------------------------------------------------------------------------------
  // Custom code end. 
  // ------------------------------------------------------------------------------------
  //
  // 
  // ------------------------------------------------------------------------------------
  // Check for a stream in the trapEvent and despatch.
  // ------------------------------------------------------------------------------------

  if ( trapEvent.streamName ) {
    return( { passed: true, stream: trapEvent.streamName } );
  }
  else {
    return(true);
  }
}

The only changes that would be expected to be made in this file is the addition of any custom code at the appropriate place.

All supporting processing functionality has been moved to the TrapUtility.js module. Changes to the TrapUtility.js (like the BotUtility.js and other utility modules) are not supported, and this should not need to be modified without prior consultation with the Moogsoft technical team.