Page Comparison

BAM Mediation Data Agent is used to collect statistics related to mediation data from the WSO2 ESB and send to the WSO2 BAM server. BAM server receives data events via its Thrift API. This protocol uses a binary protocol and enables fast data transmission between ESB and BAM server. BAM Mediation Data Agent can be configured early so that the statistics to be extracted from mediation data of ESB can be pre-defined. In the configuration panel the user can specify the BAM server (Thrift server) related information and Properties to be extracted from the Configuration Context of ESB. The user should define the Event Stream related parameters uniquely identified by a name and a version.

In this section you can see about,

1. Installing BAM Mediation BAM Mediation Data Agent Feature

2. What does Mediation Statistics Tells?

Installing BAM Mediation Data Agent Feature

Anchor
Installing BAM Mediation data agent Installing BAM Mediation data agent

The following installation instructions apply to WSO2 ESB version 4.5.x.

...

• on Linux wso2server.sh
• on MS Windows wso2server.bat

4. After starting the server, go to ESB management console. Instructions are similar to those in section Running the Product.

5. In the management console, select "Configure -> Features" and click the "Repository Management" tab. Then select a P2 repository either from a URL or a file. For instructions, refer to section Managing the Feature Repository.

For example,



Then click Add.

6. Go to "Available Features" tab and select the repository added above. The, click on "Find Features" button. From the list of features that appears, select "BAM Service Data Agent Aggregate" feature and click "Install."

...

Stream Definition Configuration:

• Stream Name : Stream Name can be any string with alpha-numeric characters
• Version : Stream Version distinguishes different streams with the same Stream Name. Default version should be 1.0.0 .
• Nick Name : This is a user preferred nick name to the Stream Name in alpha-numeric characters
• Description : A description describing about the particular stream defined by Stream Name, Stream Version pair. Description should also consists of alpha-numeric characters.

BAM Credentials:

• BAM URL : Enter the IP address of the BAM server. And the port should be the thrift port ( ex: tcp://127.0.0.1:7611 ). You can add a comma-separated list of server URLs to ensure that load is distributed among many servers and to minimize effects of a failure of one server node. This load balancing feature is an enhancement of the BAM 2.0.1 release onwards.
• Username: Put the BAM Thrift log-in user name. Default value is admin.
• Password: Put the BAM Thrift log-in password. Default value is admin.

...

Once done, the BAM Mediation Data Agent in the Simple_Stock_Quote_Service_Proxy service should have dumped statistics from the ESB to the column family with the given "Stream Name" in key-space, "EVENT_KS" in the Cassandra database. Data in the Cassandra database can be seen from the Cassandra Explorer in the BAM server as follow:

What does Mediation Statistics Tells?

Anchor
what does mediation stats tells what does mediation stats tells

BAM mediation statistics metrics are same as the metrics used by General ESB mediation statistics component. Mediation statistics are widely-used monitoring features. From functional components of the ESB, sequences, proxy services and endpoints directly get involved in processing messages. The BAM Mediation Statistics feature enables a server administrator/Tenant administrator to collect runtime statistical information on these three types of functional components and view them through via interactive BAM Dashboard. This feature provides a simple but effective way of determining the runtime performance of the ESB. The collected statistical data can be used to analyze network traffic patterns and draw rough estimates on how the service bus will be used in the future. Perhaps the most enticing attribute of the mediation statistics feature is that it can be configured in a fine grained manner. In other words, it allows a user to collect data on only a specified set of sequences, proxy services and endpoints.

...