The "Mediation Statistics Toolbox" is a default, out-of-the-box toolbox provided by WSO2 BAM for point-and-click installation. It includes the necessary artifacts (hive scripts, data stream definitions, properties files, gadgets etc.) required to collect and monitor activity related to services deployed in any WSO2 service-hosting product like the WSO2 Enterprise Service Bus, WSO2 Application Server, WSO2 Data Services Server etc.
Explained below is a complete, example use case of how to extract and summarize service statistics of the WSO2 Application Server using this toolbox. The following sections are covered:
- Mediation Statistics Toolbox#Prerequisites Prerequisites of the UsecaseMediation Statistics
- Toolbox#Installing Installing the Toolbox
- Executing the Analytics Scripts
- Mediation Displaying Statistics Toolbox#Displaying Statistics on Dashboard
Prerequisites of the Usecase
| Anchor | ||||
|---|---|---|---|---|
|
1. Download and start the WSO2 BAM server and log in to its management console. Instructions are given in section Getting Started.
2. Set up the "BAM Mediation Statistics Data Agent". For instructions on setting it up to transfer service data to WSO2 BAM, refer to section Setting Up Mediation Stats Data Agent.
| Info | ||
|---|---|---|
| ||
Activity monitoring toolbox comes with this sample is using embedded H2 database to persist summarized data, also out of the box it only works for default bam installation. Therefore if you changed the default settings(port offset and h2 database), you have to change hive script accordingly. eg:- If BAM server offset=1, you should update the script as, "cassandra.port" = "9161" |
Installing the Toolbox
| Anchor | ||||
|---|---|---|---|---|
|
1. Log in to BAM's management console and select "BAM Toolbox -> Add" in the "Main" menu.
2. The "Add Tool Box" page appears. Select the "Mediation Stats Monitoring Toolbox" and click "Install" button. With this simple step, all required artifacts will be deployed to BAM.
3. The "Available BAM Tool Boxes" page opens with the installation status as "Installing". Wait a few seconds and refresh the page to see the status changed to "Installed".
Executing the Analytics Scripts
| Anchor | ||||
|---|---|---|---|---|
|
...
2. You should be able to see visualized data of a particular service deployed in the WSO2 ESB. For example,
...
| title | Note |
|---|
If you are installing more than one toolbox ( e.g. : Installing both activity monitoring toolbox and mediation stats toolbox together ) you need to configure the dashboard.xml to activate all dashboards. Uncomment the corresponding node(s) which represent your installed toolboxe(s).
<bamdashboards>
<!-- uncomment below node to activate mediation stats monitoring dashboard -->
<dashboard isPrimary="true">
<name>mediation_stats_monitoring</name>
</dashboard>
<!-- uncomment below node to activate service stats monitoring dashboard -->
<!--<dashboard isPrimary="false">
<name>service_stats_monitoring</name>
</dashboard>-->
<!-- uncomment below node to activate activity monitoring dashboard-->
<!--<dashboard isPrimary="false">
<name>activity_monitoring</name>
</dashboard>-->
...