|Purpose||This listener should be enabled if you want to analyze statistics for specific sessions in WSO2 IS Analytics. A session is a time duration between a successful login and and the subsequent log out by a specific user. For more informations about this type of Analytics, see Analyzing Statistics for Sessions.|
The required configuration details described below are available by default. Follow this section to understand the Analytics related configurations used in the process and do any modifications if required.
Setting up the DAS configuration involves Configuring event publishers involve providing the information required by WSO2 IS to publish login and/or session data to the Analytics - IS server in order to analyze the data using the Analytics Dashboard. This configuration is the same for login analytics and session analytics. The differences are as follows.
- configuration required for login analytics is located in the
- file. The
<?xml version="1.0" encoding="UTF-8"?> <eventPublisher name="AuthenticationDataPublisher" statistics="disable" trace="disable" xmlns="http://wso2.org/carbon/eventpublisher"> <from streamName="authentication-analytics-stream" version="1.0.0"/> <mapping customMapping="disable" type="wso2event"/> <to eventAdapterType="wso2event"> <property name="username">admin</property> <property name="protocol">thrift</property> <property name="publishingMode">non-blocking</property> <property name="publishTimeout">0</property> <property name="receiverURL">tcp://localhost:7612</property> <property encrypted="false" name="password">admin</property> </to> </eventPublisher>
The properties of this event publisher configuration are explained in the table below.
- configuration required for session analytics is located in the
- The event streams used for login analytics and session analytics are different because the format in which the events are captured for the two types of analytics are different. For detailed information about event streams, see Understanding Event Streams and Event Tables.
The event streams specified for publishers should not be modified because that would cause errors in the existing default configuration.
The common properties that can be configured for event publishers in the files mentioned above are as follows.
Configuration file property
The URL of the target receiver to which IS related information is sent as events. The format of the URL is as follows.
The URL of the authenticator. The format of the authenticator URL is as follows.
|User Name||The username of the listener.|
|Password||A password for the listener.|
|Protocol||The communication protocol that is used to publish events.|
|Publishing Mode||The events publishing mode. Non-blocking refers to asynchronous publishing, and blocking refers to synchronous publishing.|
|Publishing Timeout||A positive integer to denote the timeout for the non-blocking publishing mode.|