Try OpenEdge Now
skip to main content
Resource Monitoring
Monitoring File Resources : Creating a log file monitor : Creating search criteria
 

Creating search criteria

You create the search criteria phrases to be accessed by and shared among several log file monitors from the OpenEdge Management library. These search criteria phrases, along with the severity level and alert detail you define, are the rule properties you use to create log file resource monitor rules and rule sets.
You can use the search criteria that you create and store at the library level in multiple log file monitors simultaneously. You can also share search criteria by exporting it from or importing it to other machines. For details about importing and exporting search criteria, see Exporting and Importing in OpenEdge Management.
Within your work environment, it is important for you to know when a database is unexpectedly down. Perhaps the effectiveness of your company's operations have suffered lately due to unplanned database down time. Obtaining information from the log file about these events can help you better research the issue.
To help you assess what might be happening, you can set up a literal search for the words database down. Once you enable the search against the log file, OpenEdge Management checks the file for an occurrence of the phrase, based on your polling cycle, and reports on its findings.
You must provide values for the Search Type and the Search Text fields on the Create Search Criterion page. The Search Type is a drop-down list. Depending on the type of expression you enter in the Search Type field, select either the literal search string or Perl 5 regular expression option. In the Search Text field, you enter the specific value for the type of expression you selected.
Another example of a literal text string you might search for in a log file is abnormal shutdown. A search based on this value yields a match only if the exact expression abnormal shutdown is found in the file. In contrast, a Perl 5 regular expression search supports a variety of notations that you can use for pattern matching, potentially yielding broader search results.
Note: The Search Text field does not impose any length limits on your entry. For practical reasons, however, you might want to limit the length. Also, keep in mind that the Search Text field is case-sensitive.
To create a search criterion:
1. In the OpenEdge Management console menu, choose one:
*Select Library > New > Search Criteria.
*Select Library > Go to Library > Create Search Criteria
The Create new Search Criterion page appears.
2. In the Criterion Properties section, 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.
3. Enter a description in the Description field.
4. In the Search Text field, enter the search string you want the log file resource monitor to look for in the log file.
The entry must be consistent with the type of search you are performing.
5. In the Search Type field, select either Literal Search or Regular Expression.
See Specifyingsearch criteria for a detailed description of these search types.
6. Store this search criterion in a Search Criteria category by choosing either:
*Use Existing Category — From Category, scroll through the list of OpenEdge Management predefined categories and select one.
*Use New Category — In the field, use the predefined misc category, or enter the name of a new category.
7. Click Save.
The search criterion is now available. You can display it from the category to which you assigned it.
8. Repeat these steps for each additional criterion you want to create.
* Using Perl 5 expressions to create search criteria
* Selecting search criteria to define a local rule