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.

Use a Lighter View

Live View streams visitor activity continuously, which is the heaviest surface to keep open. If you only need the numbers:

1. Switch to the Analytics tab instead of leaving Live View open
2. Use the Refresh button when you need fresh data rather than watching it stream
3. Pick a shorter date range so each load pulls less data

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. To ease the load:

1. Show fewer markers:

   • Use a shorter date range
   • Zoom in to a specific region

2. Close other tabs:

   • Free up GPU memory
   • Especially other WebGL content

3. Reload the globe:

   • Use the reload control in the top-right of the globe to reset its state

Globe Not Loading

See 3D Globe Issues for detailed troubleshooting.

Use the Analytics Tab Instead

If the globe stays slow, the same geographic data is available as plain tables and charts on the Analytics tab (Countries, Cities, and other breakdowns). It uses far less GPU and is faster for digging into the numbers.

Chart Performance

Charts Rendering Slowly

Reduce data points:

• Use weekly instead of daily granularity
• Shorter date range
• Turn off the comparison series

The chart's granularity (hourly, daily, weekly) switches right on the chart, and the "vs previous" comparison is a toggle next to it on the chart, so you can adjust both without leaving the page.

Export Instead

For large datasets (CSV export is available on the Pro plan and above):

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

API/Data Performance

This section applies to the programmatic REST API, which is available on the Pro plan and above.

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 your current API request usage under Settings → Advanced (Plan limits & usage). Manage the keys themselves under Settings → Security → API Keys.

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:

   • Avoid leaving Live View streaming
   • Use the Analytics tab instead of the 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 the Analytics tab instead of the globe
• Avoid leaving Live View streaming
• Export data for offline analysis (Pro plan and above)

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 the Analytics tab instead of the globe
• Avoid the globe tab
• Shorter date ranges

Mobile Performance

Mobile browsers have limitations:

• The dashboard adapts to smaller screens automatically
• Avoid the globe on mobile
• Keep interactions simple

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

Account Preferences

Your personal preferences live under Settings → Account → Preferences (for example time format and identifier blur for screenshots). There is no setting that changes loading speed directly, so the biggest wins are the date-range, view, and filter choices above.

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 → Advanced (Plan limits & usage)
2. Check current usage against your plan limits
3. Upgrade if you're approaching the 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
□ Avoided leaving Live View streaming
□ Simplified filters
□ Closed unnecessary tabs
□ Tested internet speed
□ Checked memory usage
□ Tried the Analytics tab instead of the globe

Next Steps

• Browser Compatibility
• 3D Globe Issues
• Dashboard Filtering