Performance Issues

Resolve slow loading and performance issues with the Zenovay dashboard.

Dashboard Loading Slowly

Quick Fixes

1. Refresh the page (Ctrl+R or Cmd+R)
2. Clear browser cache (Ctrl+Shift+Delete)
3. Try a different browser (Chrome recommended)
4. Check your internet (speedtest.net)

Check Service Status

Before troubleshooting:

1. Visit status.zenovay.com
2. Check for ongoing incidents
3. If degraded, wait for resolution

Slow Data Loading

Reduce Date Range

Large date ranges load more data:

Date Range	Load Time
Today	Fast
Last 7 days	Fast
Last 30 days	Medium
Last 90 days	Slower
Last year	Slowest

Tip: Start with shorter ranges, expand as needed.

Disable Real-Time

Real-time updates consume resources:

1. Toggle off real-time in Live view
2. Data still updates on refresh
3. Reduces constant API calls

Simplify Filters

Complex filters slow queries:

• Fewer filters = faster loading
• Remove unnecessary filters
• Use one filter at a time to test

3D Globe Performance

Globe Slow or Laggy

The 3D Globe is GPU-intensive:

1. Reduce quality:

   • Click globe settings (gear icon)
   • Select "Performance Mode"
   • Disables some visual effects

2. Limit markers:

   • Fewer visible visitors
   • Shorter date range
   • Zoom to specific region

3. Close other tabs:

   • Free up GPU memory
   • Especially other WebGL content

Globe Not Loading

See 3D Globe Issues for detailed troubleshooting.

Use Table View

If globe too slow:

1. Switch to Table view
2. Same data, less GPU usage
3. Faster for data analysis

Chart Performance

Charts Rendering Slowly

Reduce data points:

• Use weekly instead of daily granularity
• Shorter date range
• Fewer comparison series

Disable animations:

• Less visual overhead
• Check your Profile settings
• Toggle "Chart Animations" off

Export Instead

For large datasets:

1. Export to CSV
2. Analyze in Excel/Sheets
3. Avoids rendering overhead

API/Data Performance

Slow API Responses

Typical response times:

Endpoint	Normal	Slow
Overview	<500ms	>2s
Sessions	<1s	>5s
Export	<5s	>30s

If consistently slow:

• Check your plan limits
• Rate limiting may apply
• Contact support if enterprise

Rate Limiting

When rate limited:

• Requests slow down
• 429 errors appear
• Wait before retrying

Check current usage in API Keys from the sidebar.

Memory Issues

Browser Using Too Much Memory

Symptoms:

• Browser slows down
• Tabs crashing
• System sluggish

Solutions:

1. Close unused tabs

2. Clear browsing data:

   • History
   • Cache
   • Cookies (for zenovay.com only)

3. Restart browser

4. Use fewer features:

   • Disable real-time
   • Use table instead of globe
   • Smaller date ranges

Session Storage Full

If browser storage full:

1. Open DevTools → Application
2. Check storage usage
3. Clear site data for zenovay.com

Network Issues

Slow Connection

Test your connection:

1. Visit speedtest.net
2. Minimum recommended: 5 Mbps
3. If slower, dashboard may lag

On slow connections:

• Use table views
• Disable real-time
• Export data for offline analysis

Firewall/Proxy Issues

Corporate networks may slow connections:

• VPN overhead
• Proxy latency
• Firewall inspection

Check with IT:

• Whitelist *.zenovay.com
• Allow WebSocket connections
• Direct route if possible

Device Performance

Older Devices

Minimum requirements:

• 4GB RAM
• Dual-core CPU
• Dedicated GPU (for globe)

On limited devices:

• Use table views
• Disable globe
• Shorter date ranges

Mobile Performance

Mobile browsers have limitations:

• Use responsive view
• Avoid globe on mobile
• Simpler interactions

Optimization Tips

Best Practices

1. Start narrow, expand:

   • Begin with today's data
   • Expand date range as needed

2. Use filters efficiently:

   • Filter before loading
   • Not after data loads

3. Bookmark common views:

   • Save filtered URLs
   • Skip repeated filtering

4. Schedule heavy operations:

   • Large exports off-peak
   • Complex queries during low usage

Dashboard Settings

Profile preferences:

• Disable auto-refresh
• Reduce animation
• Choose default date range
• Select default view (table)

Tracking Script Performance

Script Impact on Your Site

Zenovay script is optimized:

• ~5KB gzipped
• Async loading (non-blocking)
• No render blocking
• Minimal CPU usage

Verify no impact:

1. Test with/without script
2. Measure Core Web Vitals
3. Should see no difference

If Script Seems Slow

<!-- Use defer for guaranteed non-blocking -->
<script defer
  data-tracking-code="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>

Debug Mode Performance

Debug mode logs extra data:

• Disable when not debugging
• Remove data-debug="true"
• Reduces console output

Monitoring Your Usage

Check Plan Limits

High usage can cause slowdowns:

1. Go to Settings → Usage
2. Check current vs limits
3. Upgrade if approaching limits

Data Retention Impact

More historical data = slower queries:

Plan	Retention	Query Speed
Free	1 year	Fastest
Pro	2 years	Fast
Scale	4 years	Medium
Enterprise	Custom	Varies

When to Contact Support

Contact support if:

• Dashboard consistently >10s load
• API timeouts frequently
• Performance degrades suddenly
• Enterprise with SLA concerns

Include:

1. Browser and version
2. Time of issue
3. Specific pages affected
4. Screenshot of Network tab
5. Your plan tier

Performance Checklist

□ Checked status.zenovay.com
□ Cleared browser cache
□ Tried different browser
□ Reduced date range
□ Disabled real-time
□ Simplified filters
□ Closed unnecessary tabs
□ Tested internet speed
□ Checked memory usage
□ Tried table view instead of globe

Next Steps

• Browser Compatibility
• 3D Globe Issues
• Dashboard Filtering