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.


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".


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

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

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 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

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