> #### Adding log file rule sets

> A log file rule set is composed of one or more rule definitions. The purpose of a rule set is to help you manage a large number of log file monitors consistently and efficiently by sharing rule definitions. By creating and selecting appropriate log file rule sets to be added to log file resource monitors, you eliminate the requirement to add log file rules on an individual basis to each log file monitor.

> Once a rule set exists, you can access it from the list frame and then associate it with the monitoring plan of a log file monitor. Then, when the monitoring plan is active and the log file monitor is polled, Fathom can evaluate each rule in the set. Keep in mind that a log file monitor's monitoring plan can have one or more rule sets associated with the plan.

> ##### Accessing existing log file rule sets

> The Fathom Library provides access to existing log file rule sets.

> To access existing log file rule sets:

> 1. Select Library from the menu bar. The existing Library objects display in the list frame.
> 2. As necessary, select Type as the Sort by option, and expand the Rule Sets category. These predefined categories display: AppServer, Database, LogFile, NameServer, and WebSpeed. Click LogFile to display a list of all available log file rule sets.
> 3. To display details about a specific rule set in the detail frame, click an individual rule set name in the list frame. Within the detail frame, you can edit the rule set.

> ##### Creating a new log file rule set

> A log file rule set allows you to centrally define rules at the library level and associate rule sets with one or more log file resource monitors.

> Rules within rule sets are composed of three rules-required components: search criterion, severity level, and alert details. Library-based log file rule sets are comprised of rules that have search criteria you define for local search criteria, or select from the search criteria stored in the library.

> To set up library-based log file rule sets:

> 1. Select Library from the menu bar. The Fathom Component Library page displays in the detail frame.
> 2. Click Create Log File Rule Set Monitor. The Create Log File Rule Set Monitor page appears:

> 3. Enter the name of the rule set in the Name field.
> 4. Enter a description of the rule set in the Description field.
> 5. Click Save. The Log File Rule Set Monitor page appears:

> 6. To add a rule to this rule set, click Add Rule. The Create Log File Rule Monitor page appears:

> 7. Choose one of the following options:
> - Use existing search criteria. Select values available from the drop-down list fields on the Create Log File Rule Monitor page. See the "Selecting search criteria to define a local rule" section for the specific steps, complete the steps as defined, and then return to Step 8 in this procedure.
> - Use new search criteria. Continue with Step 8 in this procedure.
> 8. Click Create Criterion. The Create Search Criterion Monitor page, from which you will create a new rule to add to the rule set, appears:

> 9. Enter a value in the Name field. The search name can be a maximum of 32 characters, and it must not contain spaces between words or use special characters such as an asterisk (*), an ampersand (&), or a period ( . ).
> 10. Enter a description in the Description field.
> 11. In the Search Text field, enter the search string you want this rule to look for in the log file. The entry must be consistent with the type of search you are performing.
> 12. In the Search Type field, select either Literal Search or Regular Expression. See the "Specifying search criteria" section for a detailed description of these search types.
> 13. Store this search criterion in a Search Criteria category:
> - Use Existing Category (default value) — From Category, scroll through the list of Fathom predefined categories and select one. The list includes these categories: AppServer Broker, AppServer Server, Database, Miscellaneous, NameServer, WebSpeed Broker, and WebSpeed Server.
> - Use New Category — In the Category field, use the predefined misc category, or enter the name of a new category.
> 14. Click Save. The Create Log File Rule Monitor page reappears, displaying the newly identified search criterion values in the Criteria Category and Search Criteria fields.
> 15. Identify the remaining properties for this rule:
> - In the Severity field, select the level of severity you want to set for this rule.
> - In the On Alert Perform Action field, select the action you want Fathom to perform when an alert triggers.
> 16. Click Save. The Log File Rule Set Monitor page redisplays with this newly created rule displayed in the Rules selected for this Rule Set section.
> 17. As necessary, repeat Step 6 through Step 16 to add additional rules to this rule set.

> Your rule set appears in the list frame under the LogFile category. See the "Associating rule sets with log file monitors" section for details about associating the rule set with a log file monitor.

Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095