add create env trigger telemetry

Author: eleanorjboyd

src/common/pickers/environments.ts

@@ -1,12 +1,14 @@
-import { Uri, ThemeIcon, QuickPickItem, QuickPickItemKind, ProgressLocation, QuickInputButtons } from 'vscode';
+import { ProgressLocation, QuickInputButtons, QuickPickItem, QuickPickItemKind, ThemeIcon, Uri } from 'vscode';
 import { IconPath, PythonEnvironment, PythonProject } from '../../api';
 import { InternalEnvironmentManager } from '../../internal.api';
 import { Common, Interpreter, Pickers } from '../localize';
-import { showQuickPickWithButtons, showQuickPick, showOpenDialog, withProgress } from '../window.apis';
 import { traceError } from '../logging';
-import { pickEnvironmentManager } from './managers';
-import { handlePythonPath } from '../utils/pythonPath';
+import { EventNames } from '../telemetry/constants';
+import { sendTelemetryEvent } from '../telemetry/sender';
 import { isWindows } from '../utils/platformUtils';
+import { handlePythonPath } from '../utils/pythonPath';
+import { showOpenDialog, showQuickPick, showQuickPickWithButtons, withProgress } from '../window.apis';
+import { pickEnvironmentManager } from './managers';
 
 type QuickPickIcon =
     | Uri
@@ -80,6 +82,7 @@ async function createEnvironment(
     const manager = managers.find((m) => m.id === managerId);
     if (manager) {
         try {
+            // add telemetry here
             const env = await manager.create(
                 options.projects.map((p) => p.uri),
                 undefined,
@@ -111,6 +114,10 @@ async function pickEnvironmentImpl(
         if (selected.label === Interpreter.browsePath) {
             return browseForPython(managers, projectEnvManagers);
         } else if (selected.label === Interpreter.createVirtualEnvironment) {
+            sendTelemetryEvent(EventNames.CREATE_ENVIRONMENT, undefined, {
+                manager: 'none',
+                triggeredLocation: 'pickEnv',
+            });
             return createEnvironment(managers, projectEnvManagers, options);
         }
         return (selected as { result: PythonEnvironment })?.result;

src/common/telemetry/constants.ts

@@ -12,6 +12,13 @@ export enum EventNames {
 
     PACKAGE_MANAGEMENT = 'PACKAGE_MANAGEMENT',
     ADD_PROJECT = 'ADD_PROJECT',
+    /**
+     * Telemetry event for when a Python environment is created via command.
+     * Properties:
+     * - manager: string (the id of the environment manager used, or 'none')
+     * - triggeredLocation: string (where the create command is called from)
+     */
+    CREATE_ENVIRONMENT = 'CREATE_ENVIRONMENT',
 }
 
 // Map all events to their properties
@@ -102,4 +109,15 @@ export interface IEventNamePropertyMapping {
         totalProjectCount: number;
         triggeredLocation: 'templateCreate' | 'add' | 'addGivenResource';
     };
+
+    /* __GDPR__
+        "create_environment": {
+            "manager": { "classification": "SystemMetaData", "purpose": "FeatureInsight", "owner": "eleanorjboyd" },
+            "triggeredLocation": { "classification": "SystemMetaData", "purpose": "FeatureInsight", "owner": "eleanorjboyd" }
+        }
+    */
+    [EventNames.CREATE_ENVIRONMENT]: {
+        manager: string;
+        triggeredLocation: string;
+    };
 }

src/extension.ts

@@ -231,9 +231,23 @@ export async function activate(context: ExtensionContext): Promise<PythonEnviron
             await refreshPackagesCommand(item, envManagers);
         }),
         commands.registerCommand('python-envs.create', async (item) => {
+            // Telemetry: record environment creation attempt with selected manager
+            let managerId = 'unknown';
+            if (item && item.manager && item.manager.id) {
+                managerId = item.manager.id;
+            }
+            sendTelemetryEvent(EventNames.CREATE_ENVIRONMENT, undefined, {
+                manager: managerId,
+                triggeredLocation: 'createSpecifiedCommand',
+            });
             return await createEnvironmentCommand(item, envManagers, projectManager);
         }),
         commands.registerCommand('python-envs.createAny', async (options) => {
+            // Telemetry: record environment creation attempt with no specific manager
+            sendTelemetryEvent(EventNames.CREATE_ENVIRONMENT, undefined, {
+                manager: 'none',
+                triggeredLocation: 'createAnyCommand',
+            });
             return await createAnyEnvironmentCommand(
                 envManagers,
                 projectManager,