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.


An App Designer server accessible using the same Subscription Manager credentials as this Data Stream Designer instance is required to use this Agent.

Current Version

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

Release Notes

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,05 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, 04 Jun 2021

  • Fixed variables (that reference another variable twice or more) being flagged as recursive and throwing an error.

v2.57, 03 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