RUM Troubleshooting Guide

Overview

This guide will help you resolve common issues you may encounter when using Flashduty RUM, including data collection anomalies, SDK configuration problems, and performance optimization. This guide ensures the normal operation of RUM monitoring.

Data Collection Verification

If you don't see data in the RUM platform, check the following steps:

SDK Installation Check

Verify script inclusion: Confirm that the RUM SDK is correctly included:

Or npm initialization method:

Check console: Open browser developer tools and check for JavaScript errors.

Verify configuration: Confirm that the application ID and client token are correct.

Network Request Check

Open the browser developer tools network panel

Filter for browser.flashcat.cloud requests

Confirm requests are sent successfully (status code 200)

If requests fail, check specific error messages

Browser Compatibility

Confirm your browser version is supported:

Chrome 60 and above

Firefox 60 and above

Safari 12 and above

Edge 15 and above

Internet Explorer 11 (some features limited)

Ad Blocker Impact

Some ad blocker plugins may affect RUM SDK operation. Recommendations:

Temporarily disable ad blockers for testing

Whitelist your domain and browser.flashcat.cloud

Common Issue Resolution

No Data Displayed

Issue: SDK configuration is complete, but no data appears on the platform.

Solution:

Wait for data synchronization: Data typically appears within 5 minutes

Check initialization: Ensure the SDK is initialized when the page loads

Check sampling rate: Confirm the sampling rate is set appropriately:

Check user authorization: Confirm user tracking consent status:

Missing Behavior Data

Issue: User behavior data is incomplete.

Solution:

Enable behavior tracking: Confirm behavior tracking configuration:

Check element marking: Add behavior markers for custom elements:

Manual behavior recording: For complex interactions, use manual recording:

Missing Error Data

Issue: JavaScript exceptions are not recorded.

Solution:

Enable error tracking: Confirm error tracking configuration:

Error handling optimization: Ensure exceptions can be captured by the SDK:

Configure source maps: Helps locate issues in production environments

Performance Issues

Issue: Concerns about RUM SDK affecting website performance.

Solution:

Optimize configuration: Only enable necessary features:

Adjust sampling rate: Adjust sampling based on traffic:

Resource filtering: Only track important resources:

CSP Configuration Issues

Issue: CSP policy blocks RUM SDK execution.

Solution:

Update script policy: Allow SDK loading:

script-src 'self' https://cdn.flashcat.cloud;

Update connection policy: Allow data reporting:

connect-src 'self' https://browser.flashcat.cloud;

Single Page Application Issues

Issue: Page visits in single page applications are not recorded.

Solution:

Manually record page visits:

Framework integration:

React Router integration:

Vue Router integration:

Advanced Debugging

Debug Mode

Enable debug mode for detailed logs:

Data Collection Testing

Force enable data collection for testing:

Network Analysis

Check data reporting requests:

Open developer tools

Switch to the network panel

Filter for browser.flashcat.cloud requests

View request data

Debug Commands

Debug commands available in the browser console:

Contact Technical Support

If you still have issues after following the above steps, please contact us:

Prepare the following information:

Application ID

Browser version

SDK version

Console error messages

Network request logs

Steps to reproduce the issue

Contact methods:

Email: support@flashcat.cloud

Technical support: contact-us@flashcat.cloud

Online consultation: Click the "Help" button in the bottom right corner of the platform

Frequently Asked Questions

Q: How long until data appears on the platform?

A: Usually within 2-5 minutes, with potential slight delays during peak periods.

Q: Are mobile browsers supported?

A: Mainstream browsers on iOS and Android are supported, but some advanced features may be limited.

Q: How do I exclude specific pages?

A: You can determine whether to initialize based on URL conditions:

Q: How do I track cross-domain users?

A: The following configuration is required:

Use the same application ID and client token

Set consistent user identifiers

Enable cross-domain tracking:

Q: How do I reduce data volume?

A: You can do this through:

Lowering the sampling rate

Disabling unnecessary features

Excluding specific pages

Configuring data masking

By following the troubleshooting steps in this guide, you can ensure Flashduty RUM operates normally, providing you with accurate user experience monitoring data.

FAQ

Overview#

Data Collection Verification#

SDK Installation Check#

Network Request Check#

Browser Compatibility#

Ad Blocker Impact#

Common Issue Resolution#

No Data Displayed#

Missing Behavior Data#

Missing Error Data#

Performance Issues#

CSP Configuration Issues#

Single Page Application Issues#

Advanced Debugging#

Debug Mode#

Data Collection Testing#

Network Analysis#

Debug Commands#

Contact Technical Support#

Frequently Asked Questions#

Q: How long until data appears on the platform?#

Q: Are mobile browsers supported?#

Q: How do I exclude specific pages?#

Q: How do I track cross-domain users?#

Q: How do I reduce data volume?#

Overview

Data Collection Verification

SDK Installation Check

Network Request Check

Browser Compatibility

Ad Blocker Impact

Common Issue Resolution

No Data Displayed

Missing Behavior Data

Missing Error Data

Performance Issues

CSP Configuration Issues

Single Page Application Issues

Advanced Debugging

Debug Mode

Data Collection Testing

Network Analysis

Debug Commands

Contact Technical Support

Frequently Asked Questions

Q: How long until data appears on the platform?

Q: Are mobile browsers supported?

Q: How do I exclude specific pages?

Q: How do I track cross-domain users?

Q: How do I reduce data volume?