🔧 Troubleshooting
Common issues, agent problems, and how to resolve them.
Agent Not Reporting Data
When your Server Scout agent stops sending data to the dashboard, there are several potential causes to investigate. This guide will walk you through the systematic troubleshooting process to ident...
Server Showing as Offline
When your server appears as offline in the Server Scout dashboard, it typically indicates that our monitoring platform hasn't received data from your server agent within the expected reporting inte...
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 l...
Agent Auto-Update and Version Management
The Server Scout agent includes a robust auto-update mechanism that ensures your monitoring infrastructure stays current with the latest features, security patches, and bug fixes. This guide covers...
Understanding Data Gaps in Graphs
When monitoring your servers with Server Scout, you may occasionally notice gaps in your monitoring graphs. Understanding why these gaps appear and how they're handled is crucial for accurate syste...
Agent Data Spooling and Offline Recovery
## Overview Server Scout's agent includes a robust data spooling system designed to minimise data loss during network outages, server maintenance, or API unavailability. When the agent cannot reac...
Reading Agent Logs with journalctl
When troubleshooting Server Scout issues or monitoring your agent's performance, the systemd journal is your primary source of information. The Scout agent logs all its activities through systemd, ...
Force-Refreshing Agent Data Collection
The Server Scout agent collects metrics on different schedules—fast metrics every minute, medium metrics every five minutes, and slower metrics at longer intervals. Sometimes you'll need to force i...
Agent Resource Usage and Performance Impact
Server Scout is designed with a minimal footprint philosophy, ensuring your monitoring solution doesn't impact the very systems it's meant to observe. Understanding the agent's resource usage helps...
Troubleshooting Webhook Delivery Failures
When webhook notifications fail to deliver, it can leave you blind to critical server issues. This guide will help you diagnose and resolve common webhook delivery problems in Server Scout. ## Tes...
Resolving Browser Cache and Service Worker Issues
Server Scout's dashboard is built as a Progressive Web App (PWA) that uses service workers to cache static assets for lightning-fast loading and offline access. Whilst this provides an excellent us...
Diagnosing Unexpected Metric Values
When Server Scout displays metric values that seem unusual or incorrect, it's often due to how Linux systems report data or normal system behaviour that might appear concerning at first glance. Thi...
Why Am I Not Receiving Alert Emails?
When alert emails aren't arriving, it can leave you in the dark about critical server issues. This guide walks through the most common causes and solutions, starting with the most fundamental check...
Agent Installation Fails — Common Causes and Fixes
When the Server Scout agent installation fails, it's usually due to one of several common system configuration issues. This guide walks you through diagnosing and fixing the most frequent causes of...
Server Shows Offline After a Network Change
When your server shows as offline in Server Scout after a network change, it typically means the agent has lost connectivity to the dashboard. Network configuration changes such as IP address modif...
Fixing Stale or Incorrect Metric Values
When Server Scout displays stale or incorrect metric values, there are several common causes and straightforward fixes. This guide walks you through diagnosing and resolving the most frequent issue...