Show/Hide Toolbars

MonitorWare Agent

There are some events which occur often and you do not want them to be stored in your log files or either take any action on those.

 

We handle these events on top of our rule set. This ensures that only minimal processing time is needed and they are discarded as soon as possible.

 

In this tutorial, we define a filter that discards such events. In our example, we assume that Events with the ID 105, 108 and 118 are not required. Please note that for simplicity reasons we only apply filter based on the event ID. In a production environment, you might want to add some additional properties to the filter set.

In this sample, no service or rule set is yet defined. It is just a "plain" system right after install, as can be seen in the following screen shot:

 

tutorials_001

Ignoring Events - Figure 1

 

We begin by defining a rule set. Right-click on "RuleSets" and choose "Add RuleSet" from the context menu. Type in a name of your choice. In this tutorial, we use the name "Defaults". Click on "Next". Leave all as it is in the next dialog. Click "Next", then "Finish". As can be seen in following screen shot, the rule set "Defaults" has been created but is still empty.

 

tutorials_002

Ignoring Events - Figure 2

 

Of course we can only use a rule if we configure a corresponding service. To do so, right-click on "Running Services" and then select "Add Services". Choose the desired "Service" from the context menu i.e. "Event Log Monitor" in this sample. Provide a name of your choice. In our sample, we call the service "Event Log Monitor". Leave all defaults and click "Next", then "Finish". Now click on "Event Log Monitor" under "Running Services". Your screen should look as follows:

 

tutorials_003

Ignoring Events - Figure 3

 

As we had created the "Defaults" rule set initially, it is shown as the rule set to use for this service. For our purposes, that is correct. To learn more on the power of rule set assignments, see other sections of this manual.

 

Now we do something with the data that is generated by the event log monitor. To do so, we must define rules inside the rule set.

 

In the tree view, right-click "Defaults" below "RuleSets". Then, click "Rules", select "Add Rule". Choose any name you like. In our example, we call this rule "Discard". Then, expand the tree view until it looks like the following screen shot:

 

tutorials_004

Ignoring Events - Figure 4

 

Click on "Filter Conditions" to see this dialog:

 

tutorials_005

Ignoring Events - Figure 5

 

In that dialog, we define our filter. Remember: we are about to filter those events, which we are not interested in. As we would like to discard multiple events, we need the Boolean "OR" operator in the top-level node, not the default "AND". Thus, we need to change the Boolean operator.

 

There are different ways to do this. Either double-click the "AND" to cycle through the supported operations or select it and click "Change Operator". In any way, the Boolean operation should be changed to "OR".

 

We filter out "uninteresting" events via their event id. Again, there are different ways to do this. In the sample, we do it via right clicking the "OR" node and selecting "Add Filter" from the pop up menu. Or you can use the Add Filter Button. This can be seen in the screen shot below:

 

tutorials_006

Ignoring Events - Figure 6

 

I prefer to add all three Event ID property filters first and later on change the Event ID to the actual value I am looking for. When you have added them, it should look as follows:

 

tutorials_007

Ignoring Events - Figure 7

 

In order to enter the actual values, select each of the three filters. A small dialog opens at the bottom of the screen. There you enter the values you are interested in. In our sample, these are IDs 105, 108 and 118. As we are only interested in exactly these values, we do a comparison for equality, not one of the other supported comparison modes. When you have made the updates, you screen should look as follows:

 

tutorials_008

Ignoring Events - Figure 8

 

Save the settings by clicking the (diskette-like) "Save" button. We have now selected all events that we would like to be discarded. In reality, these are often far more or a more complicated filter is needed. We have kept it simple so that the basic concept is easy to understand – but it can be as complex as your needs are.

 

Now let us go ahead and actually discard these events. This is done via an action. To do so, right-click on "Actions" and select "Discard."

 

tutorials_009

Ignoring Events - Figure 9

 

Again, name the action as you like in the following dialog. We use "Discard" as this is quite descriptive. Select "Next" and then "Finish" on the next page. Your screen should like follows:

 

tutorials_010

Ignoring Events - Figure 10

 

This concludes the definition of our first rule.

 

If we would start MonitorWare Agent service now, all events with IDs 105, 108 and 118 would be handled by this rule and thus be discarded. All other events do not cause the filter condition to evaluate to true and thus those would be left untouched. Consequently, only these other events flow down to rules defined behind the "Discard" rule. Obviously, our configuration effort is not yet completed. We just finished a first step, excluding those events that we are not interested in. And of course, in reality you need to decide which ones to discard in a real rule set.