Debugging Siddhi Applications¶
WSO2 Streaming Integrator Studio allows debugging tasks to be carried out to ensure that the Siddhi applications you create and deploy are validated before they are run on an actual production environment. To debug a Siddhi application, you can run it in the debug mode, apply debug point and then run event simulation so that the specific debug points are analyzed.
To run a Siddhi application in the debug mode, follow the procedure below:
A Siddhi application can be run in the debug mode only in the source view.
- Start the Streaming Integrator Studio following the instructions in Starting Stream Integration Studio.
- You are directed to the welcome-page. In this scenario, let's use
the existing sample Siddhi application named
ReceiveAndCountto demostrate the debugging functionality. To open this Siddhi application, click on the sample.
ReceiveAndCountSiddhi application opens inca new tab.
- In order to debug the Siddhi file, you need to first save it in the
workspacedirectory. To do this, click File => Save . In the Save to Workspace dialog box that appears, click Save .
To run the Siddhi application in the debug mode, click Run => Debug . !!! info This menu option is enabled only when the Siddhi file is saved in the
workspacedirectory as specified in the previous step.
As a result, the following log is printed in the console.
Also, another console tab is opened with debug options as shown below.
Apply debug points for the required queries. To mark a debug point, you need to click on the left of the required line number so that it is marked with a dot as shown in the image below.
You can only mark lines with
insert intostatements as debug points.
Simulate one or more events for the
SweetProductionStreamstream in the Siddhi application. The first line that is marked as a debug point is highlighted as shown below when they are hit.
For detailed instructions to simulate events, see the following sections:
Two viewing options are provided under both Event State and the Query State sections of the Debug tab for each debug point hit as shown above.
To expand the tree and understand the details of the processed attributes and their values etc., click the following icon for the relevant query.
When you observe the details, note that the value for
outputDatain the Event State section is null. This is because the debug point is still at beginning of the query. Also note that the value calculated via the
count()function is still displayed as
0in the Query State section.
The following icons are displayed in the Debug tab of the console:
Icon Description Click this to proceed from the current debug point to the next available debug point. If there is no debug point marked after the current debug point, the existing debug point continues to be displayed in the tab. Click this to proceed from the current debug point even if no debug point exists after it.
Once you navigate to next debug point and see the details by clicking the plus signs as mentioned
above you can further analyze the processed attributes and its values as shown below. Note that
count() aggregate function, a value of 1 has been