Edit this page

Telerik Analytics Integration

When you are creating an application for a broad audience, integrating some kind of analytics framework is crucial, because you will need to analyze the usage data of the application and its features and most probably you will need to know about any application crashes or other errors occurred during the execution. With Q3 2013 release Telerik UI for WPF provides integrated support for Telerik Analytics. Using Analytics you will be able to trace certain features of the controls and get statistics about their usage.

In order to use the service you should contact sales@telerik.com and they will help you get your product key. For more information, please check out the Introduction to Telerik Analytics topic.

How to Add Support to Existing Applications

First, you will need to reference the EQATEC.Analytics.Monitor.dll and Telerik.Windows.Analytics.dll in your application. Note that these dlls are distributed together with the other assemblies in the Telerik UI for WPF suite.

Then, in order to configure the project to support Analytics, please add the code from Example 2 in the constructor of the App class.

Example 2: Configuring a project to support Analytics

public App()
{           
     var analyticsMonitor = Telerik.Windows.Analytics.TraceMonitor.Initialize(this, [product_key]);
}

where [product_key] should be replaced with the product key you got after registering your application on https://platform.telerik.com/

How Analytics Works

This section demonstrates how Analytics works with Telerik controls. Let’s, for example, create a test application registered as AnalyticsTestApp in the Telerik Platform. Add a few controls that support Analytics to it.

Example 3: Add controls

<StackPanel Orientation="Horizontal"> 
    <telerik:RadComboBox Width="200"> 
        <telerik:RadComboBoxItem Content="Silverlight" /> 
        <telerik:RadComboBoxItem Content="WPF" /> 
        <telerik:RadComboBoxItem Content="ASP.NET AJAX" /> 
        <telerik:RadComboBoxItem Content="WinForms" /> 
    </telerik:RadComboBox> 
    <telerik:RadButton Content="Select" Click="Select_Click" /> 
</StackPanel> 

All that is needed is to set the telerik:Analytics.Name attached property to the used in Example 3 RadComboBox and RadButton. Note that the set values will be used in the dashboard.

Example 4 shows how the updated code looks like.

Example 4: Set Analytics.Name property

<StackPanel Orientation="Horizontal"> 
    <telerik:RadComboBox Width="200" telerik:Analytics.Name="ComboBoxSelection"> 
        <telerik:RadComboBoxItem Content="Silverlight" /> 
        <telerik:RadComboBoxItem Content="WPF" /> 
        <telerik:RadComboBoxItem Content="ASP.NET AJAX" /> 
        <telerik:RadComboBoxItem Content="WinForms" /> 
    </telerik:RadComboBox> 
    <telerik:RadButton telerik:Analytics.Name="SelectButton" Content="Select" Click="Select_Click" /> 
</StackPanel>

To trace the features, please follow the next steps:
  • Run the project with the provided code

  • Select an item from the ComboBox and click the Button

  • Close the application.

  • Go to the Analytics Project Dashboard

  • Select the Live link:

eqatec dashboard 1

The next screen will list the live usage sessions:
eqatec dashboard 2

Clicking on the Session link will show additional details about the session including the exact features used:
eqatec dashboard 3

eqatec dashboard 3 1

If you go to the Feature Use link in the Dashboard panel, you will find information and statistics for the registered features for different periods of time:
eqatec dashboard 4

Traceable Features in Telerik UI for WPF

Currently only few controls support analytics out of the box. Note that only user interactions will be tracked - initial values and values from Bindings are not supported.

You can find below a list of the controls and their features that support tracing:

Feature Feature Name
RadBusyIndicator
Show ShowIndicator
RadComboBox
SelectionChanged SelectionChanged
DropDownOpened DropDownOpened
DropDownClosed DropDownClosed
RadContextMenu
Open Opened
Close Closed
Click Click
RadDropDownButton
DropDownOpened DropDownOpened
DropDownClosed DropDownClosed
RadExpander
Expanded Expanded
Collapsed Collapsed
RadGridView
Sort Sorted
Group Grouped
Filter Filtered
RadMenu
Click Click
RadRadioButton
Checked Checked
UnChecked UnChecked
RadRichTextBox
Open Document Open Document
Save Document Save Document
Print Print
RadSpreadsheet
Open Document Open Document
Save Document Save Document
Load Image LoadImage
Save Image SaveImage
RadToggleButton
Checked Checked
UnChecked UnChecked
RadTreeListView
Sort Sorted
Group Grouped
Filter Filtered