Rules History
The Rules History panel displays all rule alerts triggered by SOTI Connect. The console sorts them in a list showing the most recent rules at the top. All rule alerts are logged and can be filtered based on specific intervals.
If SOTI Connect fails to execute a rule, you can view it as a Rule Alert in the list. You can also filter the list to display by All History or Alerts Only.
Important: As a part of migrating to SOTI Connect 2025.0, the installer archives the entire old Rule
History into a zip package (which has a
*.csv file) during the
update. After archiving, the Rule History is deleted, and a new style Rule
History is collected starting from SOTI Connect 2025.0.
The archive of old Rule History is placed in:
C:\ProgramData\SOTI\Connect\Archive\RuleHistoryThe Rules History view provides the following details:
| Start Date/ Time | Displays the rule's start date and time. |
| End Date/ Time | Displays the rule's end date and time. |
| Duration | Shows the amount of time required to execute the rule. |
| Rule Name | Displays the name of the rule. |
| Rule Type | Indicates the category of the created rule. |
| Rule Executed | Shows whether the rule was executed successfully. |
| Result | Displays the execution status of the rule. This pertains to the execution of actions. For example, if a rule involves two devices and three actions for each device, with one action retried for all devices, it would have a total of eight results. This is calculated as follows: two devices * (three actions + one retry) = eight results. |
| Devices | Indicates the number of devices involved. This shows whether the outcome of the actions for each device met user expectations. This information is provided on a per-device basis, for example, if a rule involves ten devices, it shows ten separate results. |
Understanding Rules History
SOTI Connect organizes results into three levels:
| Level | Description |
|---|---|
| Rule level | Displays information about the rule, including the actions executed and whether SOTI Connect applied the rule to the devices. |
| Action level | Provides information about each action, including how long it took to execute and whether SOTI Connect applied the action to the device. |
| Device level | Provides information about devices. You can filter this by Action Name or Status. |
Note: An action may show as failed (with an error in the Result column),
but the device might still show as successful in the Devices column. This depends on
user expectations. If the user anticipated certain failures and set up the rule to
handle them appropriately, these failures are considered as expected and marked as
successful.
Consider the following scenario:
- The user sets up a Check-in action to perform a device check-in.
- They anticipate that the check-in might fail, so they configure s Retry option.
- If the Retry fails, the Continue action handles the failure.
If both the initial check-in and retry fail, the user considers these failures as expected and the system marks the final result (at both the action and rule levels) as successful for the device.