Create and edit text-based incoming status rules

This topic describes to create and edit text-based incoming status rules. This topic also describes the properties and conditions of text-based incoming status rules.

About this task

To create or edit a text-based incoming status rule, complete the following steps:

1. From the Edit Template tab in the Service Editor, click the Incoming Status Rule button.

   The Select Incoming Status Rule Type window opens.

   Or, to edit an existing rule, click the name of the rule you want to edit.

2. Select Based on Text Value in the Select Rule Type window and click OK.
3. The Edit Incoming Status Rule window opens.
4. Enter the rule properties and conditions using Table 1 as your guide.

   Table 1. Edit Incoming Status Rule window: text-based rule

   Window element	Description
   Rule Name field	The name of the rule.
   Data Feed list	The data feed that contains incoming events or other data used by TBSM when processing the rule.
   Preview Data button	You can display events that match the conditions specified in this window by clicking the Preview Data button. When you click this button, an event table is displayed in a new browser window. This table has the same format as the event table shown in the Service Details portlet. For SQL data sources, you can preview the selected data in the Data Fetcher View Data window by clicking the View Data button.
   Event Discriminators list	If you are using an ObjectServer data feed, you can select one or more ObjectServer classes from this list. You use event discriminators to specify which event types are relevant to the metric rule.
   Instance name list.	You can select an event field from this list. TBSM uses the value of this field to determine the affected service instance when processing this rule. Alternatively, you can use the Advanced button as described below to specify an instance expression.
   Advanced button	As an alternative to specifying an instance name field as described above, you can click this button to specify an instance expression. The instance expression allows you to specify multiple field names, to manipulate values, or both in the field using statements and functions in the TBSM expression syntax.

5. Choose from available filter fields and specify the matching conditions.

   The Available Filter Fields list in this section of the window contains the fields in the incoming events (or other data provided by the data feed).

   You can choose any number of fields from this list. The lists and text fields below allow you to specify the condition that each field must match in order for TBSM to process this event using the rule.

6. Enter the rule output expression in the text field below. The expression can be either the name of a field or a statement in the TBSM expression syntax. You can use the field list to select fields defined in the data feed. The expression will be evaluated as a string value to assign to the rule a text output.
7. (Optional) If you want the text-based rule to also set the general state of the affected service instance, select Status and enter threshold values for the two service states in the Marginal and Bad fields. If the value of the expression contains the text string configured in the Bad status box then the service will be Bad. If the value of the expression contains the text string configured in the Marginal status box then the service will be Marginal.
8. Click OK.