Live Monitor (formerly known as EPiTrace) can be used as-is, directly from the installation with EPiServer CMS, please note though it is possible to change some of the default settings if required. In this document the various configuration options are described in more detail. Live Monitor is installed on the system through the (msi) installation file and deployed to a site through Deployment Center.
Please note if your solution is set up in a load balancing environment see the the Interval based updates section for some helpful information. Although the module has been renamed many parts of the application (files and configuration) still refer to its previous name EPiTrace.
It is possible to override default client behavior by changing init parameters on the client control (these changes should be made in the EPiTrace.aspx file). These are:
Live Monitor consists of a Silverlight web browser plug-in for visualization of visitor movements on the web site and services providing the silverlight application with visitor information.
Run epitraceHits.sql in your EPiServer database. This will create the table epitraceHits and the stored procedures epitraceRegisterVisit and epitraceMaintenance.
The stored procedure epitraceMaintenance needs to be set-up to run at least every 24 hours. The stored procedure removes information about old visits rebuilds indexes on the epitraceHits table.
To make Live Monitor register visits on your web site you have to add tracking functionality to the pages of the web site. Live Monitor includes a page extension which is responsible for adding the page tracking script to each page.
To change the behavior of the tracking script this page extension can be disabled through plug-in manager in EPiServer CMS admin mode and the tracking web control can be added manually to individual pages types or in the master page of the site.
In order to manually configure the tracking scripts add the following control declaration to the top of the master page:
<%@ Register TagPrefix="epitrace"
Then add the tracker control right before the </form> tag of the page:
Live Monitor should now be set up and you can test it by browsing to visiting the /epiui/EPiTrace/EPiTrace/">http://<yoursite>/epiui/EPiTrace/EPiTrace/, where you should see the Live Monitor silverlight application. Then open another browser and start browsing the web site. The page visits should now be visible in the silverlight application.
Live Monitor can be set up to handle client updates in two different ways. The default set-up pushes visitor updates to the listening Live Monitor silverlight clients as soon as a visit is recorded by the visitor handler. This set-up requires that the visitor logging handler resides in the same web application as the visitor service, since these updates are done with direct communication between the logging handler and the visitor service.
The second set-up pushes updates at a configurable interval to the clients. When a visitor views a page the visit is recorded to database by the visitor logging handler, but the visitor service isn’t notified. The visitor service is instead set-up to load visits from the database at a configurable interval and push to the listening Live Monitor clients. This set-up doesn’t require that the visitor service and the logging handler reside in the same web application.
interval based visitor updates must be configured in web.config. This requires that a configuration section is registered in web.config.
Then the actual configuration must be added as well:
<episerver.epiTrace usePolling="true" pollingInterval="5" />
Further information on the configuration properties:
usePolling - turns on the interval based updates
pollingInterval - determines the number of seconds between client updates