Type: process | Runner: Agent only
Checks if at least one process matching the given name or pattern is currently running on the host, using pgrep -f (matches against the full command line).
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
process_name |
text | Yes | — | Name or substring to match against running process command lines. Uses pgrep -f, so partial matches work (e.g. nginx, php-fpm, backup.sh). |
| Status | Condition |
|---|---|
| OK | One or more processes match — message: Process running: <name> |
| Fail | No process matches — message: Process not running: <name> |
| Unknown | pgrep is not available, or execution error |
| Unknown | No process name configured |
The agent container must share the host's process namespace:
# compose.stage.yml or docker-compose.agent.yml
agent:
pid: host
Without pid: host, the agent only sees processes inside its own container and will always report the host's processes as not running.
pgrep -f matches against the entire command line, including arguments. A pattern like nginx will match nginx -g daemon off; and nginx: master process. Use more specific patterns if ambiguity is a concern.