Troubleshooting Guide

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

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>

import { flashcatRum } from "@flashcatcloud/browser-rum";

flashcatRum.init({
  applicationId: "Your Application ID",
  clientToken: "Your Client Token",
  service: "<SERVICE_NAME>",
  env: "<ENV_NAME>",
  version: "1.0.0"
});

Check Console

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

Verify Configuration

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

Network Request Check

Open the browser developer tools Network panel
Filter requests for browser.flashcat.cloud
Confirm the request status code is 200
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:

Browser	Minimum Version
Chrome	60+
Firefox	60+
Safari	12+
Edge	15+
Internet Explorer	11 (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

Data Not Showing

Problem: SDK configuration is complete, but no data on the platform.Solutions:

Wait for Data Sync: Data typically appears within 2-5 minutes
Check Initialization Timing: Ensure SDK is initialized when the page loads
Check Sampling Rate: Confirm sampling rate is set appropriately

flashcatRum.init({
  // ... other configuration
  sessionSampleRate: 100  // Set to 100 to collect all sessions
});

Check User Consent: Confirm user tracking consent status

flashcatRum.setTrackingConsent("granted");

Missing Behavior Data

Problem: User behavior data is incomplete.Solutions:

Enable Behavior Tracking:

flashcatRum.init({
  // ... other configuration
  trackUserInteractions: true
});

Add Labels to Custom Elements:

<button data-action-name="Submit Form">Submit</button>

Manually Record Complex Interactions:

flashcatRum.addAction("click", "Custom Button Click");

Missing Exception Data

Problem: JavaScript exceptions are not being recorded.Solutions:

Enable Exception Tracking:

flashcatRum.init({
  // ... other configuration
  trackErrors: true
});

Manually Report Exceptions in try-catch:

try {
  // Code that might error
} catch (error) {
  console.error(error);
  flashcatRum.addError(error);
}

Configure Source Map: For locating issues in production, see Source Mapping

Performance Impact Concerns

Problem: Concerned about RUM SDK affecting website performance.Solutions:

Only Enable Necessary Features:

flashcatRum.init({
  // ... other configuration
  trackResources: true,
  trackLongTasks: false,  // Disable unnecessary features
  trackErrors: true,
  trackUserInteractions: true
});

Adjust Sampling Rate:

flashcatRum.init({
  // ... other configuration
  sessionSampleRate: 50  // Only collect 50% of sessions
});

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;
  }
});

CSP Configuration Issues

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;

SPA Page Views Not Recorded

Problem: Route changes in SPA applications are not being recorded.Solutions:

React Router
Vue Router
Manual Recording

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>
  );
}

router.afterEach((to) => {
  flashcatRum.startView({
    name: to.name || to.path,
    url: to.fullPath
  });
});

// Call when route changes
flashcatRum.startView({
  name: "Product Details Page",
  url: "/products/123"
});

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

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

FAQ

How long until data appears on the platform?

Generally within 2-5 minutes, with possible slight delays during peak times.

Are mobile browsers supported?

Yes, mainstream mobile browsers like iOS Safari and Android Chrome are supported, but some advanced features (like Long Tasks monitoring) may be limited.

How to exclude specific pages from monitoring?

You can conditionally decide whether to initialize based on URL:

// Exclude admin pages
if (!window.location.pathname.startsWith("/admin")) {
  flashcatRum.init({
    // ... configuration
  });
}

How to track users across multiple subdomains?

The following configuration is needed:

Use the same application ID and client token
Set consistent user identification
Enable cross-domain tracking:

flashcatRum.init({
  // ... other configuration
  allowedTracingUrls: [
    "https://example.com",
    "https://app.example.com",
    "https://shop.example.com"
  ]
});

How to reduce data volume and costs?

You can do the following:

Lower Sampling Rate: Set sessionSampleRate to 10-50
Disable Unnecessary Features: Such as trackLongTasks: false
Exclude Specific Pages: Don’t initialize on admin or internal pages
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.

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

Contact Support

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

首页

产品简介

通用配置

开发者

安全合规

更新日志

Overview

Data Collection Verification

SDK Installation Check

Network Request Check

Browser Compatibility

Ad Blocker Impact

Common Problem Solutions

Advanced Debugging

Enable Debug Mode

Force Full Data Collection

Console Debug Commands

Network Request Analysis

FAQ

Contact Technical Support

​Overview

​Data Collection Verification

​SDK Installation Check

​Network Request Check

​Browser Compatibility

​Ad Blocker Impact

​Common Problem Solutions

​Advanced Debugging

​Enable Debug Mode

​Force Full Data Collection

​Console Debug Commands

​Network Request Analysis

​FAQ

​Contact Technical Support

Overview

Data Collection Verification

SDK Installation Check

Network Request Check

Browser Compatibility

Ad Blocker Impact

Common Problem Solutions

Advanced Debugging

Enable Debug Mode

Force Full Data Collection

Console Debug Commands

Network Request Analysis

FAQ

Contact Technical Support