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, OpenEdge Management 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 OpenEdge Management 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. The following 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 the individual rule set name in the list frame. You can edit the rule set in the detail frame.
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, or you can 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 OpenEdge Management Component Library page displays in the detail frame.
  2. Click Create Log File Rule Set. The Create Log File Rule Set 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 page appears:
  6. To add a rule to this rule set, click Add Rule. The Create Log File Rule page appears:
  7. Choose one of the following options:
  8. Click Create Criterion. The Create Search Criterion 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 OpenEdge Management 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 page reappears, displaying the newly identified search criterion values in the Choose Criteria Category and Choose 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.
    • Select the Always throw new alert option to generate an alert each time the rule is violated.
    • In the On Alert Perform Action field, select the action you want OpenEdge Management to perform when an alert triggers.
  16. Click Save. The Log File Rule Set page redisplays with the 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 © 2006 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095