Words and Phrases
Configuring Options in Database Policies
The options tab enables you to configure several policy behaviors, for example which events are logged locally, how the policy handles unmatched events, and defaults for pattern matching in policy rules.
To access
-
In the Operations Connector user interface, click
in the toolbar. Then click Event > 
Database. -
In the Operations Connector user interface, click
in the toolbar. Then click Metric > Database.
Alternatively, double-click an existing policy to edit it.
Click Options to open the policy Options page.
Tasks
How to configure options for database file policies
In the Options page, configure which events or metrics are logged locally, how the policy handles unmatched events, and defaults for pattern matching in policy rules.
Related tasks
UI Descriptions
|
Description |
|||
|---|---|---|---|
| Log Local Events |
Defines which incoming events are logged. These events are logged on the Operations Connector system in the log file: Windows: Linux: |
||
| that match a rule and trigger an event | Logs any events in the event source that match the policy rules. | ||
| that match a rule and are ignored | Logs any events in the event source that are suppressed. (Suppressed events are not sent to OMi.) | ||
| that do not match any rule | Logs any events that do not match any of the rules in the policy. | ||
| Unmatched Events |
Send an event to OMi when the input event does not match any rule in the policy because none of the conditions apply or because the policy does not contain any rules. This ensures that unexpected events that might be important do not go unreported. By default, unmatched events are ignored. Each policy that sends unmatched events to OMi creates an event with the default values of the policy. If you want a policy to send events only with the default values, omit all rules from the policy.
If several event policies forward unmatched events to OMi, you could receive multiple events about a single input event. |
||
| are forwarded to OMi Server | Sends unmatched events to OMi. | ||
| are forwarded to OMi Server with state 'closed' | Sets the unmatched event's lifecycle status to Closed before sending it to OMi. | ||
| are ignored | Ignores unmatched events. | ||
| Store records that do not match any rule | Operations Connector stores events that do not match any rule and sends them to OMi. | ||
| Pattern Matching Options | Defines case sensitivity and field separators for all rules. | ||
| Case sensitive check | Defines whether the case (uppercase or lowercase) of a text string is considered when the pattern of a rule is compared with the source data. When switched on, a match only occurs if the use of uppercase and lowercase letters is exactly the same in both the source data and the pattern. This is the default setting. | ||
| Field Separators |
Defines which characters should be considered to be field separators. Field separators are used in the pattern as separator characters for the rule condition. You can define up to seven separators, including these special characters:
For example, if you wanted a backslash, an asterisk, and the letter A to define the fields in the event, you would type \\*A (with no spaces separating the characters). If you leave this box empty, the default separators (a blank and the tab character) are used by default. You can set case sensitivity and separator characters for individual rules in a policy by clicking the |
||
| Apply to All |
Applies the pattern matching options to all existing rules in a policy. This overwrites any modifications made to the pattern matching options in individual rules. If you change the pattern matching options and do not click Apply to all, they only apply to all new rules in a policy. |
button in rule's match condition.
|
Description |
|||
|---|---|---|---|
| Log incoming Metric data |
Defines which incoming metric records are logged. These metric records are logged on the Operations Connector system in the log file: Windows: Linux: |
||
| that match a rule and are stored | Logs any metric record in the log file that match the policy rules. | ||
| that match a rule and are ignored | Logs any metric records that are suppressed. | ||
| that do not match a rule and are ignored | Logs any metric records that do not match any of the rules in the policy. | ||
| Unmatched records |
Stores metric records in OMiwhen the input metric record does not match any rule in the policy because none of the conditions apply or because the policy does not contain any rules. This ensures that unexpected records that might be important do not go unreported. By default, unmatched records are ignored. Each policy that sends unmatched records to OMi creates a metric with the default values of the policy. If you want a policy to store metrics only with the default values, omit all rules from the policy. If several metric policies store unmatched records to OMi, you could receive multiple records about a single input metric. |
||
| are forwarded to OMi Server | Sends unmatched events to OMi. | ||
| are forwarded to OMi Server with state 'closed' | Sets the unmatched event's lifecycle status to Closed before sending it to OMi. | ||
| are ignored | Ignores unmatched events. | ||
| Store records that do not match any rule | Operations Connector stores metrics that do not match any rule. | ||
| Pattern Matching Options | Defines case sensitivity and field separators for all rules. | ||
| Case sensitive check | Defines whether the case (uppercase or lowercase) of a text string is considered when the pattern of a rule is compared with the source data. When switched on, a match only occurs if the use of uppercase and lowercase letters is exactly the same in both the source data and the pattern. This is the default setting. | ||
| Field Separators |
Defines which characters should be considered to be field separators. Field separators are used in the pattern as separator characters for the rule condition. You can define up to seven separators, including these special characters:
For example, if you wanted a backslash, an asterisk, and the letter A to define the fields in the metric record, you would type \\*A (with no spaces separating the characters). If you leave this box empty, the default separators (a blank and the tab character) are used by default. You can set case sensitivity and separator characters for individual rules in a policy by clicking the |
||
| Apply to All |
Applies the pattern matching options to all existing rules in a policy. This overwrites any modifications made to the pattern matching options in individual rules. If you change the pattern matching options and do not click Apply to all, they only apply to all new rules in a policy. |