跳转到主要内容

​
Overview

This guide helps you resolve common issues you may encounter when using Flashduty RUM, including data collection anomalies, SDK configuration issues, and performance optimization.

​
Data Collection Verification

If you don’t see data on the RUM platform, follow these steps to check.

​
SDK Installation Check

1

Check Script Import

Confirm that the RUM SDK is correctly imported:
<script
  src="https://static.flashcat.cloud/browser-sdk/v0/flashcat-rum.js"
  type="text/javascript"
></script>
<script>
  window.FC_RUM &&
    window.FC_RUM.init({
      applicationId: "Your Application ID",
      clientToken: "Your Client Token",
      service: "<SERVICE_NAME>",
      env: "<ENV_NAME>",
      version: "1.0.0",
      sessionSampleRate: 10
    });
</script>
2

Check Console

Open browser developer tools (F12) and check if there are JavaScript errors in the Console panel.
3

Verify Configuration

Confirm that the application ID and client token match the configuration in the RUM console.

​
Network Request Check

  1. Open the browser developer tools Network panel
  2. Filter requests for browser.flashcat.cloud
  3. Confirm the request status code is 200
  4. If the request fails, check the specific error message
If you see CORS errors, check if your CSP configuration is correct.

​
Browser Compatibility

Confirm that your browser version is supported:
BrowserMinimum Version
Chrome60+
Firefox60+
Safari12+
Edge15+
Internet Explorer11 (limited functionality)

​
Ad Blocker Impact

Some ad blocking extensions may block the RUM SDK from running. We recommend adding your domain and browser.flashcat.cloud to the whitelist.

​
Common Problem Solutions

Problem: SDK configuration is complete, but no data on the platform.Solutions:
  1. Wait for Data Sync: Data typically appears within 2-5 minutes
  2. Check Initialization Timing: Ensure SDK is initialized when the page loads
  3. Check Sampling Rate: Confirm sampling rate is set appropriately 
flashcatRum.init({
  // ... other configuration
  sessionSampleRate: 100  // Set to 100 to collect all sessions
});
  1. Check User Consent: Confirm user tracking consent status
flashcatRum.setTrackingConsent("granted");
Problem: User behavior data is incomplete.Solutions:
  1. Enable Behavior Tracking:
flashcatRum.init({
  // ... other configuration
  trackUserInteractions: true
});
  1. Add Labels to Custom Elements:
<button data-action-name="Submit Form">Submit</button>
  1. Manually Record Complex Interactions:
flashcatRum.addAction("click", "Custom Button Click");
Problem: JavaScript exceptions are not being recorded.Solutions:
  1. Enable Exception Tracking:
flashcatRum.init({
  // ... other configuration
  trackErrors: true
});
  1. Manually Report Exceptions in try-catch:
try {
  // Code that might error
} catch (error) {
  console.error(error);
  flashcatRum.addError(error);
}
  1. Configure Source Map: For locating issues in production, see Source Mapping
Problem: Concerned about RUM SDK affecting website performance.Solutions:
  1. Only Enable Necessary Features:
flashcatRum.init({
  // ... other configuration
  trackResources: true,
  trackLongTasks: false,  // Disable unnecessary features
  trackErrors: true,
  trackUserInteractions: true
});
  1. Adjust Sampling Rate:
flashcatRum.init({
  // ... other configuration
  sessionSampleRate: 50  // Only collect 50% of sessions
});
  1. Filter Non-Critical Resources:
flashcatRum.init({
  // ... other configuration
  beforeSend: (event) => {
    // Filter out non-critical resources
    if (event.type === 'resource' && event.resource.url.includes('/static/')) {
      return false;
    }
    return true;
  }
});
Problem: CSP policy blocking RUM SDK from running.Solution:Add the following rules to your CSP configuration:
script-src 'self' https://static.flashcat.cloud;
connect-src 'self' https://browser.flashcat.cloud;
Problem: Route changes in SPA applications are not being recorded.Solutions:
import { useEffect } from "react";
import { useLocation } from "react-router-dom";

function RumRouteTracker() {
  const location = useLocation();

  useEffect(() => {
    flashcatRum.startView({
      name: location.pathname,
      url: location.pathname + location.search
    });
  }, [location]);

  return null;
}

// Use in App component
function App() {
  return (
    <Router>
      <RumRouteTracker />
      {/* Other routes */}
    </Router>
  );
}

​
Advanced Debugging

​
Enable Debug Mode

Enable debug mode to get detailed logs in the console: 
flashcatRum.init({
  // ... other configuration
  debug: true
});

​
Force Full Data Collection

Force full data collection during testing: 
flashcatRum.init({
  // ... other configuration
  sessionSampleRate: 100,
  sessionReplaySampleRate: 100
});
Do not use 100% sampling rate in production to avoid generating excessive data and costs.

​
Console Debug Commands

The following commands can be used in the browser console: 
// Get RUM internal context
window.FC_RUM.getInternalContext();

// Get current session ID
window.FC_RUM.getSessionId();

// Get current page ID  
window.FC_RUM.getViewId();

// Manually send test event
window.FC_RUM.addAction('test', 'debug_action');

​
Network Request Analysis

  1. Open developer tools Network panel
  2. Filter browser.flashcat.cloud requests
  3. View request Payload to confirm data content
  4. Check Response to confirm successful reporting

​
FAQ

Generally within 2-5 minutes, with possible slight delays during peak times.
Yes, mainstream mobile browsers like iOS Safari and Android Chrome are supported, but some advanced features (like Long Tasks monitoring) may be limited.
You can conditionally decide whether to initialize based on URL:
// Exclude admin pages
if (!window.location.pathname.startsWith("/admin")) {
  flashcatRum.init({
    // ... configuration
  });
}
The following configuration is needed:
  1. Use the same application ID and client token
  2. Set consistent user identification
  3. Enable cross-domain tracking:
flashcatRum.init({
  // ... other configuration
  allowedTracingUrls: [
    "https://example.com",
    "https://app.example.com",
    "https://shop.example.com"
  ]
});
You can do the following:
  1. Lower Sampling Rate: Set sessionSampleRate to 10-50
  2. Disable Unnecessary Features: Such as trackLongTasks: false
  3. Exclude Specific Pages: Don’t initialize on admin or internal pages
  4. Configure Data Filtering: Use beforeSend to filter non-critical data

​
Contact Technical Support

If you still have issues after following the above troubleshooting steps, please contact our technical support team.
1

Prepare Diagnostic Information

Please collect the following information:
  • Application ID
  • Browser type and version
  • SDK version
  • Console error screenshots
  • Network panel request screenshots
  • Problem reproduction steps
2

Contact Support

  • Email: support@flashcat.cloud
  • Online Chat: Click the “Help” button in the bottom right corner of the platform