BAM Service Data Agent is used to collect statistics related to service data from WSO2 service-hosting products (such as WSO2 Application Server (AS), WSO2 Data Services Server (DSS), WSO2 ESB, WSO2 Business Process Server (BPS), WSO2 Business Rules Server (BRS)) 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 the service-publishing products and BAM server. BAM Service Data Agent can be configured early so that the statistics to be extracted from service data of the service-publishing product 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 services. The user should define the Event Stream related parameters uniquely identified by a name and a version.
...
- on Linux wso2server.sh
- on MS Windows wso2server.bat
4. 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".
5. 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."
...
7. Restart the WSO2 AS server. (Go to "Shutdown/restart" sub menu of the "Main" menu in the management console).
Configuring Service Data Agent
| Anchor | ||||
|---|---|---|---|---|
|
...
Stream Definition Configuration:
- Strea m Na me: 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 . If the service statistics toolbox is installed, the version should be different to 1.0.0 since the default toolbox uses version 1.0.0 for the stream definition to enable service statistics only.
- 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.
...
4. BAM Data Agent will send the message from the service hosting product 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 using the management console. (Main -> Cassandra Explorer -> List Keyspaces)
What does Service Statistics Tell?
BAM service statistics data agent extracts the statistics information about the request came for a Axis2 service in WSO2 server, and publishes the statistics information to BAM. In service statistics each request will publish the event to BAM along with it's statistical data. With default configuration of BAM service statistics data agent the following measures are published. As mentioned above, BAM service statistics agent will send event for every request. Therefore the the below event meta, payload data of service statistics belongs to per service request.
| Event Property Name | Type | Description |
|---|---|---|
meta_content_type | Meta Data | Content type of the incoming request for the axis2 service deployed in WSO2 server (Eg: WSO2 AS) |
meta_host | Meta Data | Host name of the service hosting server (Eg: WSO2 AS) |
meta_referer | Meta Data | It's the HTTP header field that indicates from which the request came to the axis2 service deployed in the WSO2 server (Eg: WSO2 AS) |
meta_remote_address | Meta Data | The remote address of the axis2 service deployed WSO2 server (Eg: WSO2 AS) |
meta_request_url | Meta Data | Service Endpoint of the axis2 service, for which the request came. |
meta_user_agent | Meta Data | It is a HTTP header field which represents the software program used by the original client. (Eg: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:11.0) Gecko/20100101 Firefox/11.0) |
payload_fault_count | Payload Data | If the message has been encountered any fault when serving the request, then this will be incremented as 1. If request successfully served, this count will be 0. |
payload_operation_name | Payload Data | The operation name for which the request has been made to, in the axis2 service. |
payload_request_count | Payload Data | The request count will be incremented to 1, if the request has been reached the WSO2 service hosting server. (Eg: WSO2 AS) |
payload_response_count | Payload Data | The response count will be incremented by 1, if the refer axis2 service request is successfully served without any error and returned the response to the client. Else it will remain 0. |
| payload_response_time | Payload Data | The time taken for the axis2 service to serve the request and send back a response. |
| payload_service_name | Payload Data | The service name for which the request came in. |
| payload_timestamp | Payload Data | The time of when the request came into WSO2 service hosting server (WSO2 AS), not the time which the event was received by BAM server. |
...