Configure Monitoring of Browser | Germain Documentation

⚙️ Configure Browser Monitoring

GermainUX includes preconfigured browser monitoring for user activity, Session Replay, performance, errors, network requests, browser freezes, and common user-experience friction.

After deploying RUM JS, the RUM Extension, or the JS Profiler, most browser insights are automatically collected and analyzed. Additional configuration is required only when you need to customize the default behavior for a particular application or business requirement.

🧩 Browser-monitoring components

Component	Primary purpose
GermainUX RUM JS	Monitor real users in applications where the GermainUX script can be deployed
GermainUX RUM Extension	Monitor applications where script injection is unavailable or browser-level access is required
GermainUX JS Profiler	Profile JavaScript execution and identify browser-side code bottlenecks

These components can be deployed independently or together according to the required monitoring depth.

✅ Preconfigured monitoring

Depending on the deployed component, GermainUX provides preconfigured monitoring for capabilities such as:

Capability	Details
User activity	Page views, navigation, clicks, selections, searches, and supported input activity
Session Replay	Millisecond-precise reconstruction of monitored browser sessions
Heatmaps	Aggregated analysis of user interactions and behavior
Click friction	Standard, dead, error, and rage clicks
Page performance	Page loads, user interactions, resources, and supported Core Web Vitals
JavaScript errors	Exceptions, console errors, and unhandled promise rejections
Browser responsiveness	JavaScript long tasks and browser freezes
Network activity	Supported browser HTTP requests, response times, status codes, and failures
Browser memory	Supported JavaScript and page-memory measurements
Browser events	Popup dialogs, browser crashes, policy violations, and deprecated-feature reports
WebSockets	Supported WebSocket connections and activity
Application context	Browser, device, operating system, page, application, and environment
Automated analysis	Trends, outliers, correlations, affected users, and business impact

The exact monitoring available depends on the deployed component, browser capabilities, application architecture, and GermainUX version.

🔧 Required configuration

For most applications, configure only the following.

📋 Application and profile

Create or select the monitored application.
Enter the application URL.
Select the environment.
Create or select the UX Monitoring Profile.
Deploy RUM JS, the RUM Extension, or the JS Profiler.
Confirm that browser telemetry reaches GermainUX.

🔒 Security and privacy

Before production rollout, review and configure:

Item	Details
Applications, pages, and users authorized for monitoring	Review who and what is authorized
Fields and content that must be masked or excluded	Identify sensitive fields and content for masking or exclusion
Password, payment, authentication, and other sensitive fields	Specify handling and masking rules
Consent requirements	Ensure consent flows and legal requirements are met
Session Replay access	Control who can view Session Replay data
Sampling	Define sampling strategies for data collection
Data retention and deletion	Set retention periods and deletion policies

Privacy configuration must be validated across the application’s principal pages, forms, dialogs, routes, and frames.

🆔 Application identification

Confirm that GermainUX correctly identifies:

Identifier	Expected value
Application	App name or identifier
Environment	Production, staging, etc.
Page or route	Page or route identifiers
Browser and browser version	Detected browser details
Application version, when available	Version metadata
User or session, when collection is authorized	User or session identifiers (if authorized)

✅ Validation

Open the monitored application.
Navigate through representative pages or routes.
Perform several user actions.
Execute representative network requests.
Confirm that the session and browser facts appear in GermainUX.
Open Session Replay when enabled.
Confirm that sensitive information is protected.
Verify that the expected performance, error, and network insights are available.

✨ Optional customization

Customize the preconfigured monitoring only when the default behavior does not meet the application’s requirements.

⚙️ Monitoring features

Customization	Use
Battery Level Monitoring	Change the battery threshold or charging-status behavior
Browser Crash Monitoring	Adjust supported browser-crash detection
Browser Deprecated Features and Policy Violations	Customize browser-report collection
Chat/CTI Monitoring	Integrate a supported or customer-specific chat or CTI component
Core Web Vitals	Adjust supported page-performance collection
Dead, Error and Rage Click Monitoring	Change click thresholds or element exclusions
Element and Mark Performance Monitoring	Measure customer-specific elements or performance marks
JavaScript and Page Memory Monitoring	Adjust memory monitoring
JavaScript Console and Error Monitoring	Change console levels, errors, or exclusions
JavaScript Long Task or Browser Freeze Detection	Change long-task or freeze thresholds
Metadata Extractors	Add authorized user, session, application, or business context
Network Requests Monitoring	Customize included URLs, exclusions, payload collection, or correlation
Popup Dialog Monitoring	Select dialog types or measure dialog duration
Server Timing Monitoring	Collect application-specific `Server-Timing` values
Unhandled Promise Rejection Monitoring	Customize promise-rejection collection
Video Monitoring	Monitor interactions with a supported video player
WebSocket Monitoring	Customize WebSocket connection or message monitoring

💡 Optional application-specific insights

Additional configuration is appropriate when customers want GermainUX to understand application-specific business activity.

Examples include:

Example	Notes
Feature usage	Track which features are used and frequency
Business-process milestones	Identify steps and completion points
Customer journeys	Map user flows through the app
Conversion and abandonment	Measure conversions and drop-offs
Application-specific errors	Capture domain-specific error conditions
User-visible sentences	Monitor messages shown to users
Order, case, or transaction identifiers	Attach identifiers for correlation
Customer-defined events	Custom events defined by the customer
Custom Session Replay timeline insights	Augment Session Replay with business events

Use the Browser Monitoring APIs and Custom Insights when these events are not already available through the preconfigured monitoring.

🏷️ Optional metadata

GermainUX automatically provides standard browser and application context. Configure Metadata Extractors only when additional application-specific context is required, such as:

Metadata	Purpose
Internal user or session ID	Correlate telemetry with internal identifiers
Role or team	Segment by organizational role
Tenant	Multi-tenant identification
Application version	Track releases and regressions
Account, case, order, or transaction ID	Attach business identifiers for triage
Product or customer segment	Segment telemetry by product or segment

Collect only metadata that is necessary and authorized.

📈 Optional KPI and SLA customization

GermainUX includes preconfigured browser KPIs, measures, pivots, and SLAs.

Customize them only when you need to:

Customize	When to use
Add an application-specific KPI	When default KPIs don't reflect business goals
Change an existing threshold	Adjust sensitivity to match SLAs
Add a custom measure or pivot	Create tailored analytics
Define a customer-specific SLA	Set contractual or internal SLAs
Categorize an application-specific error	Map errors to domain categories
Correlate browser activity with another data source	Join telemetry to external datasets
Configure a customer-specific alert, Watch, report, or action	Create tailored notifications and automations

Review the available Browser Monitoring KPIs.

🚀 Deployment and configuration

For your browser-based application
Review Browser Monitoring.
Deploy GermainUX RUM JS, the GermainUX RUM Extension, or the GermainUX JS Profiler.
Select the application, URL, environment, and UX Monitoring Profile.
Review and validate Session Replay, privacy, consent, masking, sampling, access, and retention.
Confirm that GermainUX’s preconfigured browser monitoring is collecting the expected data.
Customize monitoring only when the application or business requirements differ from the preconfigured behavior.
Review the available Browser Monitoring KPIs.
Use the Browser Monitoring APIs for application-specific events and metadata.

ℹ️ Get Help

The Germain Team can help you set this up. Contact GermainUX Support.

Component: JS Profiler, RUM JS, RUM Extension

Feature Availability: 2022.1 or later