Page History

...

• Configuration Prerequisites

  • Configuring the CardioLog Analytics Tracking Agent on the CardioLog Application Server

  • Configuring the CardioLog Analytics Tracking Agent on a Dedicated Tracking Server in the DMZ

  • Configuring the CardioLog Analytics Tracking Agent on Azure App Service

• Running the Configuration Wizard
• Configuring the CardioLog Analytics Tracking Code
• Deploy the CardioLog Tracking Code Through a SharePoint Solution

  • Deploying the Tracking Code to all Selected Site Collections Automatically

  • Add the Tracking Code to a Site Collection Manually

• Manually Add the JavaScript Tracking Code to Your Master Pages
• Un-Installing Uninstalling the CardioLog Analytics Tracking Agent Feature
• Configuring the SharePoint Online Site Tree Structure
• Configuring Multiple Site Collections
• Configuring Multiple SharePoint Online Environments
• Updating the CardioLog Tracking Code on Multiple Site Collections

Anchor
prerequisites prerequisites

Configuration Prerequisites 

CardioLog Analytics allows you to easily integrate with Microsoft's SharePoint Online solution for both intranet and public internet SharePoint sites.

By default, the CardioLog Analytics tracking code is hosted on the CardioLog application on-premise server. You can also host it on a dedicated tracking server (web server) in the DMZ, or as Azure App Service.

Anchor
app_server app_server

Configuring the CardioLog Analytics Tracking Agent on the CardioLog Application Server

Following the product installation and before running the Configuration Wizard, please do the following:

1. Configure a public DNS name for the CardioLog application server.
2. If you have a secured SharePoint Online site, create a certificate (Requires purchase of an SSL certificate from a certificate authority) for the CardioLog application server and configure SSL for the CardioLog web application in IIS.
3. Verify that you have a user account with the Site Collection administrator permissions.
4. Verify that the CardioLog Tracking Agent web application supports Anonymous Access by clicking the Click the CardioLogAgent web application in IIS, choose Authentication, enable Anonymous Authentication and disable Windows Authentication.

5. In [CardioLog Installation Folder]\CardioLogAgent\Web.config,

   set the

   update the following key values (edit the CardioLog application server public DNS name): 

   Info
   icon false
   <add key="overwriteConnectedUser"

   parameter to true: 

   value="true" /> <add key="

   overwriteConnectedUser

   UseSPAuth" value="true" /> <add key="CardioLogAgentRoot" value="https://cardiologserverdnsname" />

6. Verify that the CardioLog Tracking Agent web application is accessible over the internet by browsing to https://cardiologserverdnsname/CardioLogAgent/ca.aspx (edit the CardioLog application server public DNS name).
7. Verify that you have a Microsoft Live ID user account with the SharePoint Administrator role in Office 365 Admin Center.
   
   Note: The CardioLog application server public DNS name must be accessible over the internet.

Anchor
tracking_server tracking_server

Configuring the CardioLog Analytics Tracking Agent on a Dedicated Tracking Server in the DMZ

Following the product installation and before running the Configuration Wizard, please do the following:

1. Create a new CardioLogAgent web application in IIS on the CardioLog tracking server (web server). For the new web application, create a dedicated application pool and set ASP.NET version to 4.0. Set the authentication method of the web application to Anonymous access (disable Windows Authentication).

2. Copy the files from the CardioLog application server [CardioLog Installation Directory]\CardioLogAgent to the new directory.

3. Configure a public DNS name for the CardioLog tracking server.
4. If you have a secured SharePoint Online site, create a certificate (Requires purchase of an SSL certificate from a certificate authority) for the CardioLog tracking server and configure SSL for the CardioLogAgent web application in IIS.

5. In [CardioLog Tracking Agent Installation Folder]\CardioLogAgent\Web.config,

   set the "CardioLogAgentRoot" parameter to the public DNS name and appropriate protocol. For example:
   <add key="

   update the following key values (edit the CardioLog tracking server public DNS name): 

   Info
   icon false
   <add key="overwriteConnectedUser" value="true" /> <add key="UseSPAuth" value="true" /> <add key="CardioLogAgentRoot" value="

   http[s]

   https://

   cardiolog.mycompany.com

   cardiologtrackingserverdnsname" />

   Note: The URL should
6. Verify that the CardioLog Tracking Agent web application is accessible over the internet by browsing to https://cardiologtrackingserverdnsname/CardioLogAgent/ca.aspx (edit the CardioLog tracking server public DNS name).
7. Verify that you have a Microsoft Live ID user account with the SharePoint Administrator role in Office 365 Admin Center.
   
   Note: The CardioLog tracking server public DNS name must be accessible over the internet.

Anchor
#trackingappservice #trackingappservice

Configuring the CardioLog Analytics Tracking Agent on Azure App Service

Following the product installation and before running the Configuration Wizard, please follow the steps mentioned in Configuring the CardioLog Analytics Tracking Agent on Azure App Service

Anchor
wizard wizard

Running the Configuration Wizard

Upon activating CardioLog Analytics, the Configuration Wizard will be displayed. This wizard will help you configure the SharePoint Tracking Agent, which is a tool designed to monitor visitor behavior in SharePoint, and the SharePoint Adaptor, which provides the structure of your SharePoint Online sitetenant. Login to the CardioLog server with the CardioLog service account and verify that it has the required permissions before running the wizard.

1. Launch CardioLog. If the Configuration Wizard doesn't launch automatically, you can run it manually by clicking on Administration in the Navigation pane and then selecting System Configuration. Click Configuration Wizard to restart CardioLog and begin the configuration process.
2. In the Welcome dialog, select the desired UI language and date format. Under SharePoint Version, select SharePoint Online and then click Next.
   
   
   Configuration Wizard
   
   

3. Anchor
   configuring tracking configuring tracking

   You can add the tracking code by either deploying the CardioLog tracking code through a SharePoint solution, or. OR manually adding the JavaScript tracking code to your master pages.

   Note: You may select only one option to add the tracking code.
   
   Image RemovedImage Added
   Step 2 - Usage TrackingConfiguration Wizard Step 2a: SharePoint Online Usage Tracking 

   Anchor
   deploy tracking deploy tracking

   Deploy the CardioLog tracking code through a SharePoint solution

   You can deploy the tracking code on all selected site collections automatically or add the tracking code to a specific site collection manually.
   

   Anchor
   auto_deploy auto_deploy

   Deploying the Tracking Code to all Selected Site Collections Automatically

   1. Once you complete the Configuration Wizard, go to the Administration section of the navigation pane, click System Configuration, select SharePoint Tree Adaptor and then select your SharePoint Online tenant.
   2. Click on Download button to download the automatic deployment package.
      
      Image Added
      SharePoint Tree Adaptor Settings
      
      Note: The deployment package includes a PowerShell script that deploys the tracking agent wsp solution and Java Script tracking code on all selected site collections, as well as the modern sites integration app on the App catalog and on all selected site collections and their sub-sites.
   3. Right click the WSP-Tracking-Install-Script.zip file, select Properties > General and click on "Unblock" before unzipping it.
   4. Open the sites.json file and verify that all of the site collections you would like to track are included.

   5. Open the tracking.txt file. If you have chosen to configure the CardioLogAgent as Azure App Service, update it as follows:
      

      Info
      icon false
      sourceDomain: '<app service URL without https prefix>/js/modern', eventListenerDomain: '<app service URL without https prefix>', modules: ['survey-and-message-bar'],  statisticsPath: '<app service URL>/CardioLogAgent/ReportDispatcher.aspx'

       

      Otherwise, verify that the <cardiologserverdnsname> placeholders of the sourceDomain and eventListenerDomain fields that redirect to the CardioLog application server or dedicated tracking server have a public DNS name (that should be accessible over the internet).
      

      Info
      icon false
      sourceDomain: '<cardiologserverdnsname>/CardioLogAgent/js/modern', (CardioLog application server / tracking server public DNS name, without the https:// protocol prefix) eventListenerDomain: '<cardiologserverdnsname/CardioLogAgent', modules: ['survey-and-message-bar'],  statisticsPath: '<cardiologserverdnsname>/CardioLogAgent/ReportDispatcher.aspx'

   6. Execute the Run_Script.ps1 script in PowerShell. Make sure the you have the following prerequisites before executing the PowerShell script:
      
      • You must have PowerShell version 5.1 or higher with the MS Online module installed.
      • The credentials of the SharePoint Online global administrator.
      • If you are using multi-factor authentication (MFA), make sure you have an app password for Office 365.

      • Make sure custom scripts are turned on (changes in this setting take up to 24 hours to apply):
        Office 365 Admin > Admin Centers > SharePoint Admin Center > Settings > Custom Script > Select Allow in both options
        In case a specific site collection does not inherit these settings from SharePoint Central Administration, you can execute the following commands in SharePoint Online Management Shell (replace the placeholders for [company] and [site collection url]):

        Info
        icon false
        $url = "https://[company]-admin.sharepoint.com" $User = Read-Host -Prompt "Enter username for $url" $Password = Read-Host -Prompt 'Enter password' -AsSecureString $credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($User, $Password) $adminContext = New-Object Microsoft.SharePoint.Client.ClientContext($url) $adminContext.Credentials = $credentials $tenant = New-Object Microsoft.Online.SharePoint.TenantAdministration.Tenant($adminContext) $adminContext.Load($tenant) $adminContext.ExecuteQuery() $props = $tenant.GetSitePropertiesByUrl("[site collection url]", $false) $adminContext.Load($props) $adminContext.ExecuteQuery() $DenyAddAndCustomizePagesStatusEnum = [Microsoft.Online.SharePoint.TenantAdministration.DenyAddAndCustomizePagesStatus] $props.DenyAddAndCustomizePages = $DenyAddAndCustomizePagesStatusEnum::Disabled $props.Update() $adminContext.ExecuteQuery()

   Anchor
   manual_deploy manual_deploy

   Add the Tracking Code to a Site Collection Manually 

   1. Browse to your SharePoint Online site Solution Gallery (edit Replace the website root URL with yours): [https://intlock.sharepoint.com]/_catalogs/solutions/forms/allitems.aspx
      
      Image Modified
      'SharePoint Online site ' Site Solution Gallery
      
      
   2. Click Upload Solution > Choose File > select [CardioLog Installation Folder]\CardioLog\Configuration\AgentFeature\Online\Resources\CardioLog Analytics Integration.wsp >wsp > Activate
   3. Browse to CardioLog Analytics Integration solution configuration page (edit Replace the website root URL with yours): [https://intlock.sharepoint.com]/CardioLogAnalytics/Configuration.2.0.8.0.aspx
      
      Image Modified
      CardioLog Analytics Integration solution configuration pageSolution Configuration Page
      
      
   4. Copy the code from the Tracking Code box in Step 2 of the Configuration Wizard.
   5. Edit the tracking code and verify that the all URLs contained in the tracking code that redirect to the CardioLog application/tracking server , have the public DNS name and appropriate protocol. The URLs should be accessible over the internet. 
      Use https  Use HTTPS if you are tracking secured SharePoint Online site collections and http for public websites. 
   6. Add the JavaScript tracking code and click OK.
   Un-installing

   Anchor
   uninstalling uninstalling

   Uninstalling the CardioLog Analytics Tracking Agent Feature

   You can choose between pausing and un-installing uninstalling the tracking code from your SharePoint online sitesites:

   1. To pause the tracking code, browse to your SharePoint Online site Solution Gallery (edit the website root URL): [https://intlock.sharepoint.com]/_catalogs/solutions/forms/allitems.aspx and deactivate the CardioLog Analytics Integration solution.
   2. To uninstall the tracking code, deactivate the CardioLog Analytics Integration solution and then delete the solution.

   
   

   Anchor
   manually add js manually add js

   Manually Add the JavaScript Tracking Code to Your Master Pages

1. Open SharePoint Designer and add the SharePoint Online website: Go to Site Templates > Open Site > Enter website root URL (for example eg., - https://intlock.sharepoint.com/).
2. Open Site Objects > Master Pages > *.master (you can use we suggest the seattle.master page) and add the JavaScript tracking code in the <head> tag.
3. Verify that the all URLs contained in the tracking code that redirect to the CardioLog application/tracking server , have the public DNS name and appropriate protocol. The URLs should be accessible over the internet. Use https  Use HTTPS if you are tracking secured SharePoint Online site collections and http . You may choose to use HTTP for public websites.
   
   
4. In order to verify that your SharePoint Online pages are tracked, follow these steps:
   
   1. Open a new browser window and click Next Step.
   2. Delete your browser temporary internet files and click Next Step.
   3. Browse 3 pages on your SharePoint Online website and click Next Step.
   4. Click Test Event Collection. The Wizard will now verify usage events tracking.
   
   Image Added
   Step 2 - Usage Tracking
   

   
   Otherwise,

1. Browse Navigate to your SharePoint Online site homepage with Internet Explorer, Chrome, or FireFox (with Firebug).
2. Press F12
3. Select the Network tab (named Net" in FireFox)
4. Press Ctrl+F5 to clear the cache and reload the page.
5. Find the first entry for tunnel.aspx, and click to view details (response body)
6. Verify that statusId is 0 (statusId:0)
7. While on the SharePoint website page, click Ctrl+F12. The tracking agent console should pop-up, displaying the ID number for the most recent monitored action (event). To close the console, press Ctrl+F12.

5. Anchor
   tree structure tree structure

   In the SharePoint Adaptor dialog, enter the name a title and root URL of your SharePoint Online site collectionAdmin Center. Specify the authentication details used to connect to the websiteit, then click Next. Loading your SharePoint Online tree structure may take several minutes (to a few hours, depending on the number of items in the selected website)websites.
   
   Note: Please confirm Confirm that the CardioLog service account has the Site Collection administrator permission.
   the SharePoint Administrator role enabled in Office 365 Admin Center, under Customized Administrator.

   
   Image Added
   
   Configuration Wizard Step 3 - SharePoint Adaptor
   
   

6. In the SharePoint Adaptor dialog, select the SharePoint website(s) you would like to report on, then click Next.
   
   Image Added
   
   Configuration Wizard Step 3 - SharePoint Adaptor Web Site Selection
    
7. In the Usage Data Processing dialog, click Next.
   
   Image Added
   Configuration Wizard Step 4 - Usage Data Processing
   
   
8. In the Finish dialog, click Finish. Click Show Raw Usage Data to view the usage events collected thus far. The data will be available in reports in the next hour.
   Step 5 - Finish

...

In order to monitor additional site collections in your existing SharePoint Online environment, please do the following: 

1. In the Administration pane, click System Configuration, and then select SharePoint Tree Adaptor.
2. Click on your SharePoint Online website and select the site collection/s you want to monitor.
3. You can load your site collections list from a csv file. In order to create the csv file, use the Windows PowerShell for SharePoint Online Get-SPOSite | Export-CSV command, and enter the csv file path in the Site Collection List File Path (.csv) field.
4. Click Save.
5. If you have many sites and would like to automate this process via a Power Shell script please see how to create a CSV file for your SharePoint Online site collections.           
6. Restart the CardioLog Scheduling Service. The tree structure will be refreshed the next day.
7. Configure event collection - deploy the CardioLog Analytics SharePoint solution on your site collection/s or insert the code manually (to your master page).

...

In order to monitor an additional SharePoint Online environment, please do the following:

...

...

In order to update the tracking code on all site collections in your SharePoint Online environment, please do the following:

Copy the tracking code from the Tracking Code box in the Administration pane > System Configuration > Usage Tracking Code, and then select SharePoint Online.
System Configuration > Usage Tracking Code

1. Verify that the all URLs contained in the tracking code that redirect to the CardioLog application server, have the public DNS name and appropriate protocol. The URLs should be accessible over the internet. Use https if you are tracking secured SharePoint Online site collections and http for public websites.
2. In the Administration pane, click System Configuration, and then select SharePoint Tree Adaptor.
3. Click on your SharePoint Online website.
4. Click on Publish Tracking Code.
   System Configuration - SharePoint Tree Adaptor - Publish Tracking Code
   Add the JavaScript tracking code and click Apply.
   Publish Tracking CodeImage Added
   Configuration Wizard - Finish