This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Using the Analytics Dashboard

EI-Analytics Dashboard is used to publish information relating to the message mediation in WSO2 ESB. The statistics are published in the analytics dashboard in an overview as well as for individual artifacts that are deployed within WSO2 EI. 

In this tutorial, you use the EI-Analytics dashboard to view and analyze the Service Chaining tutorial mediation statistics.

Before you begin,

  1. Install Oracle Java SE Development Kit (JDK) version 1.8.* and set the JAVA_HOME environment variable.
  2. Download the WSO2 EI ZIP file from here, and then extract the ZIP file.  
    The path to this folder will be referred to as <EI_HOME> through out this tutorial.
  3. Select and download the relevant EI tooling ZIP file based on your operating system from here and then extract the ZIP file.
    The path to this folder will be referred to as <EI_TOOLING> through out this tutorial.
  4. Open the ESB Tooling environment and click File -> Import. Then, select Existing WSO2 Projects into workspace under the WSO2 category, click Next and upload the extracted pre-packaged C-App project. This C-App contains the configurations of the service chaining tutorial. On the Servers tab, right-click the WSO2 ESB server, select Add and Remove and choose SampleServicesCompositeApplication, and click Finish.

    If you do not have a server added in Eclipse, refer  this tutorial .

    You can also deploy the artifacts to the ESB server using a  Composite Application Archive (CAR) file.

  5. If you are running on Windows, download the snappy-java_1.1.1.7.jar from here and copy the JAR file to <EI_HOME>\wso2\analytics\lib  directory.

Let's get started!

Setting up Analytics 

  1. Set the following properties in the  <EI-HOME>/conf/synapse.properties  file to true so that the ESB can publish mediation statistics:

     

    ...
    mediation.flow.statistics.enable=true
    mediation.flow.statistics.tracer.collect.payloads=true
    mediation.flow.statistics.tracer.collect.properties=true
    ...
    mediation.flow.statistics.collect.all=true
  2. Start the Analytics runtime by going to <EI_HOME>/wso2/analytics/bin and using the command line terminal and executing one of the following commands:
    • On Linux/Mac OS:  sh wso2server.sh
    • On Windows:  wso2server.bat --run

  3. Start the Integration runtime from within ESB Tooling as described in here OR by navigating to  <EI_HOME>/bin and using the command line terminal and executing one of the following commands: 

    • On Linux/Mac OS:  sh integrator.sh

    • On Windows:  integrator.bat --run

      Ensure you have successfully started the Analytics server prior to starting the ESB server.

Analyzing the mediation statistics

  1. In a new browser window or tab, open  https://localhost:9444/carbon/  and log into the Analytics management console using admin for both the username and password.
  2. On the Main tab, click Analytics Dashboard and log in using admin for both the username and password. You will then see the following:

  3. Click View to open the EI-Analytics Dashboard. The OVERVIEW page is displayed by default. 

  4. To view statistics for the REST API, click API on the left navigator and search for HealthcareAPI . For more information on analyzing statistics displayed on this page, see Analyzing Statistics for REST APIs.

  5. To view statistics for an endpoint, click ENDPOINT on the left navigator and search for the required endpoint. You can view statistics for the following endpoints on this page:
    • GrandOaksEP
    • PineValleyEP
    • ClemencyEP
    • ChannelingFeeEP
    • SettlePaymentEP
     For more information on analyzing statistics displayed on this page, see Analyzing Statistics for Endpoints.

    You have now explored how to use EI-Analytics dashboard.