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
tag	string	No		tags processes as belonging to a group of processes. e.g. oracle db
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
tag	string	No		overrides Procs Alive Probe tag
args_matcher	[]string	No		Space separated list of program args to look for. It must match all elements anywhere in the process command line
args	string	No		Space separated program args to look for. Will match exact string in the process command line
exact_args	boolean	No	false	Must match the exact arguments in args in process command line, i.e. no other argument in process command

Example Configuration

poll_interval: 5s
timeout: 200ms
must_be_alive: 
  dead_interval: 2s
  procs:
  # command line to match: /bin/bash one two --three
    - name: my program
      program: /bin/bash
      args: one two --three
  # command line to match: .+/java .* -Dweblogic.Name=SomeName .* -Dsomeother.Prop=Other .* |
  #                        .+/java .* -Dsomeother.Prop=Other .* -Dweblogic.Name=SomeName .*
    - name: some java program
      program: java
      args_matcher:
        - -Dweblogic.Name=SomeName
        - -Dsomeother.Prop=Other

track_zombies: true