Predict Mediator for WSO2 ESB

Predict Mediator captures data from messages communicate via WSO2 ESB, and passes them to a generated model to carry out predictions.

Predict Mediator configuration

The syntax of the predict mediator configuration is as follows.

<predict>
<model storage-location="string"/>
<percentile value="95.0"/>
<features>
<feature name="string" expression="XPath | JSONPath">+
</features>
<predictionOutput property="string"/>
</predict>

The properties of the above configuration are described below.

<predictionOutput property>

Installing ML features in WSO2 ESB

Follow the steps below to install the ML feature in WSO2 ESB.

1. Download WSO2 ESB version 4.9.x or later.
2. Start the WSO2 ESB server as follows.
   
   1. • on Linux, run <ESB_HOME>/bin/wso2server.sh

      • on MS Windows, run <ESB_HOME>/bin/wso2server.bat

3. Log in to the WSO2 ESB management console using admin/admin credentials, and click Configure.
4.  Click Features, and then click Repository Management.
5. Click Add Repository, and enter the details as shown below to add the P2 repository.
   
6. Click Add.
7. Click Available Features tab, and select the repository added in the previous step.

8. Deselect the Group features by category check box.

9. Click Find Features. It can take a while to list out all the available features in the feature repository. Once listed, select the following features. 

   • Machine Learner Core 
   • Machine Learner Commons 
   • Machine Learner Database Service 
   • Metrics Group
   • Predict Mediator Aggregate

   If you cannot see this feature, retry with one of the following suggestions:

   • Add a more recent P2 repository. The repository you added could be deprecated.
   • Check for the feature in the Installed Features tab.

   

10. Once the features are selected, click  Install  to proceed with the installation. 

11. Click Next, select I accept the terms of the license agreement option, and then click Next.

12. Click Restart Now, and then click Yes in the message which pops up. Wait a few seconds until the sever restarts, and refresh the screen.

Adding a proxy service to WSO2 ESB

 Follow the steps below to create a sample Pass Through Proxy Service to test the Predict mediator.

1. Log in to the WSO2 ESB management console using admin/admin credentials.
2. Click Main, and then click Proxy Service.
3. Click Pass Throgh Proxy.
4. Enter the details as shown below.
   
   • Enter a name for Proxy Service Name (E.g. PredictMediatirTestProxy).
   • Enter  http://localhost:9000/services/SimpleStockQuoteService  for Target URL.

5.   Click  Create . You view the proxy service created as shown below.
   

    

Adding Log, Predict and Drop Mediators to the Sequence

Follow the steps below to add log, predict and drop mediators to the sequence.

1. Log in to the WSO2 ESB management console using admin/admin credentials.
2. Click Main, and then click List in the Services menu.
3. Click the corresponding Design View link of the WSDL based proxy service you added above.
4. Click Next in the Step 1 of 3 - Basic Settings screen to proceed to step 2.
5. In the Step 2 of 3 - In Sequence and Endpoint Options screen, Select Define Inline, and then click the Create link as shown below.
   
6. In the Design in Sequence screen, click the Add Child option which is next to the Root element.
7. Select Core, and then select  Log  from the drop down menu as shown below.
   
8. Enter the following details in the Log Mediator section as shown below.
   

   • Select INFO for Log Category.

   • Select Custom for Log Level.

   • Click Add Property.

   • Enter before-predict-mediator for Property Name.

   • Select Expression from the Property Value drop down list.

   • Enter the following expression for Value/Expression: fn:concat('ML Mediator Prediction : ',get-property('result'))

9. Click Update.

10. Click on the Log element, and then click the Add Sibling option which is next to it.
11. Select Agent and then select Predict from the drop down menu as shown below.
    

12. Enter the path to generated model that you want to use in predictions for Model Storage Location as shown in the example below.

    The model should be downloaded and saved in the registry or any location in your machine. The Model Storage Location parameter specifies the location in which the model is saved.

13. Click Load Model. It loads the features list of the model as shown below.
    
    

    The the model that you are using for predictions is using an algorithm of the Anomaly Detection algorithm type, the Predict mediator is displayed with the Percentile Value as shown in the example below.

     Click to view Predict mediator with Percentile Value

    

14. Enter the following XPath (or JSONPath) expressions in the Expression field for the displayed features list associated with the model, to extract the feature values from the mediating message.

    Feature name	XPath expression
    Age	$body/features/Age
    BMI	$body/features/BMI
    DBP	$body/features/DBP
    DPF	$body/features/DPF
    NumPregnancies	$body/features/NumPregnancies
    PG2	$body/features/PG2
    SI2	$body/features/SI2
    TSFT	$body/features/TSFT

     If you are defining a namespace in the XPATH expression, click the corresponding Namespaces link of the features to add namespaces. Then, in the Namespace Editor, add any number of namespace prefixes and URL that you have used in the expression as shown below.

    

15. In the Prediction Output section, the message context property name (e.g. result), to which the prediction output value needs to be set as shown below.

16. Click Update.
17. Click on the Predict element, and then click the Add Sibling option which is next to it.
18. Select  Core  and then select  Log  from the drop down menu as shown below.
    
    
19. Enter the following details in the Log Mediator section as shown below.
    
    

    • Select INFO for Log Category.

    • Select Custom for Log Level.

    • Click Add Property.

    • Enter after-predict-mediator for Property Name.

    • Select Expression from the Property Value drop down list.

    • Enter the following expression for Value/Expression:  fn:concat('ML Mediator Prediction : ',get-property('result'))

20. Click Update.

21. Click on the Log element, and then click the Add Sibling option which is next to it.
22. Select  Core  and then select  Drop  from the drop down menu as shown below.
    
23. Click Save & Close.

24. Click Next in the Step 2 of 3 - In Sequence and Endpoint Options screen.

25. Click Finish in the Step 3 of 3 0 Out Sequence and Fault Sequence Options screen.

Making predictions using Predict Mediator

Follow the steps below to make predictions using the Predict mediator.

1. Log in to the WSO2 ESB management console using admin/admin credentials.
2. Click Main, and then click List in the Services menu.
3. Click the corresponding Try this service link of the proxy service (i.e. PredictMediatorTestProxy) you added as shown below.
   

4. Enter the following XML message as the Request as shown below.

   <features xmlns:ns="http://ws.apache.org/axis2">
       <NumPregnancies>1</NumPregnancies>
       <TSFT>30</TSFT>
       <DPF>0.529</DPF>
       <BMI>34.6</BMI>
       <DBP>70</DBP>
       <PG2>115</PG2>
       <Age>32</Age>
       <SI2>96</SI2>
   </features>

   
   You view the output of the Log mediators in the CLI in which you ran WSO2 ESB server as shown below.