Configuring Identity Analytics¶
Using the WSO2 Identity Server Analytics distribution, you can view and analyze statistics related to authentication requests that go through the WSO2 Identity Server. For more information, see Analytics.
A taxi company called "Pickup" has launched a new application to be used by their customers. The Pickup developers wish to measure the performance of the authentication mechanism used for users to log into the application so that they can improve the user login experience.
To do this, the developers need to view authentication statistics about the login attempts to the application. This tutorial demonstrates how the Pickup developers can setup WSO2 IS Analytics to view login attempts to the Pickup application.
deployment.toml file found in the
<IS_HOME>/repository/conf folder and add the following event listeners to enable analytics in WSO2 Identity Server.
``` toml [[event_listener]] id = "authn_data_publisher_proxy" type = "org.wso2.carbon.identity.core.handler.AbstractIdentityMessageHandler" name = "org.wso2.carbon.identity.data.publisher.application.authentication.AuthnDataPublisherProxy" order = 11 ``` ``` toml [identity_mgt.analytics_login_data_publisher] enable=true ``` ```toml [identity_mgt.analytics_session_data_publisher] enable=true ```
The rest of the configurations required to connect the analytics distribution with the WSO2 IS distribution have already been pre-configured for fresh distributions. To see more information about these pre-configurations, see Prerequisites to Publish Statistics.
If you do not need to change the default values, proceed to start the servers.
Start the servers¶
<IS_HOME>/bindirectory via a command prompt and start the WSO2 IS server by executing one of the following commands.
WSO2 IS Analytics has two nodes. Navigate to
<ISANALYTICS_HOME>/bindirectory and execute the following commands via a command prompt to start each node.
Start the worker node. The worker node listens to the authentication statistics from WSO2 Identity Server and then analyzes and monitors them.
Start the dashboard node. The dashboard node displays the processed information using the dashboard interface.
Try it out¶
Let's create some basic authentication statistics. To do this, log in to the WSO2 IS dashboard. This login attempt will be published to WSO2 IS Analytics and you will be able to view the login attempt using the WSO2 IS Analytics dashboard.
Log in to the WSO2 Identity Server User Portal using admin/admin credentials.
Next, access the WSO2 Identity Server Analytics Dashboard at the following URL:
http://<HTTPS_IS_ANALYTICS_HOST>: 9643 /portal
Log in using admin/admin credentials.
Click IS Analytics.
Note that there is 1 successful login attempt published on the dashboard.
You have succesfully enabled WSO2 IS Analytics and published statistics to the dashboard. For more information on what you can do with IS analytics, see Analytics.Top