Plugin info

name: proc-mon

• Monitors the health of selected processes
• Tracks zombie processes (linux only)

Prerequisites

None

Events

Event	Description
system/proc-health/dead	boolean 1/0, set to 1 when a process has not been found

Metrics

Metric	Description
system/procs/zombie/count	the number of zombie processes

Configuration

This section describes the configuration settings for this plugin.

Name	Type	Required	Default	Description
timeout	duration string	No	10s	How long to wait for process information from the kernel
poll_interval	duration string	No	10s	How often to poll the kernel for process information
must_be_alive	Procs Alive Probe	No		Defines which process to event on if not found
track_zombies	boolean	No	false	Set to true to track zombie processes

Procs Alive Probe

Name	Type	Required	Default	Description
dead_interval	duration string	No	0s	Presume a process to be dead if not found during this period
procs	Proc Lookup	Yes		Defines the process to check if they are dead

Proc Lookup

Name	Type	Required	Default	Description
name	string	No	program	The human readable process name to report. defaults to program name
program	string	Yes		Full path or basename of the process binary to check
args	string	No		Space separated program args to look for
exact_args	boolean	No	false	Must match the exact arguments in args

Example Configuration

poll_interval: 5s
timeout: 200ms
must_be_alive: 
  dead_interval: 2s
  procs:
    - name: abc
      program: /bin/bash
      args: one two --three
      exact_args: true
    - name: docker abs path
      program: 'C:\Program Files\Docker\Docker\resources\docker.exe'
    - name: docker simple
      program: docker.exe
track_zombies: true