Skip to main content

Create a Workflow Engine Moolet

Implementers and administrators can use the Workflow Engine to add custom logic for event, alert, and Situation processing in Moogsoft Enterprise.

A Moolet is an intelligence module that performs specific services in Moogsoft Enterprise.

You can define a workflow in a Workflow Engine (WFE) Moolet to perform tasks on events, alerts, and Situations.

If the existing WFE Moolets do not perform the service that you need, you can create a new WFE Moolet.

Before you create a new WFE Moolet, consider where the new Moolet:

  • Fits into your workflow.

  • Receives data from and sends data to, and what the data types are.

WFE Moolet types

There are three types of WFE Moolet:

  • Event WFE Moolets process event data after that data is ingested by an integration or LAM and before it is processed by the Alert Builder.

  • Alert WFE Moolets process alert data after the Maintenance Window Manager and before that data passes to a clustering algorithm.

  • Situation WFE Moolets process Situation data after the Teams Manager finishes processing those Situations.

You create a new Moolet by creating a Moolet configuration file in $MOOGSOFT_HOME/config/moolets/.

WFE Moolet configuration file examples

For a full description of WFE Moolet configuration file properties, see the WFE Moolet Reference.

Event WFE Moolet

name               : “CustomEventMoolet”,
classname          : “com.moogsoft.farmd.moolet.workflowengine.CWorkflowEngine”,
run_on_startup:	   : true,
metric_path_moolet : true,
moobot             : “WorkflowEngine.js”,
event_handlers	   : “event”,
message_type 	   : “event” 

Alert WFE Moolet

name               : “CustomAlertMoolet”,
classname          : “com.moogsoft.farmd.moolet.workflowengine.CWorkflowEngine”,
run_on_startup:	   : true,
metric_path_moolet : true,
moobot             : “WorkflowEngine.js”,
process_output_of  : “MaintenanceWindowManager”,
message_type 	   : “alert” 

Situation WFE Moolet

name               : “CustomSituationMoolet”,
classname          : “com.moogsoft.farmd.moolet.workflowengine.CWorkflowEngine”,
run_on_startup:	   : true,
metric_path_moolet : true,
moobot             : “WorkflowEngine.js”,
process_output_of  : “SituationMgr”,
message_type 	   : “situation” 

Activate the new Moolet

Once you have created the Moolet configuration file:

  1. Add the new Moolet to the Moogfarmd configuration file at $MOOGSOFT_HOME/config/moog_farmd.conf. For example:

        moolets : [
              ...
              {
                include : "alert_builder.conf"
              },
              ...
              {
                include : "teams_manager.conf"
              },
              {
                include : "NEW_WFE_MOOLET_NAME.conf"
              }
            ]
  2. Restart the Moogfarmd instance to activate the new Moolet. See Control Moogsoft Cloud Processes for more information.