Process Check Reference

All parameters, thresholds, and configuration options for the process check in octoja.

Written By Erdinc Akay

Last updated About 2 months ago

The Process Check verifies whether specific processes are running and optionally monitors their memory usage. In the check library it appears as Process Monitor (DE: Prozessüberwachung).

Configuration fields

FieldTypeRequiredDefaultDescription
Processes to monitorListYes—One or more processes to monitor
— Process nameStringYes—Process / executable name
— Alert severityChoice (Warning / Critical)NoWarningResult status when the process is missing. Selected via radio in the check editor.
— Max memory (MB)MBNo0 (disabled)Memory limit in MB; always raises a Warning when exceeded, regardless of the per-process Severity setting

Collected metrics

  • Process running status (yes / no)
  • Instance count
  • Memory usage (MB) per process
  • Access-denied count (instances the agent could not read)

Per-process details appear in the check detail view only for processes with a problem. When everything is healthy, the detail view shows a single summary line ("All N processes running.") without per-process metrics.

Platform support

PlatformSupported
WindowsYes
LinuxYes
macOSYes

Notes

  • Enter the process name without the file extension, as shown in the check editor.
  • If multiple instances of the same process are running, all are counted and their combined memory usage is reported.
  • The max memory check is optional. Set it to 0 to disable memory monitoring for a specific process.
  • By default the check runs every 5 minutes.
  • If the process list is empty or contains only blank entries, the check returns a Warning result. If the agent cannot look up a process at all (for example, access denied when querying it), that process is reported as Critical.

See also: Configure a Process Check