...
Ensure that you have the following in your environment,
JDK 1.6.* or 1.7
Note NOTE: If you install JDK in Program Files in the Windows environment, avoid the space by using PROGRA~1 when specifying environment variables for JAVA_HOME and PATH. Else, the server throws an exception.
- Cygwin (http://www.cygwin.com) : Required only if you use Windows. WSO2 BAM analytics framework depends on Apache Hadoop, which requires Cygwin in order to run on Windows. Install at least the basic net (OpenSSH,tcp_wrapper packages) and security related Cygwin packages. After Cygwin installation, update the PATH variable with
C:\/cygwin\/bin
and restart BAM.
Configuring WSO2 API Manager
...
- Download WSO2 BAM 2.3.0 or later from location: http://wso2.com/products/business-activity-monitor.
Change port offset of BAM to 1 by editing the file
<BAM_HOME>/repository/conf/carbon.xml
file (search for the offset node).Code Block language html/xml <!-- Ports offset. This entry will set the value of the ports defined below to the define value + Offset. e.g. Offset=2 and HTTPS port=9443 will set the effective HTTPS port to 9445 --> <Offset>1</Offset>
This increments all ports used by the server by 1, which means the BAM server will run on port 9444. Port offset is used to increment the default port by a given value. It avoids possible port conflicts when multiple WSO2 products are run in same host.
- Copy the file
<APIM_HOME>/statistics/API_Manager_Analytics.tbox
to directory,<BAM_HOME>/repository/deployment/server/bam-toolbox
. If you use Oracle DB to store statistical data, copyAPI_Manager_Analytics_Oracle.tbox
instead.
If this folder is not in the BAM installation home by default, create it and copy the file.The API Manager Analytic Toolbox
A toolbox is an installable archive, with a .tbox extension. It contains necessary artifacts that models a complete usecase, from collecting data, analyzing through defined Hive scripts to summarizing data through gadgets, Jaggery scripts and other dashboard components.
Configure a database toNote The sample API_Manager_Analytics toolbox works fine when the BAM port offset is set to 1 as we did in the previous step. But, if you set a different offset to BAM, you must change the am_stats_analyzer script of the toolbox as follows:
- Go to BAM Management Console
- Select Analytics > List menu
- Click Edit on am_stats_analyzer_330
- Change the
cassandra.port
value to9161+ <BAM offset>
- Configure a database to which BAM can write analyzed information to. This information is retrieved by the API Publisher before displaying on the corresponding statistical dashboards.
Specify the data source definition in
<BAM_HOME>/repository/conf/datasources/master-datasources.xml
file as follows.
WSO2AM_STATS_DB
is the datasource used to fetch analytical data. This example uses an H2 database. If you want to use a different database, see Changing the statistics database. Note: The JNDI config names given in the config below must match the ones defined earlier in APIM.
Code Block language html/xml <datasource> <name>WSO2AM_STATS_DB</name> <description>The datasource used for getting statistics to API Manager</description> <jndiConfig> <name>jdbc/WSO2AM_STATS_DB</name> </jndiConfig> <definition type="RDBMS"> <configuration> <!-- JDBC URL to query the database --> <url>jdbc:h2:<BAM_HOME>/repository/database/APIMGTSTATS_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>
Because you changed the default BAM port in step 2 above, you must change the Cassandra port given in JDBC connection url in the following datasource configuration found in master-datasources.xml file. Since the port offset is 1, the Cassandra port must be 9161must be 9161. For a list of default ports used by WSO2 products, see Default Ports of WSO2 Products.
Code Block language html/xml <datasource> <name>WSO2BAM_CASSANDRA_DATASOURCE</name> <description>The datasource used for Cassandra data</description> <definition type="RDBMS"> <configuration> <url>jdbc:cassandra://localhost:9161/EVENT_KS</url> <username>admin</username> <password>admin</password> </configuration> </definition> </datasource>
Note If you
run the Hive scripts before changing the default Cassandra port according to the BAM port offset, you keep getting an exception. To overcome thischange the default BAM port (with a port offset), you must change the Cassandra port accordingly, before running the Hive scripts. If not, you get an unable to connect to server Cassandra exception. To overcome this, change the default Cassandra port with the offset value (default port+offset) in
<BAM_HOME>/repository/conf/datasources/master- datasources.xml
file, add the following line at the beginning of the Hive script and rerun.drop table <hive_cassandra_table_name>;
Restart BAM server by running
<BAM_HOME>/bin/wso2server.[sh/bat]
.If you want to host the BAM server on a different machine or change the running port, you must edit the
<APIUsageTracking>
node in<APIM_HOME>/repository/conf/api-manager.xml
file as follows:Code Block language html/xml <!--API usage tracker configuration used by the BAM data publisher in API gateway.--> <APIUsageTracking> <!-- Enable/Disable the API usage tracker.--> <Enabled>true</Enabled> <!-- API Usage Data Publisher.--> <PublisherClass>org.wso2.carbon.apimgt.usage.publisher.APIMgtUsageDataBridgeDataPublisher</PublisherClass> <!--Thrift port of the remote BAM server.--> <ThriftPort>7612</ThriftPort> <!-- Server URL of the remote BAM server used to collect statistics. Must be specified in protocol://hostname:port/ format.--> <BAMServerURL>tcp://localhost:7612</BAMServerURL> <!--Administrator username to login to the remote BAM server.--> <BAMUsername>admin</BAMUsername> <!--Administrator password to login to the remote BAM server.--> <BAMPassword>admin</BAMPassword> <!--JNDI name of the data source to be used for getting BAM statistics.This data source should be defined in the master datasources.xml file in conf/datasources directory.--> <DataSourceName>jdbc/WSO2AM_STATS_DB</DataSourceName> </APIUsageTracking>
...
- Log in to BAM management console and select Add in Analytics menu.
- Go to the Script Editor in the window that opens.
Execute the following script.
Code Block drop table APIRequestData; drop table APIRequestSummaryData; drop table APIVersionUsageSummaryData; drop table APIVersionUsageSummaryData; drop table APIResponseData; drop table APIResponseSummaryData; drop table APIRequestData; drop table APIRequestSummaryData; drop table APIVersionUsageSummaryData; drop table APIResponseData; drop table APIResponseSummaryData; drop table APIResourcePathUsageSummaryData; drop table APIFaultSummaryData;
After configuring WSO2 BAM to render and produce statistics of APIs hosted and managed in the API Manager, you can view them through various statistical dashboards in the API Publisher, depending on your permission levels. For information, refer to section Viewing API Statistics .