Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 AS in order to effectively monitor the statistics of web applications in AS.

...

To start BAM and to setup databases to store for statistics data:

  1. Start BAM. For more information, see Starting the server.
  2. If you need to change databases which the database that stores statistic data:, do the following; 
    1. Create a database.
    2. Configure the database in  {BAM_HOME}/repository/conf/datasources/master-datasources.xml  as  WSO2BAM_DATASOURCE .

Step 3: Configure the Application Server (AS)

To configure the AS for publishing statistics in BAM:

  1. Log into the AS management console. 

    Info

    Webapp data publishing settings need to be configured separately for the tenants.

  2. On the Configure tab, click Webapp Data Publishing.

  3. Select the Enable webapp stats option.
     
  4. Leave the Stream Name, Version, Nick Name, Description as it is.
    If you need to change the latter fields, you will have to make some more changes in the tool box and hive script. 
  5. Enter the Receiver URL.
    This refers to the Thrift URL. This is normally tcp://{host}:7611. If you need to use SSL for this the URL will be tcps://{host}:7711. If you change the offset of the BAM server to 1, both ports will be incremented by 1 (7612, 7712)
  6. Enter the Cassandra Username. 
  7. Enter the Cassandra Password.
  8. Click Update to successfully configure the AS for Data publishing to BAM.

...

Use either one of the following approaches to configure the web application before deploying any . These steps ensures that each web application , to make AS ready to publish the data to in AS is individually configured for data publishing in BAM.

  1. Enabling Enable monitoring via the UI
  2. Enabling Enable monitoring via the web.xml
Info

The UI has the precedence over web.xml configurations. As a result, if you disable web apps statics monitoring from the UI configurations in the web.xml will not work.

...

Enable monitoring via the UI
  1. On the Main tab, under the Applications menu, click List.
  2. Click the Context link of the respective web application.
    The selected application dashboard will appear. 
     
  3. Click Activate, to enable BAM statistics.

...

Enable monitoring via the web.xml

Add the following context params to the application web.xml

...

  1. Access the BAM management console.
  2. On the Main menu, under  Analytics, click List.
    The webapp statistics will be displayed.
  3. Execute the webapp statistics or schedule its running sequence.

...