monitorstack/doc/source/plugins-base/plugin-process.rst

process - monitor a running process

The process plugin searches the list of running processes and checks whether a particular process is running.

Usage

The plugin takes only one argument: the name of the process to check. See the examples below for more details.

Example

In this example, the plugin searches the process list for the chronyd process:

$ monitorstack process chronyd

The default JSON output shows that the process was found:

{
  "variables": {
    "chronyd": 1
  },
  "message": "process check is ok",
  "meta": {
    "platform": "Linux"
  },
  "exit_code": 0,
  "measurement_name": "process"
}

Here's another example where the plugin searches for nginx. That process is not running on this server:

$ monitorstack process nginx

This time, the process is not found:

{
  "variables": {
    "nginx": 0
  },
  "message": "process failed -- Process nginx not found",
  "meta": {
    "platform": "Linux-4.10.8-200.fc25.x86_64-x86_64-with-fedora-25-Twenty_Five"
  },
  "exit_code": 1,
  "measurement_name": "process"
}