feat: add Datadog RUM session tracking integration

apps/lfx-pcc/package.json

@@ -26,6 +26,7 @@
     "@angular/platform-server": "^19.2.0",
     "@angular/router": "^19.2.0",
     "@angular/ssr": "^19.2.11",
+    "@datadog/browser-rum": "^6.16.0",
     "@fullcalendar/angular": "^6.1.18",
     "@fullcalendar/core": "^6.1.18",
     "@fullcalendar/daygrid": "^6.1.18",

apps/lfx-pcc/src/app/app.component.ts

@@ -8,6 +8,7 @@ import { AuthContext } from '@lfx-pcc/shared/interfaces';
 import { ToastModule } from 'primeng/toast';
 
 import { HeaderComponent } from './shared/components/header/header.component';
+import { DatadogRumService } from './shared/services/datadog-rum.service';
 import { UserService } from './shared/services/user.service';
 
 @Component({
@@ -19,12 +20,14 @@ import { UserService } from './shared/services/user.service';
 })
 export class AppComponent {
   private readonly userService = inject(UserService);
+  private readonly datadogRumService = inject(DatadogRumService);
 
   public auth: AuthContext | undefined;
   public transferState = inject(TransferState);
   public serverKey = makeStateKey<AuthContext>('auth');
 
   public constructor() {
+    this.datadogRumService.initialize();
     const reqContext = inject(REQUEST_CONTEXT, { optional: true }) as {
       auth: AuthContext;
     };
@@ -46,6 +49,13 @@ export class AppComponent {
     if (this.auth?.authenticated) {
       this.userService.authenticated.set(true);
       this.userService.user.set(this.auth.user);
+
+      // Set user context in Datadog RUM
+      this.datadogRumService.setUser({
+        id: this.auth.user?.id,
+        name: this.auth.user?.name,
+        email: this.auth.user?.email,
+      });
     }
   }
 }

apps/lfx-pcc/src/app/shared/services/datadog-rum.service.ts

@@ -0,0 +1,87 @@
+// Copyright The Linux Foundation and each contributor to LFX.
+// SPDX-License-Identifier: MIT
+
+import { Injectable } from '@angular/core';
+import { datadogRum } from '@datadog/browser-rum';
+import { environment } from '../../../environments/environment';
+
+@Injectable({
+  providedIn: 'root',
+})
+export class DatadogRumService {
+  private isInitialized = false;
+
+  public initialize(): void {
+    if (this.isInitialized || !environment.datadog.enabled) {
+      return;
+    }
+
+    if (!environment.datadog.applicationId || !environment.datadog.clientToken) {
+      console.warn('Datadog RUM: Missing applicationId or clientToken in environment configuration');
+      return;
+    }
+
+    try {
+      datadogRum.init({
+        applicationId: environment.datadog.applicationId,
+        clientToken: environment.datadog.clientToken,
+        site: environment.datadog.site as 'datadoghq.com',
+        service: environment.datadog.service,
+        env: environment.datadog.env,
+        version: '1.0.0',
+        sessionSampleRate: 100,
+        sessionReplaySampleRate: 20,
+        trackUserInteractions: true,
+        trackResources: true,
+        trackLongTasks: true,
+        defaultPrivacyLevel: 'mask-user-input',
+      });
+
+      this.isInitialized = true;
+    } catch (error) {
+      console.error('Failed to initialize Datadog RUM:', error);
+    }
+  }
+
+  public addAction(name: string, context?: object): void {
+    if (this.isInitialized) {
+      datadogRum.addAction(name, context);
+    }
+  }
+
+  public addError(error: Error, context?: object): void {
+    if (this.isInitialized) {
+      datadogRum.addError(error, context);
+    }
+  }
+
+  public setUser(user: { id?: string; name?: string; email?: string }): void {
+    if (this.isInitialized) {
+      datadogRum.setUser(user);
+    }
+  }
+
+  public setUserProperty(key: string, value: any): void {
+    if (this.isInitialized) {
+      datadogRum.setUserProperty(key, value);
+    }
+  }
+
+  public setGlobalContextProperty(key: string, value: any): void {
+    if (this.isInitialized) {
+      datadogRum.setGlobalContextProperty(key, value);
+    }
+  }
+
+  public removeGlobalContextProperty(key: string): void {
+    if (this.isInitialized) {
+      datadogRum.removeGlobalContextProperty(key);
+    }
+  }
+
+  public startView(name: string): void {
+    if (this.isInitialized) {
+      datadogRum.startView(name);
+    }
+  }
+}

apps/lfx-pcc/src/environments/environment.dev.ts

@@ -6,4 +6,12 @@ export const environment = {
   urls: {
     profile: 'https://myprofile.dev.platform.linuxfoundation.org/',
   },
+  datadog: {
+    enabled: true,
+    applicationId: process.env['DD_APPLICATION_ID'] || '',
+    clientToken: process.env['DD_CLIENT_TOKEN'] || '',
+    site: 'datadoghq.com',
+    service: 'lfx-projects-self-service',
+    env: process.env['DD_ENV'] || 'dev',
+  },
 };

apps/lfx-pcc/src/environments/environment.prod.ts

@@ -6,4 +6,12 @@ export const environment = {
   urls: {
     profile: 'https://openprofile.dev',
   },
+  datadog: {
+    enabled: true,
+    applicationId: process.env['DD_APPLICATION_ID'] || '',
+    clientToken: process.env['DD_CLIENT_TOKEN'] || '',
+    site: 'datadoghq.com',
+    service: 'lfx-projects-self-service',
+    env: process.env['DD_ENV'] || 'prod',
+  },
 };

apps/lfx-pcc/src/environments/environment.ts

@@ -6,4 +6,12 @@ export const environment = {
   urls: {
     profile: 'https://myprofile.dev.platform.linuxfoundation.org/',
   },
+  datadog: {
+    enabled: false,
+    applicationId: '',
+    clientToken: '',
+    site: 'datadoghq.com',
+    service: 'lfx-projects-self-service',
+    env: 'local',
+  },
 };

yarn.lock

@@ -1743,6 +1743,37 @@ __metadata:
   languageName: node
   linkType: hard
 
+"@datadog/browser-core@npm:6.16.0":
+  version: 6.16.0
+  resolution: "@datadog/browser-core@npm:6.16.0"
+  checksum: 10c0/9438867b342f6d9db78575a632da3f97159cf2ffcec869a0e3a306261d01e3048b098155c75addbfae7909572a1ded46beed60ea2938eb166fc7a8250e683a66
+  languageName: node
+  linkType: hard
+
+"@datadog/browser-rum-core@npm:6.16.0":
+  version: 6.16.0
+  resolution: "@datadog/browser-rum-core@npm:6.16.0"
+  dependencies:
+    "@datadog/browser-core": "npm:6.16.0"
+  checksum: 10c0/9bf9853e930d0630a209a14371140423569a5856d9586fdb5e0fd18fbaa953e24ad107abcad4c0349af9c694e007dea339b107d481fe29d6733993c4222c1e60
+  languageName: node
+  linkType: hard
+
+"@datadog/browser-rum@npm:^6.16.0":
+  version: 6.16.0
+  resolution: "@datadog/browser-rum@npm:6.16.0"
+  dependencies:
+    "@datadog/browser-core": "npm:6.16.0"
+    "@datadog/browser-rum-core": "npm:6.16.0"
+  peerDependencies:
+    "@datadog/browser-logs": 6.16.0
+  peerDependenciesMeta:
+    "@datadog/browser-logs":
+      optional: true
+  checksum: 10c0/e2843a1b20267b2929f6a7a2fe457b60f8c3b3e83faaf1e8fad9264484bc574032b7d5ca6ae1faca9821fd35f5c576bf884da4e1258a04f7bf76624ff9ff0251
+  languageName: node
+  linkType: hard
+
 "@discoveryjs/json-ext@npm:0.6.3":
   version: 0.6.3
   resolution: "@discoveryjs/json-ext@npm:0.6.3"
@@ -8074,6 +8105,7 @@ __metadata:
     "@angular/platform-server": "npm:^19.2.0"
     "@angular/router": "npm:^19.2.0"
     "@angular/ssr": "npm:^19.2.11"
+    "@datadog/browser-rum": "npm:^6.16.0"
     "@eslint/compat": "npm:^1.3.1"
     "@eslint/eslintrc": "npm:^3.3.1"
     "@eslint/js": "npm:^9.31.0"