Add Dialog / PageView telemetry

libraries/botbuilder-applicationinsights/package.json

@@ -21,7 +21,7 @@
   "main": "./lib/index.js",
   "typings": "./lib/index.d.ts",
   "dependencies": {
-    "applicationinsights": "1.2.0",
+    "applicationinsights": "1.7.5",
     "botbuilder-core": "4.1.6",
     "cls-hooked": "^4.2.2"
   },

libraries/botbuilder-applicationinsights/src/applicationInsightsTelemetryClient.ts

@@ -6,7 +6,7 @@
  * Licensed under the MIT License.
  */
 import * as appInsights from 'applicationinsights';
-import { Activity, BotTelemetryClient, TelemetryDependency, TelemetryEvent, TelemetryException, TelemetryTrace } from 'botbuilder-core';
+import { Activity, BotTelemetryClient, BotPageViewTelemetryClient, TelemetryDependency, TelemetryEvent, TelemetryException, TelemetryTrace, TelemetryPageView } from 'botbuilder-core';
 import * as cls from 'cls-hooked';
 import * as crypto from 'crypto';
 const ns: any = cls.createNamespace('my.request');
@@ -61,7 +61,7 @@ export const ApplicationInsightsWebserverMiddleware: any = (req: any, res: any,
  * myDialog.telemetryClient = appInsightsClient;
  * ```
  */
-export class ApplicationInsightsTelemetryClient implements BotTelemetryClient {
+export class ApplicationInsightsTelemetryClient implements BotTelemetryClient, BotPageViewTelemetryClient {
 
     private client: appInsights.TelemetryClient;
     private config: appInsights.Configuration;
@@ -117,6 +117,10 @@ export class ApplicationInsightsTelemetryClient implements BotTelemetryClient {
         this.defaultClient.trackTrace(telemetry as appInsights.Contracts.TraceTelemetry);
     }
 
+    public trackPageView(telemetry: TelemetryPageView): void {
+        this.defaultClient.trackPageView(telemetry as appInsights.Contracts.PageViewTelemetry);
+    }
+
     public flush(): void {
         this.defaultClient.flush();
     }

libraries/botbuilder-core/src/botTelemetryClient.ts

@@ -27,6 +27,10 @@ export interface BotTelemetryClient {
     flush();
 }
 
+export interface BotPageViewTelemetryClient {
+    trackPageView(telemetry: TelemetryPageView);
+}
+
 export interface TelemetryDependency {
     dependencyTypeName: string;
     target: string;
@@ -57,11 +61,21 @@ export interface TelemetryTrace {
     severityLevel?: Severity;
 }
 
-export class NullTelemetryClient implements BotTelemetryClient {
+export interface TelemetryPageView {
+    name: string;
+    properties?: {[key: string]: string};
+    metrics?: {[key: string]: number };
+}
+
+export class NullTelemetryClient implements BotTelemetryClient, BotPageViewTelemetryClient {
 
     constructor(settings?: any) {
         // noop
     }
+
+    trackPageView(telemetry: TelemetryPageView) {
+        // noop
+    }
 
     trackDependency(telemetry: TelemetryDependency) {
         // noop
@@ -74,6 +88,7 @@ export class NullTelemetryClient implements BotTelemetryClient {
     trackException(telemetry: TelemetryException)  {
         // noop
     }
+
     trackTrace(telemetry: TelemetryTrace) {
         // noop
     }

libraries/botbuilder-core/src/extensions.ts

@@ -0,0 +1,31 @@
+/**
+ * @module botbuilder
+ */
+/**
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the MIT License.
+ */
+
+import { BotTelemetryClient, BotPageViewTelemetryClient, Severity } from './botTelemetryClient';
+
+/**
+ * Some util and extension functions
+ */
+export class Extensions {
+
+    public static TelemetryTrackDialogView(telemetryClient: BotTelemetryClient, dialogName: string, properties?: {[key: string]: any}, metrics?: {[key: string]: number }): void
+    {
+        if (this.instanceOfBotPageViewTelemetryClient(telemetryClient))
+        {
+            telemetryClient.trackPageView({ name: dialogName, properties: properties, metrics: metrics });
+        }
+        else
+        {
+            telemetryClient.trackTrace({ message: 'Dialog View: ' + dialogName, severityLevel: Severity.Information } );
+        }
+    }
+
+    private static instanceOfBotPageViewTelemetryClient(object: any): object is BotPageViewTelemetryClient {
+        return 'trackPageView' in object;
+    }
+}

libraries/botbuilder-core/src/index.ts

@@ -31,6 +31,7 @@ export * from './propertyManager';
 export * from './recognizerResult';
 export * from './showTypingMiddleware';
 export * from './signInConstants';
+export * from './extensions';
 export {
     BotFrameworkSkill,
     BotFrameworkClient,

libraries/botbuilder-dialogs/src/componentDialog.ts

@@ -5,7 +5,7 @@
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Licensed under the MIT License.
  */
-import { TurnContext, BotTelemetryClient, NullTelemetryClient } from 'botbuilder-core';
+import { TurnContext, BotTelemetryClient, NullTelemetryClient, Extensions } from 'botbuilder-core';
 import { Dialog, DialogInstance, DialogReason, DialogTurnResult, DialogTurnStatus } from './dialog';
 import { DialogContext } from './dialogContext';
 import { DialogContainer } from './dialogContainer';
@@ -81,6 +81,8 @@ export class ComponentDialog<O extends object = {}> extends DialogContainer<O> {
     public async beginDialog(outerDC: DialogContext, options?: O): Promise<DialogTurnResult> {
         await this.checkForVersionChange(outerDC);
 
+        Extensions.TelemetryTrackDialogView(this.telemetryClient, this.id);
+
         // Start the inner dialog.
         const innerDC: DialogContext = this.createChildContext(outerDC)
         const turnResult: DialogTurnResult<any> = await this.onBeginDialog(innerDC, options);

libraries/botbuilder-dialogs/src/waterfallDialog.ts

@@ -5,8 +5,8 @@
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Licensed under the MIT License.
  */
-import { ActivityTypes } from 'botbuilder-core';
-import { TurnContext } from 'botbuilder-core';
+import { ActivityTypes, Severity } from 'botbuilder-core';
+import { TurnContext, Extensions } from 'botbuilder-core';
 import { DialogInstance } from './dialog';
 import { Dialog, DialogReason, DialogTurnResult } from './dialog';
 import { DialogContext } from './dialogContext';
@@ -151,6 +151,8 @@ export class WaterfallDialog<O extends object = {}> extends Dialog<O> {
             'InstanceId': state.values['instanceId']
         }});
 
+        Extensions.TelemetryTrackDialogView(this.telemetryClient, this.id);
+
         // Run the first step
         return await this.runStep(dc, 0, DialogReason.beginCalled);
     }

package.json

@@ -26,6 +26,7 @@
     "@types/lodash": "^4.14.134",
     "@typescript-eslint/eslint-plugin": "^1.10.2",
     "@typescript-eslint/parser": "^1.10.2",
+    "applicationinsights": "^1.7.5",
     "coveralls": "^3.0.4",
     "eslint": "^5.16.0",
     "eslint-plugin-only-warn": "^1.0.1",