Watchdog: Process Running
Checks with pgrep -f whether a process is running on the host. Needs pid: host in the agent service. Type process, runner Agent. Fields, statuses and messages.
Watchdog: Process Running
The check calls pgrep -f <name> and tests whether at least one process matches the command line.
| Property | Value |
|---|---|
| Type identifier | process |
| Runner | Agent |
| Target in the email | Process |
Fields
| Field | Key | Default | Meaning |
|---|---|---|---|
| Process name | process_name |
Required. Name or part of the command line, for example nginx. pgrep -f matches against the full command line |
Behaviour
| Situation | Status | Message |
|---|---|---|
| At least one process matches | OK |
Process running: <name> |
| No process matches | FAIL |
Process not running: <name> |
pgrep reports an error or is missing |
UNKNOWN |
pgrep exited with code <n> — is pgrep available on this system? |
| No process name | UNKNOWN |
No process name configured |
Requirement with Docker
Unless the service sets pid: host, the agent only sees the processes of its own container. The bundled Compose files and docker-compose.agent.yml set it. If the line is missing, the check reports FAIL for every host process.
pid: hostgives the container insight into all processes of the host. Use the line only when you need process checks.