Skip to content
Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
lib fix duplicated output of usage with --help argument Apr 18, 2018
README.md
main.go Apply tool/packagize.pl Mar 3, 2017

README.md

check-procs

Description

Checks processes if the specific metric is outside the required threshold ranges.

Synopsis

check-procs --pattern=PROCESS_NAME --state=STATE --warning-under=N

Installation

First, build this program.

go get github.com/mackerelio/go-check-plugins
cd $(go env GOPATH)/src/github.com/mackerelio/go-check-plugins/check-procs
go install

Or you can use this program by installing the official Mackerel package. See Using the official check plugin pack for check monitoring - Mackerel Docs.

Next, you can execute this program :-)

check-procs --pattern=PROCESS_NAME --state=STATE --warning-under=N

Setting for mackerel-agent

If there are no problems in the execution result, add a setting in mackerel-agent.conf .

[plugin.checks.check-procs-sample]
command = ["check-procs", "--pattern", "<PROCESS_NAME>", "--state", "<STATE>", "--warning-under", "N"]

Usage

Options

  -w, --warning-over=N                Trigger a warning if over a number
      --warn-over=N                   (DEPRECATED) Trigger a warning if over a number
  -c, --critical-over=N               Trigger a critical if over a number
  -W, --warning-under=N               Trigger a warning if under a number (default: 1)
      --warn-under=N                  (DEPRECATED) Trigger a warning if under a number (default: 1)
  -C, --critical-under=N              Trigger a critial if under a number (default: 1)
  -m, --match-self                    Match itself
  -M, --match-parent                  Match parent
  -p, --pattern=PATTERN               Match a command against this pattern
  -x, --exclude-pattern=PATTERN       Don't match against a pattern to prevent false positives
      --ppid=PPID                     Check against a specific PPID
  -f, --file-pid=PID                  Check against a specific PID
  -z, --virtual-memory-size=VSZ       Trigger on a Virtual Memory size is bigger than this
  -r, --resident-set-size=RSS         Trigger on a Resident Set size is bigger than this
  -P, --proportional-set-size=PCPU    Trigger on a Proportional Set Size is bigger than this
  -T, --thread-count=THCOUNT          Trigger on a Thread Count is bigger than this
  -s, --state=STATE                   Trigger on a specific state, example: Z for zombie
  -u, --user=USER                     Trigger on a specific user
  -U, --user-not=USER                 Trigger if not owned a specific user
  -e, --esec-over=SECONDS             Match processes that older that this, in SECONDS
  -E, --esec-under=SECONDS            Match process that are younger than this, in SECONDS
  -i, --cpu-over=SECONDS              Match processes cpu time that is older than this, in SECONDS
  -I, --cpu-under=SECONDS             Match processes cpu time that is younger than this, in SECONDS

For more information

Please refer to the following.

Other

You can’t perform that action at this time.