Note that the Analytics Dashboard is:
- Not supported with IBM JDK.
- Supports only Google Chrome and Firefox browsers.
Not supported with reverse proxy.
A reverse proxy server retrieves information from a server and sends it to a client as though the information originated from the reverse proxy server rather than the actual server.
Analytics dashboard application is the data visualization component of WSO2 Data Analytics Server. You can create dashboards and real time gadgets event streams. A gadget displays the real-time information processed by WSO2 DAS in a selected format. A dashboard serves as a container for a collection of gadgets organized in a selected layout. The following diagram summarizes how to set up the Analytics Dashboard for WSO2 DAS as per your requirement.
Instructions to set up a dashboard are covered in the following steps.
The following table specifies the prerequisites for viewing information in a gadget depending on the service provider selected for it.
|Batch Data Source|
A persisted event stream should exist in order to populate the gadget with persisted data.
|Relational Database Source|
|Realtime Data Source|
|REST Data Source||An accessible REST endpoint should exist.|
Step 1: Log into the Analytics Dashboard
Follow the procedure below to log into the Analytics Dashboard.
- Access the WSO2 DAS Analytics Dashboard using the following URL.
- Enter your username and password, and click Login.
You can deploy a dashboard and/or its components (e.g. layouts, gadgets, and widgets) in the Analytics Dashboard of WSO2 DAS by bundling them as artifacts of a Carbon Application (cApp). For instructions on deploying cApps in WSO2 DAS, see Packaging Artifacts as a C-App Archive.
Step 2: Create required gadgets
Follow the procedure below to create a gadget to display information processed by WSO2 DAS as required.
- In the Anaytics Dashboard, click the menu icon and then click Gadgets to open the Gadgets page as demonstrated below
- Click GENERATE GADGET to open the Generate a Gadget wizard.
- Enter information as follows to configure a gadget.
In the Select Provider field, select the relevant service provider based on the source from which data should be taken to update the gadget. The source of each provider type is given in the table below. Then click Next. In this example, Batch Data Source is selected to publish data updated in an event table.
Provider Source of Data Published in Gadget Batch Data Source
An event table in DAS that contains persisted data from an event stream.
For more information about events streams and event data, see Understanding Event Streams and Event Tables.
Relational Database Source A datasource that can connect to an RDBMS database. Realtime Data Source
Real-time events received in event streams.
Here, the events are directly obtained from the backend. In order to do this, a UI event publisher should be defined and connected to the event stream that receives the events.
REST Data Source A REST endpoint
- In the Event Table field, select the event stream from which the events to be published are derived. Then click Next. In this example, a table named
Configure a chart as follows.
Parameter Name Description Example Gadget Name The text to be displayed as the name of the gadget.
USAGE - CITIES
Select Chart Type The type of chart that you want the gadget to display.
X-Axis Select the attribute for the X axis of the bar chart. metro_area Y-Axis Select the attribute for the Y axis of the bar chart.
Color domain The points mapped on the line chart will be differentiated using colour based on the value of the attribute selected for this parameter.
Max length The maximum length of the chart in terms of the number of records displayed at a given time.
Click Preview to see the preview of the gadget in the lower section of the page.
- Click Add to Store to save the gadget configuration, and then click Go to Portal. the Dashboards page appears again.
- Once a gadget is created and saved, its configuration is saved in JSON format in the
- For more detailed information about creating and customising gadgets, see WSO2 Dashboard Server Documentation - Gadget Author Guide.
Step 3: Create a new dashboard
- If you wish to create a dashboard based on a custom theme, see Adding a Custom Theme for a Dashboard.
- When a dashboard is created, only the user who created the dashboard has permission to edit, view and delete it. For information about how to allow other users to edit, view and deleted a dashboard, see Managing Access to Dashboards.
Follow the procedure below to add a new dashboard to the Analytics Dashboard.
- Log into the Analytics Dashboard if you are not already logged in. For detailed instructions, see Logging into the Analytics Dashboard. If there are any existing dashboards, they are displayed as shown in the example below.
- Click CREATE DASHBOARD in the top navigator to open the CREATE A DASHBOARD page.
- Enter information as follows.
Enter a name and a description for the dashboard. In this example, the name and the description is entered as follows.
Parameter Value Name of your Dashboard
Indicates the average power usage for different cities.
Select a layout based on how you want the gadgets to be organized on your dashboard. In this example, the Single Column layout is selected. A message appears to indicate that the dashboard is successfully created.
Click the icon for gadgets. Drag and drop a gadget displayed into the required column of your dashboard. In this example, the Usage - Cities gadget that was created in Step 2: Create required gadgets is added to the dashboard.
Once information is entered as described above, the Dashboard saved successfully message appears. The new dashboard can be viewed in the Dashboards page.
- Once a dashboard is created and saved, its configuration is saved in JSON format in the registry. This can be accessed via the
/_system/config/ues/dashboards/<Dashboard_Name>registry path. For more information about the registry, see Registry.
- For more detailed information about creating and customising dashboards, see WSO2 Dashboard Server Documentation - Editor Guide.
Step 4: View information
Follow the procedure below to view information in a dashboard in the WSO2 DAS Analytics Dashboard.
- Access the WSO2 DAS Analytics Dashboard using the following URL., and log in using your credentials.
- Click View on the required dashboard. In this example, the dashboard created in Step 3: Create a new dashboard is selected.
Simulate some data for the event stream connected to your gadget.
In this example, data is simulated for the gadget created by building the
<DAS_HOME>/samples/smart-home/resources/access.logfile. For more information, see Analyzing Smart Home Data.
The gadget is updated as shown in the following image of the
USAGE - CITIESgadget created in this example.