Documentation

What Groundskeeper Watches

This page is also in the Groundskeeper wiki: https://github.com/rsjsoftwareltd/groundskeeper/wiki/What-Groundskeeper-Watches

Most alerts come from a connector, and every threshold a connector uses is a setting on its card under Connector Settings. This page lists them all, with the default each install starts on and the rule behind it, in the same words the Settings page uses.

Checks on machines running the RSJ Agent (BitLocker, Defender, pending restarts, disk space and more) are not listed here. Turn them on or off, and set their thresholds, under Agent Settings -> Monitoring policy.

Two things to know before reading it:

Settings that are not numbers -- which servers to watch, which services, credentials -- are not listed here; they choose what is watched rather than when it speaks.

Connectors #

Action1 #

Endpoint patch status, missing updates, device inventory

SettingDefaultThe rule
How oftenPoll interval (minutes)6060 minutes recommended.

Active Directory #

AD replication, FSMO roles, SYSVOL, sensitive group membership changes

SettingDefaultThe rule
How oftenPoll interval (minutes)6060 minutes recommended.

AD Account Health #

Service account password expiry and stale user accounts -- flags what SIMS sync failures are made of

SettingDefaultThe rule
ThresholdService account warn window (days)30Warn when a service account password expires within this many days. Critical at 7 days.
ThresholdStale user threshold (days)90Flag enabled user accounts with no logon in this many days.
ThresholdStale user alert count10Fire a warning when the number of stale accounts exceeds this count.
ThresholdScan timeout (seconds)300How long the AD account scan may run before it is abandoned. Raise it on a large directory; a scan that times out reports an error rather than partial results.
How oftenPoll interval (minutes)14401440 = once per day.

Adobe - Licence Usage #

Creative Cloud / Document Cloud product profile seat consumption -- warns when a profile approaches or exceeds its purchased quota

SettingDefaultThe rule
ThresholdWarning threshold (%)90Warn when consumed seats reach this percentage of the configured quota. Default 90%.
ThresholdReclaim: dormant threshold (days)90Flag an enabled AD account with a seat as a reclaim candidate if it hasn't logged on in this many days.
How oftenPoll interval (minutes)14401440 = once per day. Adobe's UMAPI rate limits are tight (a few requests per minute) -- daily polling is recommended, not more frequent.

Aruba Central (beta) #

Access point, switch and gateway health via Aruba Central's classic API Gateway. Beta: built from Aruba's API documentation and not yet tested against a live Aruba Central account -- tell us how it goes.

SettingDefaultThe rule
How oftenPoll interval (minutes)5How often to check device status. 5 minutes recommended.

Cisco Meraki #

Wi-Fi AP health, switch status, MT sensors

SettingDefaultThe rule
ThresholdSensor battery warning (%)20Warn when a Meraki environmental sensor's battery falls below this percentage.
ThresholdLength of an automatic upgrade window (minutes)45How long after the scheduled start a device is excused. An access point upgrades in 10-20 minutes; a switch stack takes longer. If a device is still down after this (plus the grace under Settings -> School -> Maintenance Windows), one real alert fires.
How oftenPoll interval (minutes)5How often to check device status. 5 minutes recommended.

Dell iDRAC #

Server hardware health via iDRAC Redfish API -- CPU, memory, storage, PSUs

SettingDefaultThe rule
How oftenPoll interval (minutes)1010 minutes recommended.

Devices Left On Overnight #

Flags client machines running for 14+ hours -- energy saving and security hygiene

SettingDefaultThe rule
ThresholdOvernight threshold (hours)14Flag devices running longer than this many hours. At 8am, 14h = machine running since 6pm yesterday.
ThresholdSkip inactive AD computers (days)30Skip computers with no AD logon in this many days.
ThresholdWMI timeout per machine (seconds)5Seconds to wait for each machine to respond via WMI. Machines that have not answered within four times this (minimum 20s) are counted as offline and the scan moves on -- otherwise one unreachable machine can hold up the whole run.
ThresholdMaximum machines per scan2000Safety cap on how many machines one scan will check. If your domain has more eligible machines than this, the shortfall is reported in the feed -- results are never presented as covering the whole estate when they do not. Narrowing the AD search base above to a single school's OU is usually better than raising this.
ThresholdScan time limit (seconds)1800Total time the scan may take. It stops collecting shortly before this and reports what it managed, along with how many machines it did not reach -- a partial answer that says how partial it is, rather than nothing at all.
How oftenCheck window start (hour, 24h)6Only scan between these hours (24h local time). Outside this window polls are skipped silently.
How oftenCheck window end (hour, 24h)10End of morning check window (exclusive). Default: scan runs 06:00-10:00.
How oftenPoll interval (minutes)240240 = every 4 hours. The actual scan only fires during the morning check window.

DNS & DHCP #

DHCP scope utilisation alerts and DNS resolution health checks

SettingDefaultThe rule
ThresholdScope warning threshold (% used)80Warn when a DHCP scope is more than this % full.
ThresholdScope critical threshold (% used)95Critical when a DHCP scope is more than this % full.
ThresholdFilling-fast warning window (minutes)60Warn when, at the rate seen recently, the free addresses would run out within this many minutes. Raise it to be warned earlier, lower it for fewer warnings.
ThresholdFill-rate measured over (minutes)60How far back to measure the fill rate. Shorter reacts faster but is noisier; readings less than 20 minutes apart are ignored as too short to measure honestly.
ThresholdConnection timeout (seconds)15Seconds before treating the DHCP server as unreachable.
How oftenPoll interval (minutes)1515 minutes recommended.

Domain Security #

SPF, DMARC, DKIM, TLS certs -- replaces NCSC Mail Check

SettingDefaultThe rule
How oftenPoll interval (minutes)14401440 = once per day.

Endpoint Reports #

Disk space and Windows 11 readiness scans via PowerShell

SettingDefaultThe rule
How oftenPoll interval (minutes)14401440 = once per day.

Exam Marking Software #

Detects teacher-side exam marking software on domain endpoints -- forewarns IT of exam season support demand

SettingDefaultThe rule
ThresholdSkip inactive AD computers (days)30Skip endpoints with no AD logon in this many days.
ThresholdPer-machine timeout (seconds)10How long to wait for each machine to answer before treating it as unreachable.
ThresholdScan timeout (seconds)3600Overall budget for the whole estate scan (3600 = one hour). Raise it on a large estate; a scan that times out reports an error rather than partial results.
How oftenPoll interval (minutes)1008010080 = once per week (recommended).

FortiGate (beta) #

Fortinet FortiGate firewalls: a unit offline, CPU and memory, and FortiGuard / FortiCare subscriptions running out -- read-only, over the FortiOS REST API. Beta: built from the API's documented replies, not yet run against a school's own units.

SettingDefaultThe rule
ThresholdWarn before a subscription expires (days)30Each FortiGuard and FortiCare subscription is warned about this many days before it expires, and again if it lapses.
ThresholdCPU warning (%)90Warn when a unit's CPU is at or above this on two polls running.
ThresholdMemory warning (%)90Warn when a unit's memory is at or above this on two polls running.
How oftenPoll interval (minutes)10How often each FortiGate is read.

HPE iLO (beta) #

HPE ProLiant server hardware health through each server's iLO: failed or predicted-to-fail disk drives, degraded RAID volumes, fans, power supplies, temperatures, memory and processors, plus the firmware list on the Devices page -- read-only, over Redfish (iLO 4 firmware 2.30 or later, and iLO 5). Beta: built from HPE's documented replies, not yet run against a school's own servers.

SettingDefaultThe rule
How oftenPoll interval (minutes)10How often each iLO is read. 10 minutes recommended.

Hyper-V #

VM state monitoring, replication health, VM count changes on Hyper-V hosts -- plus failover cluster node/storage checks when a cluster name is set

SettingDefaultThe rule
ThresholdCluster storage warning (% free)10Warn when a Cluster Shared Volume drops below this percentage free. Only used when a cluster name is set.
ThresholdConnection timeout (seconds)15Seconds before treating a host as unreachable.
How oftenPoll interval (minutes)55 minutes recommended.

Internet Health #

Outbound connectivity checks via HTTPS on port 443

SettingDefaultThe rule
ThresholdTimeout (seconds)10Alert if any endpoint takes longer than this.
How oftenPoll interval (minutes)55 minutes recommended.

M365 - Licence Usage #

Licence seat consumption -- warns when approaching or over purchased limit

SettingDefaultThe rule
ThresholdWarning threshold (%)95Warn when consumed seats reach this percentage of purchased seats. Default 95%.
How oftenPoll interval (minutes)6060 minutes recommended.

M365 - Service Health #

M365 service incidents and advisories via Microsoft Graph

SettingDefaultThe rule
How oftenPoll interval (minutes)1515 minutes recommended.

MIS Status #

Live status for Arbor (SIMS, Bromcom and SEEMiS have no readable public status page)

SettingDefaultThe rule
How oftenPoll interval (minutes)1010 minutes recommended.

Ping checks #

Pings devices on your network -- door controllers, cameras, switches -- and alerts when one stops answering

SettingDefaultThe rule
How oftenPoll interval (minutes)5How often to ping each device. Each check sends 3 pings.

Printers / MFDs #

Toner/ink levels, paper trays and error state for network printers via SNMP v2c

SettingDefaultThe rule
ThresholdToner/ink warning threshold (%)20Warn when toner or ink drops below this percentage.
ThresholdToner/ink critical threshold (%)10Critical alert when toner or ink drops below this percentage.
How oftenPoll interval (minutes)6060 minutes recommended -- toner levels change slowly.

Public SharePoint sites (beta) #

Flags Teams / Microsoft 365 groups (and their SharePoint sites) shared PUBLIC, via Microsoft Graph -- read-only, it never changes sharing. Beta: verified against the Graph docs, not yet against a live tenant.

SettingDefaultThe rule
How oftenPoll interval (minutes)1440A group's public/private status is slow-moving; daily (1440) is plenty.

School Services #

Uptime checks for common school cloud services: ParentPay, Wonde, RM Unify, Arbor and more

SettingDefaultThe rule
ThresholdTimeout (seconds)15Treat a service as down if it doesn't respond within this many seconds.
How oftenPoll interval (minutes)10How often to check each service.

SSL Certificates #

TLS certificate expiry monitoring -- alerts before certs expire

SettingDefaultThe rule
ThresholdWarn when expiring within (days)30Create a warning event when a certificate expires within this many days.
ThresholdCritical when expiring within (days)7Escalate to critical when a certificate expires within this many days.
How oftenPoll interval (minutes)14401440 = once per day.

Switches (SNMP) #

Port status, uplink vs device-port classification, interface errors and uptime for any managed switch via SNMP v2c -- tested on HP ProCurve and Aruba

SettingDefaultThe rule
ThresholdInterface error threshold (per poll)100Warn when an interface accumulates more than this many errors between polls.
ThresholdAlert unreachable after (consecutive failed polls)2How many polls in a row a switch must fail to answer SNMP before it is alerted as unreachable. SNMP runs over UDP, so a single lost packet is normal -- each poll already retries before it counts as a failure, and this waits for that many failed polls (2 recommended) so one blip never emails you. Set to 1 to alert on the first failed poll.
How oftenPoll interval (minutes)55 minutes recommended.

Synology NAS (beta) #

Synology NAS units: a storage pool or volume degraded or filling, a disk with a health warning, a DSM update waiting, and whether Hyper Backup and Active Backup for Business last worked -- read-only, over DSM's web API. Beta: built from documented and open-source reply shapes, not yet run against a school's own units.

SettingDefaultThe rule
ThresholdWarn when a backup has not succeeded for (days)2Each Hyper Backup and Active Backup for Business task is warned about if its last run failed, or if it has not succeeded in this many days.
ThresholdVolume full warning (%)85Warn when a volume is at or above this full.
How oftenPoll interval (minutes)15How often each NAS is read.

UPS #

Battery capacity, runtime, load and on-battery detection for APC and Eaton UPS units via SNMP v2c

SettingDefaultThe rule
ThresholdBattery warning threshold (%)40Warn when battery capacity falls below this percentage.
ThresholdBattery critical threshold (%)20Critical alert when battery capacity falls below this percentage.
ThresholdRuntime warning threshold (minutes)10Warn when estimated battery runtime falls below this many minutes.
ThresholdLoad warning threshold (%)80Warn when UPS output load exceeds this percentage of capacity.
ThresholdAlert unreachable after (consecutive failed polls)2How many polls in a row a UPS must fail to answer SNMP before it is alerted as unreachable. SNMP runs over UDP, so a single lost packet is normal -- each poll already retries, and this waits for that many failed polls (2 recommended) so one blip never emails you. Set to 1 to alert on the first failed poll.
How oftenPoll interval (minutes)55 minutes recommended.

Veeam #

Backup job status, failures, warnings -- supports Veeam B&R 12 and 13

SettingDefaultThe rule
How oftenPoll interval (minutes)3030 minutes recommended.

WatchGuard Endpoint #

AV/EDR coverage, unprotected endpoints, and security event activity

SettingDefaultThe rule
ThresholdCoverage warning threshold (%)95Warn when AV coverage drops below this percentage of enrolled endpoints. Above this, a few unprotected machines (rebuilds, new starters) are not reported -- set it higher, e.g. 99, if you want tighter cover.
ThresholdCoverage critical threshold (%)80Raise a CRITICAL alert when coverage drops below this percentage -- a systemic failure such as the agent having stopped deploying, rather than a few machines.
ThresholdWarn when an endpoint has not connected for (days)30Warn when endpoints listed in WatchGuard have not contacted it for this many days: retired computers still listed, or machines that are off or broken. Set to 0 to switch this off.
How oftenPoll interval (minutes)6060 minutes recommended.

WatchGuard Firebox #

Firewall reachability and BOVPN tunnel status via SNMPv3

SettingDefaultThe rule
ThresholdSNMP port161SNMP UDP port. Default is 161.
ThresholdSNMP timeout (seconds)5Seconds to wait for an SNMP response before treating the Firebox as unreachable.
How oftenPoll interval (minutes)55 minutes recommended.

Windows Clients #

Endpoint health for Windows 10/11 PCs -- BitLocker, pending reboots, AV, updates, disk

SettingDefaultThe rule
ThresholdSkip inactive AD computers (days)30Skip endpoints with no AD logon in this many days.
ThresholdWarn if pending reboot older than (days)7Critical alert when a pending reboot has been outstanding for this many days (KCSIE compliance).
ThresholdWarn if no update installed in (days)30Warn when no Windows Update has been installed in this many days.
ThresholdDisk warning threshold -- C: (% used)90Warn when C: is more than this percentage full.
ThresholdScan timeout (seconds)1800Overall budget for the domain-wide client scan (1800 = 30 minutes). Raise it on a large estate -- on roughly 2000 clients the default can be tight.
How oftenPoll interval (minutes)14401440 = once per day.

Windows Event Log #

Security events: account lockouts, failed logons, group changes

SettingDefaultThe rule
ThresholdLookback window (minutes)60How far back each poll looks. Should match poll interval.
ThresholdFailed logon burst threshold10Warn if a single account exceeds this many failed logons in the lookback window.
How oftenPoll interval (minutes)6060 minutes recommended.

Windows Servers #

CPU, RAM, disk, services and uptime for Windows Server infrastructure

SettingDefaultThe rule
ThresholdSkip inactive AD computers (days)90Skip computers with no AD logon in this many days. Set to 0 to include all.
ThresholdCPU warning threshold (%)85Alert if CPU stays above this % for two consecutive polls.
ThresholdRAM warning threshold (%)90Alert if RAM stays above this % for two consecutive polls, so a one-off burst is not reported. The warning clears once RAM is five points below this line, so a server hovering at it is one warning, not a new one every hour. CPU clears the same way.
ThresholdAlert unreachable after (consecutive failed polls)2A server must miss this many polls in a row before it is reported unreachable. 2 (the default, ten minutes at the usual interval) lets a reboot for Windows Update pass in silence -- the Devices page still shows it as unreachable meanwhile. Set 1 to be told on the first missed poll.
ThresholdDisk warning threshold (% used)90Warn when any fixed drive is more than this % full.
ThresholdDisk critical threshold (% used)95Critical alert when any fixed drive is more than this % full.
How oftenAutomatic re-discovery scheduleDailyHow often Groundskeeper automatically re-queries AD for new or removed servers.
How oftenPoll interval (minutes)55 minutes recommended for servers.

Last updated: 2026-10-21 (v0.193.1)