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

Please contact XMPro if you're looking for an older version of this Agent.

Release Notes

VersionDateDescription

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