Filtering trace information

You can search the decisions database by filtering on such criteria as the ruleset path, decision ID, ruleset parameters, or execution dates.

Before you begin

To be able to search the BOM by specifying input or output parameters as filter values as explained in 4, you must first select BOM format with an optional filter ruleset monitoring option in the Ruleset View. See Setting ruleset monitoring options for details.

About this task

Trace data is the sum of the execution details stored in the Decision Warehouse database. In the Search Decisions window, you can define filters on the data source so that trace information is displayed only for the events or decisions in which you are interested.

Procedure

To filter trace information:

Sign in to the Rule Execution Server console using the resMonitor or the resAdmin role.
In the Rule Execution Server console, click the Decision Warehouse tab.
Click Search Decisions.
The Search Decisions page is displayed.
Filter the trace data source as follows:
Executed ruleset path

Use this field to search for executions of a particular ruleset by specifying its ruleset path. The syntax is any ruleset path format (with or without version numbers). For example:

/CreditRuleApp/1.0/CreditRules/1.0

You can enter the prefix of the ruleset path to filter the results displayed in the table.

Decision ID

Use this field to search for a particular execution ID, referred to as a Decision ID in the output. For example:

50a3601b-20fa-4f78-abf7-6935f6d4516c

Scroll through the list of decisions to locate a Decision ID or enter the prefix of the ID to filter the results displayed in the table.

Rules Fired and Tasks Executed

Use this field to search for executions of all the rulesets that contain the name of a rule that was executed or of a task that was executed.

You can enter more than one rule or task, separated by a comma with no space. If you do so, the search process finds all the decisions that contain any of the rules or tasks (OR operator).

For example: miniloan

You can identify rules and tasks in traces by clicking View Decision details in the Decision table and expanding Ruleflow Tasks.

Input parameters
Use this field to search for the value that you specify in the ruleset input parameters.

To search the BOM, you must enclose the filter value in the element that matches its type. For example, if you want to filter on a name, enclose the name in a string element.
```
<name>
<string>Joe</string>
</name>
```
Note:
Blank spaces are recognized in the search.
Output parameters
Use this field to search for the value that you specify in the output parameters of all executed rulesets.

To search the BOM, you must enclose the filter value in the element that matches its type. For example, if you want to filter on a quantity, enclose the figure in an int element.
```
<amount>
<int>500000</int>
</amount>
```
Note:
Blank spaces are recognized in the search.
From date, From time, To date, To time

Use these fields to find the decisions calculated between the specified dates and times (bounds included).
Click Search to execute the filter that you have just specified.
Click Clear to remove the filters.