Run Recommendation
The Run Recommendation Agent is a vital part of the App Designer Recommendation functionality. It is used to run Recommendation rules against events in your Data Stream, thus Alerts are raised in App Designer for events that match one or more rules.
The Recommendation configuration includes the selection of a Data Stream where it is applied to events. Including this Agent causes the Data Stream to be available for selection in the Recommendation configuration.
Details for an example and its configuration can be found in the How to Use section.
Pre-requisites
The following is required to use this Agent:
An App Designer server accessible using the same Subscription Manager credentials as this Data Stream Designer instance
The minimum XMPro App Designer version required for the classification support (introduced with v3.00) is v4.4.7
The minimum XMPro Stream Host version required for v3.00 is v4.4.2, however v3.03 is backward compatible to Stream Host v4.3.7+.
Current Version
Download the Run Recommendation v3.04
Please contact XMPro if you're looking for an older version of this Agent.
Release Notes
v3.04
20 Jan 2025
Repackaged to translate the Agent's properties. Replaced deprecated System.Data.SqlClient library with Microsoft.Data.SqlClient, to mitigate the risk of security vulnerabilities.
v3.03
30 Jul 2024
Added Rule Id to the output payload.
v3.00
4 Jul 2024
Added classification support, i.e. asset, process, and/or KPIs.
Note the updated pre-requisites.
v2.64
12 Apr 2024
Fixed a rare concurrent access exception when fetching updated rules.
v2.63
21 Jun 2023
Fixed auto-resolve recommendations causing a high load on the database.
v2.60
5 May 2023
Added a warning message to the Entity Identifier property, reminding the user that an unsuitable identifier may result in an excessive number of recommendation alerts.
v2.59
12 Sep 2022
Repackaged to include the Agent's Category
v2.58
4 Jun 2021
Fixed variables (that reference another variable twice or more) being flagged as recursive and throwing an error.
v2.57
3 Jun 2021
Variable parsing detects and throws an exception if a variable references itself, instead of crashing the stream host.
v2.56
28 May 2021
Rules are only fetched on error once per event batch.
v2.55
27 May 2021
Agent responds to new Response Code API response property by updating rule cache if necessary.
Last updated