Troubleshooting Scans
Auto-Pause
How Scanopy automatically pauses scheduled scans after repeated stall failures.
Auto-pause is a safeguard that automatically disables a scheduled scan after it fails three times in a row due to session stalls. This prevents scans from repeatedly running against daemons that are offline, uninstalled, or otherwise unable to complete work.
How it works
- Each scheduled discovery tracks a
consecutive_failurescounter. - When a scan session stalls (no progress for 5 minutes), the server terminates it as "Failed" and increments the counter.
- When the counter reaches 3, the scheduled discovery is automatically disabled ("auto-paused") and the cron job is removed from the scheduler.
- The organization owner receives an email notification explaining the pause and linking to daemon troubleshooting.
- When a scan completes successfully, the counter resets to 0.
Only stall failures count toward auto-pause. Daemon-reported errors and user-initiated cancellations do not increment the counter.
Common causes
- Daemon offline or uninstalled — the daemon is no longer running on the target machine.
- Network unreachable — the daemon cannot reach the target network or subnets.
- Daemon overloaded — the daemon is unable to respond to session requests within the 5-minute timeout.
How to troubleshoot
- Navigate to Daemons and check the status of the daemon assigned to the failing scan.
- If the daemon shows as "Standby" or "Unreachable", the daemon process may need to be restarted or reinstalled on the target machine.
- Verify network connectivity from the daemon host to the scan targets.
- Check daemon logs for errors. See Checking Daemon Logs for platform-specific instructions.
How to unpause
- Navigate to Discoveries and find the auto-paused scan (shown with a red "Auto-paused" tag).
- Click the Power icon on the card to re-enable the scan, or open the scan's edit modal and toggle the Enabled switch.
- Re-enabling resets the failure counter to 0 and re-adds the cron job to the scheduler.
Before re-enabling, ensure the underlying issue (daemon offline, network unreachable) has been resolved — otherwise the scan will be auto-paused again after 3 more stall failures.