⚙️ Configure Monitoring for Salesforce Experience Cloud
After deploying GermainUX, configure the Salesforce Experience Cloud site to monitor actual users, Session Replay, feedback, business processes, errors, performance, APIs, synthetic journeys, and automated responses.
GermainUX configuration is modular. Enable only the capabilities required for the monitored site and user population.
Feature availability: GermainUX 2023.1 or later
🧩 Components
|
Component |
Primary purpose |
|---|---|
|
RUM JS |
Real User Monitoring, Session Replay, user behavior, errors, feedback, and business-process analysis |
|
Engine |
Salesforce APIs, events, logs, capacity, instance status, alerts, and automation |
|
JS Profiler |
Targeted browser, JavaScript, and network diagnostics |
|
Mobile App |
Native mobile application and device monitoring |
|
RPA Bot Recorder |
Creation of Selenium-based synthetic user scenarios |
See Deploy Monitoring for Salesforce Experience Cloud.
▶️ Configuration sequence
Configure the site in this order:
-
Review the Experience Cloud UX Monitoring Profile.
-
Verify site URL matching.
-
Configure authenticated and guest-user identification.
-
Configure session boundaries and timeout.
-
Enable and validate Session Replay.
-
Configure privacy, masking, and exclusions.
-
Exclude bots, crawlers, synthetic users, and service accounts.
-
Configure user feedback.
-
Define critical business processes.
-
Configure error and validation classification.
-
Enable Salesforce API and platform monitoring when required.
-
Configure synthetic user scenarios.
-
Enable KPIs, SLAs, alerts, dashboards, and automation.
-
Validate the complete configuration.
🔎 Review the UX Monitoring Profile
Go to:
Workspace > Analytics > UX Monitoring Profiles
Depending on the GermainUX version:
Workspace > Settings > Analytics > UX Monitoring Profiles
Select the profile created for the Salesforce Experience Cloud site.
Review:
|
Attribute |
|---|
|
Application name |
|
Environment |
|
Site URL |
|
URL-matching rules |
|
Monitoring status |
|
Session Replay status |
|
Privacy settings |
|
Bot and crawler exclusions |
|
Initialization script |
|
User and session metadata |
|
Data generators |
|
Installed plugins |
Create separate profiles when sites or environments require different URLs, privacy rules, user identification, or capture settings.
🔗 Configure URL matching
The profile must match every intended Experience Cloud URL and exclude unrelated Salesforce sites.
Review:
|
Item |
|---|
|
Production and sandbox domains |
|
Custom domains |
|
Login and logout pages |
|
Authenticated and guest paths |
|
Language-specific paths |
|
Redirects |
|
Mobile routes |
|
Legacy and current site URLs |
Avoid a broad domain rule that unintentionally monitors Salesforce Setup, internal Lightning applications, or unrelated Experience Cloud sites.
👥 Configure user identification
Experience Cloud sites can contain authenticated customers, partners, employees, and anonymous visitors.
🆔 Authenticated users
Select an approved identifier, such as:
|
Identifier |
|---|
|
Salesforce user ID |
|
Experience Cloud user ID |
|
A pseudonymous customer or partner ID |
|
Another authorized application identifier |
Avoid collecting authentication tokens, session identifiers, passwords, or other security credentials.
Confirm that identity is updated after login and removed or changed after logout.
👻 Guest users
Use an anonymous browser or session identifier for unauthenticated visitors.
Confirm that:
-
Guest sessions remain anonymous.
-
Separate visitors are not combined.
-
Login transitions are handled correctly.
-
Authenticated activity is not assigned to the previous guest identity.
-
Consent requirements are satisfied.
⏳ Configure session boundaries
Define when an Experience Cloud session starts and ends.
Review:
|
Boundary |
|---|
|
Initial site visit |
|
Login |
|
Logout |
|
Authentication timeout |
|
Browser inactivity |
|
Session timeout |
|
Identity transition |
|
Multiple browser tabs |
A new authenticated user should not inherit activity from a previous user on a shared device.
⏰ Configure session timeout
By default, GermainUX closes an ongoing session after one hour without receiving a new event.
To change the timeout:
-
Go to Workspace > Settings > System > UX and Session Replay Settings.
-
Update Session Timeout, in minutes.
-
Save the configuration.
Choose a value that reflects normal Experience Cloud usage without fragmenting one journey into multiple sessions.
🎞️ Configure Session Replay
Session Replay is enabled by default for each UX Monitoring Profile unless it is disabled at the profile or global level.
To enable or disable it for this site:
-
Open the Experience Cloud UX Monitoring Profile.
-
Enable or disable Session Replay Monitoring.
-
Save the profile.
To disable replay globally:
-
Go to Workspace > Settings > System > UX and Session Replay Settings.
-
Disable Session Replay Data.
-
Save the configuration.
The global setting takes precedence over profile-level settings.
Disabling replay does not necessarily disable other Real User Monitoring data.
🔒 Configure privacy
Review every standard and custom Experience Cloud component that can display confidential information.
Mask, anonymize, or exclude:
|
Item |
|---|
|
Passwords |
|
Authentication tokens |
|
Session identifiers |
|
Customer and partner information |
|
Names and contact details |
|
Case descriptions |
|
Account and order information |
|
Payment data |
|
Protected health information |
|
Attachments |
|
Search terms |
|
Form fields |
|
User-feedback comments |
|
Custom Lightning Web Component content |
Apply privacy rules to:
-
Visible text
-
Input values
-
Tables and lists
-
Popup dialogs
-
URLs
-
Request and response bodies
-
Session metadata
-
Session Replay
Test privacy with guest users and every relevant authenticated user type.
🚫 Exclude bots and automated traffic
Exclude automated user agents so they do not affect user, adoption, conversion, or performance analytics.
Common exclusions include:
|
Type |
|---|
|
Search-engine crawlers |
|
Social-media preview bots |
|
Synthetic users |
|
Selenium tests |
|
Load-testing agents |
|
Health checks |
|
Service accounts |
|
Organization-specific bots |
Do not exclude a user agent shared by legitimate visitors.
💬 Configure User Feedback
Enable the GermainUX Feedback Popup to let users provide feedback directly from the site.
Feedback can include:
|
Type |
|---|
|
Positive or negative response |
|
Written comment |
|
Rating |
|
Survey response |
|
NPS response |
|
Site, page, application, and session context |
Configure:
-
Popup visibility
-
Labels and appearance
-
Position
-
Question or prompt
-
Comment field
-
User targeting
-
Triggering conditions
-
Privacy controls
-
Alerting and ownership
See User Feedback for Salesforce Experience Cloud.
📋 Configure business-process monitoring
Define critical Experience Cloud journeys such as:
|
Journey |
|---|
|
Registration |
|
Login |
|
Customer onboarding |
|
Case creation |
|
Knowledge search |
|
Partner lead submission |
|
Order or application submission |
|
Profile update |
|
Password reset |
|
Self-service support |
For each process, configure:
-
Start condition
-
Steps
-
Completion condition
-
Failure condition
-
Correlation identifier
-
Expected duration
-
Step thresholds
-
Timeout
-
User and business dimensions
GermainUX can identify slow steps, overruns, drop-offs, repeated activity, unexpected paths, errors, and lost customer effort.
See Business Process and Workflow Mining.
🐛 Configure error monitoring
Collect and classify:
|
Category |
|---|
|
JavaScript errors |
|
Console events |
|
Failed network requests |
|
User-facing application errors |
|
Silent application errors |
|
Expected user validations |
|
Salesforce API failures |
|
Apex exceptions |
|
Integration errors |
Separate application failures from expected validation feedback.
|
Category |
Meaning |
|---|---|
|
User-facing application error |
Software failure displayed to the user |
|
Silent application error |
Software failure not displayed to the user |
|
User validation |
Expected feedback preventing invalid input or action |
|
Technical warning |
Recoverable technical condition that may not affect users |
Correlate each error with the affected session, page, user group, business-process step, and available server-side evidence.
🚤 Configure performance monitoring
Review capture and analysis for:
-
Page and route changes
-
User clicks
-
Browser transactions
-
Network requests
-
JavaScript execution
-
Third-party services
-
Salesforce endpoints
-
Custom Lightning components
-
Complete user journeys
Use percentiles in addition to averages so slow experiences affecting a subset of users remain visible.
🖥️ Configure Salesforce platform monitoring
Deploy and configure the GermainUX Engine when server-side Salesforce monitoring is required.
Available monitoring can include:
-
Salesforce API activity
-
Event Monitoring logs
-
Real-Time Event Monitoring
-
Apex and Flow information
-
Debug logs
-
Audit events
-
Resource usage
-
Platform Event usage
-
Instance status
-
Errors and exceptions
See:
🤖 Configure synthetic monitoring
Create synthetic scenarios for critical Experience Cloud workflows.
Configure:
-
Selenium scenario
-
Execution Engine
-
Execution location
-
Synthetic account
-
Credentials
-
Safe test data
-
Schedule
-
Timeout
-
Step measurements
-
Success assertions
-
Cleanup
-
SLA thresholds
-
Alerts
Run several successful unattended tests before enabling recurring execution.
🔬 Configure the JS Profiler
Use the JS Profiler for targeted troubleshooting when RUM identifies a browser-side issue requiring deeper evidence.
Limit profiling by:
-
Site and environment
-
User or group
-
Browser or computer
-
Page or component
-
Script
-
Time period
The profiler captures browser-side JavaScript, network, and execution data. It does not directly profile server-side Apex code.
📈 Configure KPIs and SLAs
After verifying data collection, enable the required Experience Cloud KPIs.
For each critical KPI:
-
Confirm that data is received.
-
Select the appropriate measure.
-
Establish a baseline.
-
Configure warning and critical thresholds.
-
Select an evaluation period.
-
Configure alert conditions.
-
Assign an owner.
-
Add diagnostic or corrective actions.
-
Define maintenance periods.
-
Test alert creation and recovery.
See KPIs for Salesforce Experience Cloud.
🔔 Configure alerts and automation
Alerts can be triggered by:
-
Site unavailability
-
Synthetic journey failure
-
Performance degradation
-
Error-volume increase
-
New error category
-
Business-process overrun
-
Drop-off increase
-
Negative user feedback
-
Salesforce API or instance problem
Responses can include:
-
Email, SMS, or Slack notification
-
ServiceNow incident
-
Diagnostic collection
-
HTTP request
-
Script execution
-
Scheduled report
-
Approved corrective action
-
Recovery validation
Limit automatic remediation to explicit, approved, tested, and reversible actions.
✅ Validate the configuration
Real User Monitoring
Confirm that:
-
The correct site and environment are assigned.
-
Guest and authenticated identities are handled correctly.
-
Pages, clicks, and requests are captured.
-
Errors appear under the intended KPIs.
-
Bot traffic is excluded.
Session Replay
Confirm that:
-
Replay reconstructs the expected journey.
-
User interactions appear in order.
-
Errors and workflow events are included.
-
Sensitive content is protected.
-
Logout or identity transition ends the appropriate session.
Feedback and business processes
Confirm that:
-
Feedback retains site and session context.
-
Business-process instances start and finish correctly.
-
Steps and durations are accurate.
-
Failures, timeouts, and drop-offs are classified correctly.
Server-side monitoring
Confirm that:
-
The Engine is online.
-
Salesforce authentication succeeds.
-
API, log, event, capacity, and instance data appear as configured.
-
Browser and server-side events can be correlated.
Alerts
Confirm that:
-
SLA violations generate the intended notification.
-
Maintenance periods suppress expected alerts.
-
Recovery closes the alert.
-
Alert links open the correct analysis context.
✅ Configuration checklist
Before production rollout, verify that:
-
The site URL matches the intended profile.
-
RUM JS loads only once.
-
Guest and authenticated identities are correct.
-
Session timeout is appropriate.
-
Session Replay is configured as intended.
-
Privacy rules have been tested.
-
Bots and synthetic users are excluded.
-
Feedback has an owner.
-
Critical journeys are configured.
-
Error categories are meaningful.
-
Expected KPIs receive data.
-
SLAs and alerts have been tested.
-
Synthetic scenarios use safe credentials and data.
-
Automatic actions have appropriate safeguards.
📚 Related documentation
ℹ️ Get More Information
GermainUX can help determine which monitoring, analytics and automation capabilities are appropriate for your Salesforce Experience Cloud environment.
Component: Engine, JS Profiler, Mobile App, RPA Bot Recorder, RUM JS
Feature Availability: 2018.1 or later