WTS Processes Plug-In - Technical Reference
Introduction
The WTS Processes plug-in provides a view of the current processes running on the machine, which stem from a remote login. This view is updated in real-time, and can be configured to display an additional set of metrics to monitor, as well as to filter processes listed to provide a more specific view. The Geneos Rule Manager can then be used to set up a rule that would change state and trigger an event when these metrics rise above a set level.
Multiple sets of processes can be monitored by using multiple instances of this plug-in - one instance per view required. These views can then be shown inside a single Managed Entity or across multiple Managed Entities - one per view.
Views (for a single view)
View
Table Legend
Name | Description |
---|---|
ProcessID | The process identifier as used by Windows. |
SessionID | The session the process originates from. |
UserName | The name of the user logged in for that session. |
ProcessName | The name of the executable of the process. |
Creating Process ID | The process identifier of the creating process. |
<user defined> | Other columns as specified in the sampler manager, using the "Counters" parameter. |
Actions
Kill Process
This plug-in has an additional context-menu option, "Kill Process" as shown below. When selected, this option will terminate the currently selected process immediately. As a consequence, managers using this option should note that a user still using this process would not be given a chance to save their work. Thus it is recommended that this feature only be used on unwanted processes.
If required, managers can give the user prior notification using the "Send Message" menu in the WTS Sessions plug-in before terminating a process.
Plug-In Configuration
The Netprobe that contains this plug-in is called netprobent+wrs. It must run on a Windows machine running the Windows Terminal Services service.
The following parameters can be configured for this plug-in:
counters > counter
A list of metrics to monitor for each process. These will be added to the view as columns at the right-hand side.
Entries in this list are checked to see if they correspond with the above values. If an entry does not appear as a column when running the plug-in, please check that it is specified exactly as above.
Possible values:
Setting |
% Processor Time |
% User Time |
% Privileged Time |
Virtual Bytes Peak |
Virtual Bytes |
Page Faults/sec |
Working Set Peak |
Working Set |
Page File Bytes Peak |
Page File Bytes |
Private Bytes |
Thread Count |
Priority Base |
Elapsed Time |
Pool Paged Bytes |
Pool Nonpaged Bytes |
Handle Count |
IO Read Operations/sec |
IO Write Operations/sec |
IO Data Operations/sec |
IO Other Operations/sec |
IO Read Bytes/sec |
IO Write Bytes/sec |
IO Data Bytes/sec |
IO Other Bytes/sec |
showUsers
A list of usernames on which to filter the view. If this parameter is specified, only processes belonging to the listed users will be included in the view.
If this parameter is specified along with hideUsers, or neither of these parameters is specified, then processes of all users are shown.
hideUsers
A list of usernames on which to filter the view. If this parameter is specified, processes belonging to the listed users will be excluded from the view.
If this parameter is specified along with showUsers, or neither of these parameters is specified, then processes of all users are shown.
showProcesses > process
A list of process names on which to filter the view. If this parameter is specified, only the listed processes will be shown in the view.
If this parameter is specified along with hideProcesses, or neither of these parameters is specified, then all processes will be shown.
hideProcesses > process
A list of process names on which to filter the view. If this parameter is specified the listed processes will be hidden from the view.
If this parameter is specified along with showProcesses, or neither of these parameters is specified, then all processes will be shown.