VitalSentinel
Help

Troubleshooting

Solutions to common issues with VitalSentinel monitoring and scripts.

This guide covers common issues and their solutions. If you can't find your answer here, contact support.

Script Issues

RUM Script Not Loading

See RUM Script Installation for setup instructions.

Symptoms:

  • No RUM data appearing in dashboard
  • Script not visible in Network tab

Solutions:

  1. Check installation

    • Verify script is in <head> section
    • Ensure data-key is correct
    • Confirm async attribute is present

  2. Check for blockers

    • Disable ad blockers temporarily
    • Check Content Security Policy headers
    • Test in incognito mode

  3. Verify domain

    • Tracking ID must match your domain
    • Check for typos in the domain URL

  4. Test locally

    • Add data-debug="true" to script
    • Check console for [VitalSentinel RUM] messages

Web Analytics Script Not Tracking

See Web Analytics Script Installation for setup instructions.

Symptoms:

  • No pageviews in Web Analytics
  • Events not appearing

Solutions:

  1. Same checks as RUM (above)

  2. Check consent settings

    • Default storage is "none" (no persistence)
    • May need to call grantConsent() for returning visitor tracking

  3. SPA navigation

    • Verify SPA detection is working
    • Try data-spa="true" explicitly
    • Or call trackPageView() manually

E-commerce Not Auto-Detecting

See Web Analytics for supported platforms and setup.

Symptoms:

  • Platform not detected
  • E-commerce events not tracked

Solutions:

  1. Verify platform

    • Check window.VitalSentinelAnalytics.getDebug().ecommercePlatform
    • Ensure you're on a supported platform

  2. Platform-specific

    • Shopify: Check window.Shopify exists
    • WooCommerce: Check for WooCommerce body classes
    • Ensure checkout pages are accessible

  3. Timing issues

    • Script may load before platform objects
    • Try adding script after platform scripts

No Data Appearing

RUM Data Missing

Symptoms:

  • Dashboard shows no RUM metrics
  • Core Web Vitals empty

Timeline:

  • Initial data: 15-30 minutes after installation
  • Full metrics: May take 24 hours for complete picture

Solutions:

  1. Wait for data

    • Visit your site to generate traffic
    • Wait 15-30 minutes
    • Refresh the dashboard

  2. Check sample rate

    • Default is 1.0 (100%)
    • If set lower, you need more traffic

  3. Verify script execution

    • Check browser console for errors
    • Enable debug mode
    • Confirm network requests are sent

Uptime Data Missing

See Uptime Monitoring for configuration details.

Symptoms:

  • No uptime status shown
  • "No data" message

Solutions:

  1. Domain accessibility

    • Verify domain is publicly accessible
    • Check for firewall blocking
    • Confirm DNS is resolving

  2. Check interval

    • Wait for at least one check cycle
    • 5-minute interval = wait 5 minutes

  3. SSL issues

    • Invalid SSL may cause check failures
    • Verify certificate is valid

CrUX Data Missing

See CrUX Monitoring for more about how CrUX works.

Symptoms:

  • CrUX shows "No data available"

Solutions:

  1. Traffic requirements

    • CrUX requires significant Chrome traffic
    • Low-traffic sites may not have data

  2. Data availability

    • CrUX updates monthly
    • New sites may take 28+ days

  3. URL specificity

    • Try origin-level data instead of URL-level
    • Popular pages have better coverage

Performance Issues

Slow Dashboard Loading

Symptoms:

  • Dashboard takes long to load
  • Metrics loading slowly

Solutions:

  1. Reduce time range

    • Shorter periods load faster
    • Try "Last 7 days" instead of "Last 90 days"

  2. Browser issues

    • Clear browser cache
    • Try incognito mode
    • Test different browser

High Latency in Reports

Solutions:

  1. Reduce complexity

    • Fewer metrics per view
    • Smaller date ranges

  2. Check connection

    • Slow internet affects loading
    • Try from different network

Alert Issues

See Setting Up Alerts and Notifications for configuration details.

Not Receiving Alerts

Symptoms:

  • Alerts trigger but no notification
  • Email not received

Solutions:

  1. Check email settings

    • Verify email is enabled in Email Preferences (Settings → Emails)
    • Check spam/junk folder
    • Confirm email address is correct

  2. Check alert configuration

    • Verify alert is enabled
    • Check if "Send email" is enabled for the specific alert
    • Ensure threshold conditions are correct

  3. Check conditions

    • Verify condition is actually met
    • For Synthetic alerts, check evaluation window settings
    • View alert history in dashboard

Too Many Alerts

Symptoms:

  • Alert fatigue
  • Constant notifications

Solutions:

  1. Adjust thresholds

    • Set more reasonable values
    • Account for normal variance

  2. For Synthetic alerts, increase evaluation window

    • Average over more tests (last 5 or 10) reduces noise
    • Only alert on sustained issues

  3. Review alert set

    • Remove redundant alerts
    • Disable alerts you don't need

Integration Issues

See Google Analytics and Google Search Console for integration setup.

Google Account Won't Connect

Symptoms:

  • OAuth fails
  • "Access denied" error

Solutions:

  1. Permissions

    • Ensure you have access to the property
    • Check you're using the right account

  2. Re-authorize

    • Disconnect and reconnect
    • Grant all requested permissions

  3. Third-party cookies

    • Enable cookies for OAuth flow
    • Try different browser

Google Data Not Syncing

Symptoms:

  • GA4 or GSC data not appearing
  • Stale data

Solutions:

  1. Check connection

    • Verify integration is connected
    • Re-authorize if expired

  2. Property linking

    • Ensure correct property is linked
    • GA4 (not UA) for Analytics

  3. Data delays

    • GA4: Up to 24 hours
    • GSC: 2-3 days delay

Account Issues

Can't Log In

Solutions:

  1. Password reset

    • Use "Forgot password" link
    • Check email for reset link

  2. 2FA issues

    • Use backup codes
    • Contact support for recovery

  3. Email verification

    • Check for verification email
    • Resend verification

Locked Out of Account

Solutions:

  1. Wait and retry

    • Too many attempts triggers lockout
    • Wait 15-30 minutes

  2. Password reset

    • Reset password to unlock

  3. Contact support

    • If persistent issues

Still Need Help?

If you can't resolve your issue:

  1. Check FAQs - FAQ Page
  2. Contact Support - Through the in-app support widget
  3. Email - support@vitalsentinel.com

When contacting support, include:

  • Domain name
  • Browser and version
  • Steps to reproduce
  • Screenshots if applicable
  • Error messages

FAQ

Frequently asked questions

Glossary

Technical terms explained

Data & Privacy

Data collection and privacy information

Billing & Plans

Manage your subscription, view usage, and understand plan features.

FAQ

Frequently asked questions about VitalSentinel.

On this page

Script IssuesRUM Script Not LoadingWeb Analytics Script Not TrackingE-commerce Not Auto-DetectingNo Data AppearingRUM Data MissingUptime Data MissingCrUX Data MissingPerformance IssuesSlow Dashboard LoadingHigh Latency in ReportsAlert IssuesNot Receiving AlertsToo Many AlertsIntegration IssuesGoogle Account Won't ConnectGoogle Data Not SyncingAccount IssuesCan't Log InLocked Out of AccountStill Need Help?Related