Monitoring RSS Statistics using WSO2 BAM

WSO2 BAM is a monitoring tool, which performs the task of aggregating, analyzing and presenting information about business activities. Thereby, BAM can be used with SS in order to effectively monitor RSS statistics.

To use BAM with SS for monitoring RSS statistics, you must first configure the SS to publish information to BAM. In BAM, the rss_stat_monitoring_toolbox.tbox tool box should be installed. With this tool box, the BAM dashboard will graphically display the statistics published from Storage Server.

Note that monitoring RSS statistics using the BAM toolbox is only available for MySQL and Postgre type databases.

Follow the instructions given below.

Enabling RSS statistics publisher in SS

Stop Storage Server if it is already started.
To start the RSS statistics publisher, open the rss-monitor-config.xml file in the <SS_HOME>/repository/conf/etc/ directory and set the <monitoringEnable> setting to true (default is false).
Set <bamSecureUrl> and <bamReceiverUrl> as well.
Give the cron expression using <cronExpression> to schedule the publisher.
Provide BAM admin credentials.
Start the Storage Server.

Setting up the BAM tool box

Stop the BAM server if it is already started.

Open the master-datasources.xml in the <BAM_HOME/repository/conf/datasources/ directory and add the WSO2SS_STAT_DATASOURCE data source as shown below. This datasource connects to the default H2 database in BAM. Therefore, the summarized RSS information published to BAM from SS will be stored in this database.

The maser-datasources.xml file, consists of the datasource connection to the default, internal database (H2) that is shipped with every WSO2 product. This database maybe replaced as explained in the Working with Databases section. Thereby, the datasource information in the master-datasources.xml file should be changed accordingly.

<datasource>
           <name>WSO2SS_STAT_DATASOURCE</name>
           <description>The datasource used for ss stat analyzer</description>
           <definition type="RDBMS">
               <configuration>
					<url>jdbc:h2:repository/database/samples/WSO2SS_STAT_DB;AUTO_SERVER=TRUE</url>
                   	<username>wso2carbon</username>
                   	<password>wso2carbon</password>
                   	<driverClassName>org.h2.Driver</driverClassName>
                   	<maxActive>50</maxActive>
                   	<maxWait>60000</maxWait>
                   	<testOnBorrow>true</testOnBorrow>
                   	<validationQuery>SELECT 1</validationQuery>
                   	<validationInterval>30000</validationInterval>
               </configuration>
           </definition>
</datasource>

Start the BAM server to install the toolbox.

Port offset may need to be changed. Open the carbon.xml file from the <BAM_HOME>/repository/conf/ folder and change the <offset>0</offset> to an appropriate value.
Go to the Main menu in the navigator and click Add in the BAM Toolbox menu.
You can now add the RSS statistics monitoring tool box (rss_stat_monitoring_toolbox.tbox), which is stored in the <SS_HOME>/resources/bam-toolboxes folder as a custom toolbox. Use the ToolBox from File System option as shown below.
Click Install. The toolbox will now be added to BAM.

Viewing RSS statistics in BAM

In BAM, go to the Dashboard sub menu under the Main navigator menu.
Log in to the dashboard to view the statistics: