Introduce 'sendRawTelemetryEvent'

lib/telemetryReporter.d.ts

@@ -5,6 +5,11 @@
 export interface TelemetryEventProperties {
 	readonly [key: string]: string;
 }
+
+export interface TelemetryRawEventProperties {
+	readonly [key: string]: any;
+}
+
 export interface TelemetryEventMeasurements {
 	readonly [key: string]: number;
 }
@@ -19,12 +24,21 @@ export default class TelemetryReporter {
 
 	/**
 	 * Sends a telemetry event with the given properties and measurements
+	 * Properties are sanitized on best-effort basis to remove sensitive data prior to sending.
 	 * @param eventName The name of the event
 	 * @param properties The set of properties to add to the event in the form of a string key value pair
 	 * @param measurements The set of measurements to add to the event in the form of a string key  number value pair
 	 */
 	sendTelemetryEvent(eventName: string, properties?: TelemetryEventProperties, measurements?: TelemetryEventMeasurements): void;
 
+	/**
+	 * Sends a raw (unsanitized) telemetry event with the given properties and measurements
+	 * @param eventName The name of the event
+	 * @param properties The set of properties to add to the event in the form of a string key value pair
+	 * @param measurements The set of measurements to add to the event in the form of a string key  number value pair
+	 */
+	sendRawTelemetryEvent(eventName: string, properties?: TelemetryRawEventProperties, measurements?: TelemetryEventMeasurements): void;
+
 	/**
 	 * Sends a telemetry error event with the given properties, measurements, and errorProps
 	 * @param eventName The name of the event

src/common/baseTelemetryReporter.ts

@@ -3,11 +3,11 @@
  *--------------------------------------------------------*/
 
 import * as vscode from "vscode";
-import type { TelemetryEventMeasurements, TelemetryEventProperties } from "../../lib/telemetryReporter";
+import type { TelemetryEventMeasurements, TelemetryEventProperties, TelemetryRawEventProperties } from "../../lib/telemetryReporter";
 import { getTelemetryLevel, TelemetryLevel } from "./util";
 
 export interface AppenderData {
-	properties?: TelemetryEventProperties,
+	properties?: TelemetryRawEventProperties,
 	measurements?: TelemetryEventMeasurements
 }
 export interface ITelemetryAppender {
@@ -261,7 +261,8 @@ export class BaseTelemtryReporter {
 	}
 
 	/**
-	 * Given an event name, some properties, and measurements sends a teleemtry event
+	 * Given an event name, some properties, and measurements sends a telemetry event.
+	 * Properties are sanitized on best-effort basis to remove sensitive data prior to sending.
 	 * @param eventName The name of the event
 	 * @param properties The properties to send with the event
 	 * @param measurements The measurements (numeric values) to send with the event
@@ -274,6 +275,19 @@ export class BaseTelemtryReporter {
 		}
 	}
 
+	/**
+	 * Given an event name, some properties, and measurements sends a raw (unsanitized) telemetry event
+	 * @param eventName The name of the event
+	 * @param properties The properties to send with the event
+	 * @param measurements The measurements (numeric values) to send with the event
+	 */
+	public sendRawTelemetryEvent(eventName: string, properties?: TelemetryRawEventProperties, measurements?: TelemetryEventMeasurements): void {
+		if (this.userOptIn && eventName !== "") {
+			properties = { ...properties, ...this.getCommonProperties() };
+			this.telemetryAppender.logEvent(`${this.extensionId}/${eventName}`, { properties: properties, measurements: measurements });
+		}
+	}
+
 	/**
 	 * Given an event name, some properties, and measurements sends an error event
 	 * @param eventName The name of the event