You can configure event routing rules to filter events based on one or more of the searchable fields. You can associate each event routing rule with one or more of the configured actions. You can also assign tags to group the events logically.
Following sections provide information about configuring event routing rules.
You can create a filter-based event routing rule and then assign one or more configured actions that are executed to handle or output the events that meet the event routing rule criteria.
To create an event routing rule:
From Administration Console, click Routing in the toolbar.
Click Create, then use the following information to create a new event routing rule:
Name: Specify a unique name for the event routing rule.
Criteria: Select a saved criteria to use in creating event routing rule. This criteria determines which events are stored in the event store.
Select tag: (Optional) Select a tag for tagging the filter. The tag makes the filter more specific.
Route to the following services: Select where the information is routed. The options are:
All: Routes the event to all services including Correlation, Security Intelligence, and Anomaly Detection.
Event store only: Routes the event to the event store only.
None (drop): Drops or ignores the events.
Perform the following actions: Select an action to be performed on every event that meets the filter criteria. The following default actions are available for event routing rules:
Log to File
Log to Syslog
Send Events via Sentinel Link
Send SNMP Trap
NOTE:When you associate an action with routing rules, ensure that you write rules that match a small percentage of events, if the rule triggers a Javascript action. If the rules trigger actions frequently, the system might backlog the actions framework. This can slow down the EPS and might affect the performance of the Change Guardian server.
For the actions to work, you must have configured the Integrator associated with each action for your environment.
Select the email configuration that you already created using Policy Editor. For more information see Section 9.0, Configuring Email Notifications.
The actions listed here are different than the actions displayed in the Event Actions tab in the Administration Console, and are distinguished by the <EventRouting> attribute in the package.xml file created by the developer.
Adding or Removing Actions You can add more than one action to perform on the events that meet the filter criteria:
Click Save to save the event routing rule.
The newly created event routing rule appears at the end of the rules list under the Event Routing Rules tab. By default, this new event routing rule is active.
When there is more than one event routing rule, the event routing rules can be reordered by dragging them to a new location. Events are evaluated by event routing rules in the specified order until a match is made, so you should order the event routing rules accordingly. More narrowly defined event routing rules and more important event routing rules should be placed at the beginning of the list.
The first routing rule that matches the event based on the filter is processed. For example, if an event passes the filter for two routing rules, only the first rule is applied. The default routing rule cannot be reordered. It always appears at the end.
To order event routing rules:
From Administration Console, click Routing in the toolbar.
The Event Routing Rules tab is displayed.
Existing event routing rules appear on the page.
Mouse over the icon to the left of the event routing rule numbering to enable drag-and-drop. The cursor changes.
Drag the event routing rule to the correct place in the ordered list.
When the event routing rules are ordered, a success message is displayed.
New event routing rules are activated by default. If you deactivate an event routing rule, incoming events are no longer evaluated according to that event routing rule. If there are already events in the queue for one or more actions, it might take some time to clear the queue after the event routing rule is deactivated. If the On check box next to the event routing rule is selected, the event routing rule is activated. If the On check box is not selected, the event routing rule is deactivated.
From Administration Console, click Routing in the toolbar.
The Event Routing Rules tab is displayed.
Existing event routing rules appear on the page.
To activate the event routing rule, select the check box next to each event routing rule in the Enabled column.
If the event routing rule is activated, a success message is displayed.
To deactivate the event routing rule, select the check box next to each event routing rule in the Enabled column.
When the event routing rule is deactivated, a success message is displayed.