Dashboard Loading Issues

Server Scout's dashboard is designed as a progressive web app (PWA) that provides reliable monitoring even when network conditions are poor. However, this offline-first architecture can sometimes lead to loading issues when cached data becomes stale or conflicts with updated content. This guide will help you troubleshoot and resolve common dashboard loading problems.

Understanding the PWA Architecture

Server Scout's dashboard uses a service worker to cache resources and monitoring data, enabling it to function offline with previously loaded information. While this ensures continuity during network interruptions, it can occasionally cause issues when the cached content doesn't align with server updates or when the service worker encounters problems.

Basic Troubleshooting Steps

1. Perform a Hard Refresh

The quickest solution for most dashboard loading issues is to perform a hard refresh, which bypasses the browser cache and service worker:

• Windows/Linux: Press Ctrl + Shift + R
• macOS: Press Cmd + Shift + R

This forces the browser to fetch fresh resources from the server rather than relying on cached versions.

2. Clear Browser Cache and Data

If a hard refresh doesn't resolve the issue, you'll need to clear the browser's stored data:

Chrome/Edge

1. Press F12 to open Developer Tools
2. Right-click the refresh button while Developer Tools is open
3. Select "Empty Cache and Hard Reload"

Alternatively:

1. Navigate to Settings → Privacy and Security → Clear browsing data
2. Select "All time" as the time range
3. Ensure "Cached images and files" and "Cookies and other site data" are selected
4. Click "Clear data"

Firefox

1. Go to Settings → Privacy & Security
2. Under "Cookies and Site Data", click "Clear Data"
3. Select both options and click "Clear"

Safari

1. Go to Safari → Preferences → Privacy
2. Click "Manage Website Data"
3. Search for "serverscout.ie" and remove all entries

3. Check for Browser-Specific Issues

To determine if the problem is browser-specific:

1. Open Server Scout in an incognito/private browsing window
2. Try accessing the dashboard in a different browser
3. Test on another device if available

If the dashboard loads correctly in incognito mode or a different browser, the issue is likely related to cached data or browser extensions in your primary browser.

Session and Authentication Issues

Verify Login Session Status

Dashboard loading problems can occur when your login session has expired but the service worker continues attempting to load cached content:

1. Look for any authentication prompts or error messages
2. Try logging out completely and logging back in
3. Check if you can access other areas of the Server Scout interface

If you're redirected to the login page or receive authentication errors, simply log in again to establish a fresh session.

Clear Authentication Cookies

Sometimes authentication tokens can become corrupted:

1. Open your browser's Developer Tools (F12)
2. Navigate to the Application/Storage tab
3. Under "Cookies", find the Server Scout domain
4. Delete all cookies related to authentication
5. Refresh the page and log in again

API Connectivity Issues

Check API Response Status

If the dashboard appears to load but displays no data or shows error messages:

1. Open Developer Tools (F12)
2. Go to the Network tab
3. Refresh the dashboard
4. Look for failed requests (marked in red) to API endpoints
5. Check the status codes of API responses

Common issues include:

• 502/503 errors: Server temporarily unavailable
• 401 errors: Authentication problems
• Timeout errors: Network connectivity issues

Test Direct API Access

You can verify API functionality by testing a simple endpoint:

curl -H "Authorization: Bearer YOUR_TOKEN" https://app.serverscout.ie/v1/status

Replace YOUR_TOKEN with your actual API token from the dashboard settings.

Advanced Troubleshooting

Reset Service Worker

If problems persist, you may need to manually reset the service worker:

1. Open Developer Tools (F12)
2. Go to the Application tab
3. Select "Service Workers" from the left sidebar
4. Find the Server Scout service worker
5. Click "Unregister"
6. Refresh the page to re-register the service worker

Disable PWA Features Temporarily

To test if PWA functionality is causing issues:

1. In Chrome, go to chrome://settings/content/notifications
2. Block notifications from Server Scout temporarily
3. Clear all site data as described above
4. Access the dashboard and test functionality

If these steps resolve your dashboard loading issues but problems recur, consider contacting Server Scout support with details about your browser version, operating system, and any error messages you've encountered.