Follow

Process Plugin

Display CPU and Memory usage for specific processes with this TrueSight Pulse Process plugin.

Note

This plugin replaces the Process Memory and Process CPU plugins.

Prerequisites
  • Supported OS: Linux, Windows, OS X
  • TrueSight Pulse meter 4.5.0-778 or later
To install new meter go to 'Settings-> Installation' or see instructions.
To upgrade the meter to the latest version see instructions
 
Metrics Collected
  • cpu_process
  • mem_process
  • open_handles
  • process_count
Installing the plugin
 
1) Log into the BMC TrueSight Pulse console.
 
2) Go to Settings > Plugins
 
3) Click on 'Get Plugins'.
 
4) Scroll to 'process' and click 'Install'.
 
5) Pulse provides a list of meters to associate to the plugin.  Please select a meter.  Now an "Add a plugin..." drop down box will display.  Please click and select 'process':
 
6) You will be prompted to "Add a Process".
 
7) Type the required details, use the available tool-tips for help.  Click 'OK'.
 
Field Name Description
Source The source name to display in the legend for the CPU & Memory data.
Process Name Regex The regular expression used to match the name of the process.
Process Path Regex The regular expression used to match the path of the process.
Process CWD Regex The regular expression to match the CWD (Current Working Directory) of the process.
Process Args Regex The regular expression to match the arguments of the process.
Polling Interval A numeric value representing the polling interval time in miliseconds.
Reconcile option* The method used to determine the method used to reconcile processes when multiple processes match the specified regex parameters.

*Select one of the following values for the Reconcile option.

Reconcile option Description
All Source Average Display a single source for each matching unique process name. It will show an average value of metrics along with count of processes for the source. This option is useful when focus is on the number of processes running or average utilization of particular processes.
All Individual Source

Display all unique sources (unlike average, even if multiple processes have the same process name, they are distinguished with index. For example, processname1 .. processnameN). This option is useful when individual process monitoring is crucial.

Longest Running

Display the single source that matches the process running for the longest period of time.

First Match

Display the first process that matches the regex parameter.

Parent

Display the parent processes that matching the regex parameters.

 
8) The following dashboard will be created:
  • Process
Process Examples
Here are a few examples of process configurations.
 
#1 Process name 'arserver.exe' using Process Name Regex (arserver): 
arserver.exe.jpg
 
#2  If the process is one of many JAVA processes running on the system you can use REGEX ARGS to define the configuration in order to capture data. 
 
For example, let's configure the plugin to capture a JAVA process we know is associated to "C:\Program Files\BMC Software\ARSystem\pluginsvr\fts\primary".
 
We can find or confirm the JAVA process command line path by using the following PowerShell command:
 
PS C:\Users\Administrator> $process = "java.exe"

Get-WmiObject Win32_Process -Filter "name = '$process'" | select Name,ProcessId,CommandLine | Format-Table -Property Name,ProcessId,Commandline -Wrap -AutoSize

Using 'Process Args Regex' the configuration looks like this (.+primary):

primary.jpg
 
#3 Another JAVA example using Jenkins process and 'Process Args Regex'. The value in the Process Args Regex is ‘.+jenkins’:
jenkins.jpg
 
#4 If you decide to use the 'Process Path Regex' or 'Process CWD Regex' , be sure to properly use regex conventions.  For example, for the following path:
 
C:\Program Files (x86)\Jenkins\jre\bin
use 'Process Path Regex':

C:\\Program\sFiles\s\(x86\)\\Jenkins\\jre\\bin

 

References
 
Have more questions? Submit a request