Event Rules

Event rules are supposed to process monitoring events. The system checks records in the Monitoring Source table against the event rule. If the records match the rule, the system should start the debounce period. At the end of the debounce period, the system should re-check the Monitoring Event records, whether they match the event rule or not.

To create an event rule, complete the following steps:

  1. Navigate to Monitoring and Event Management → Configuration → Event Rules.
  2. Click New and fill in the fields.
  3. Click Save or Save and Exit to apply the changes.

Event Rule form fields

FieldMandatoryDescription
NameYSpecify a name for the event rule.
DescriptionNType a brief description.
ActiveNSelect this checkbox to enable the rule.
TypeY
  • Information – does not require a response. It is used to check the state of a device or service, and to confirm the successful competion of any operation. 
  • Warning – indicates whether a service or device has reached a threshold.
  • Exception – determines whether the established norm for a metric of a service or system component is violated .
Message countY

Specify the number of the event messages required to execute the current rule. 

The field appears when the Information type is chosen.


Message accumulation periodY

Specify the period during which the number of event messages specified in the Message count field should be accumulated. 

The field appears when the Information type is chosen.


Active event countY

Specify the number of active events in the Monitoring Events table for the rule to work.

The field appears when the Warning type is chosen.


Revalidation periodY

Specify the time period after which the monitoring events should recheck for compliance to the rule.

The field appears when the Warning or Exception type is chosen.


Actions for Event Rule

When the event records are re-checked, and they still match the rule, the system performs all actions that are created for this event rule in the ascending order. 

To create actions, complete the following steps:

  1. Open the event rule record to which you need to create an action.
  2. Navigate to the Related Lists area, click the Action for Event Rule tab.
  3. Click New and fill in the fields.
  4. Click Save or Save and Exit to apply the changes.

Action for Event Rule form fields

FieldMandatoryDescription
NameYSpecify a name of the action.
Event ruleYSpecify the event rule to which the action is created.
Action typeY

Choose the action type:

  • New record creation
  • Record update
  • Client script execution
TableY

Specify the table in which the action should be performed. 

The field appears when the New record creation or Record update action type is chosen.


RecordY

Specify the record which should be updated. 

The field appears when the Record update action type is chosen.


TemplateNSelect a column and define the value you need. Available columns depend on the table specified in the Table field.
Use scriptN

Select the checkbox to display the Script field.

The field appears when the New record creation or Record update action type is chosen.


ScriptN

Insert a script you need to use to create a record or update record values in the source table.

The field appears when the Use script option is chosen or when the Client script execution action type is chosen.

Use executeScript() function with the following parameters available:

  • event – the record in the Monitoring Event (itsm_monitoring_event) table that is created by the monitoring rule with the lowest order.
  • message – the last record in the Target Message table related to the event.
  • record – the record that is specified in the Record field or that is created in the specfied Table. If the Client script execution type is chosen, the record returns null.  
ActiveNSelect this checkbox to enable the action.
OrderNSpecify the action order. Actions are performed in ascending order.

When the actions of the New record creation and Record update types are performed, in the ITSM Task Event (itsm_task_event) table, records that call actions are created. They connect the ITSM Task (itsm_task) record to the Monitoring Event (itsm_monitoring_event) record. If the binding record exists, a new one is not created.

If the record from any ITSM Task child table has related Monitoring Event records, the relevant related list is displayed on its form.