Page tree

SAYMON документация

Skip to end of metadata
Go to start of metadata

Process by name probe returns information about process with the specified name and/or arguments.

Example


FieldDescription
Process*Process name to find. The value has to match strictly to the process name to be found, e.g. for "nodejs" value - "process name matches nodejs".
Arguments contain*Find processes with arguments, that contain specified value. E.g. for "Rest" value - "one of the arguments of the process contains Rest".
PeriodDescribes how often to perform the check (60 seconds by default).
*

To setup this probe one of the field is enough.

If the both fields are filled the logical operator "AND" is applied, e.g.:

"process name matches nodejs AND one of the arguments of the found processes contains Rest".

Result

After the check has been done the result is displayed in the data table:

FieldDescription
nameName of the found process.
processIdProcess ID number (PID).
parentIdID number of the process′s parent process (PPID).
state

Process state code:

  • D    uninterruptible sleep (usually IO)
  • R    running or runnable (on run queue)
  • S    interruptible sleep (waiting for an event to complete)
  • T    stopped, either by a job control signal or because it is being traced
  • W    paging (not valid since the 2.6.xx kernel)
  • X    dead (should never be seen) - the process is about to be destroyed
  • Z    defunct ("zombie") process, terminated but not reaped by its parent
  • <    high-priority (not nice to other users)
  • N    low-priority (nice to other users)
  • L    has pages locked into memory (for real-time and custom IO)
  • s    is a session leader
  • I    is multi-threaded (using CLONE_THREAD, like NPTL pthreads do)
  • +    is in the foreground process group
ttyTerminal associated with the process.
niceNice value. This ranges from 19 (nicest) to -20 (not nice to others).
arguments.xxx

Arguments of the process, if any.

bytesVirtualTotal process virtual memory (virtual memory usage).
bytesResidentTotal process resident memory.
bytesSharedTotal process shared memory.
lastTimeTime when the process ran on a cpu and did something.
startTimeTime when the process started.
userCpuProcess cpu user time.
systemCpuProcess cpu kernel time.
totalCpuProcess cpu time (sum of userCpu and systemCpu).
percentCpuHow much of the CPU the process is using (or "process cpu usage").

Raws is an additional field in which the array length is indicated.

Total number of rows is displayed when the array value is the result of the probe or the input data.

Terminal counterpart

This check is the counterpart of ps terminal command:

ps aux | head -1 ; sudo ps aux | grep 'nodejs.*Rest' | grep -v grep

USER       PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND
saymon   29050  3.7  4.7 1359092 194040 ?      Sl   Nov30 363:39 /usr/bin/nodejs /usr/local/saymon/server/actors/lib/forked-actor-worker.js RestServerActor

Known problems and errors

At the time of writing this article, no such errors were found.

  • No labels