Browse documentation
Health checks and status monitoring
↩ Services
JOATOS can actively check whether a service is running and keep its status up to date automatically. This article covers the check types and how to turn monitoring on.
Turning on monitoring
On the service's detail page, edit it and tick Enable automatic monitoring. Choose a monitor type, then set the Monitor interval (seconds) — how often to check (default 60).
Check types
| Type | What it does | Requires |
|---|---|---|
| HTTP / HTTPS endpoint | Sends a GET request to the health-check URL | A reachable URL |
| Linux process / systemd service | Checks a systemd unit (systemctl is-active) or a process by name (pgrep) | An SSH scanning profile on the server |
| Windows service | Checks a Windows service state (sc query) | A WMI scanning profile on the server |
HTTP / HTTPS
Enter a health-check URL. JOATOS requests it and maps the result:
- 2xx response → Running
- 4xx / 5xx response → Degraded
- Unreachable → Stopped
Linux process / systemd service
Enter the process or unit name and pick a check method:
- systemctl — the unit is Running when
systemctl is-activereports active, otherwise Stopped. - pgrep — Running when a matching process is found, otherwise Stopped.
A connection error shows as Unknown.
Windows service
Enter the Windows service short name (e.g. wuauserv, not "Windows Update"). The service is Running when its state is running, otherwise Stopped; a connection error shows Unknown.
Reading status
Each service shows a coloured status — Running (green), Stopped (red), Degraded (yellow), or Unknown (grey) — along with the last checked time and the latest check message (e.g. HTTP 200 or systemctl: active).
Checking on demand
On the detail page, Check now runs the health check immediately and updates the status without waiting for the interval.
Notes & tips
- Process and service checks run through the server's scanning profile, so that credential (SSH or WMI) must be valid.
- Pair service status with alerts so a Stopped or Degraded result notifies the right people.