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

wts-process2

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.

wts-process3

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

This section contains configuration about counters.

Mandatory: No

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

Mandatory: No
Default: % Processor Time,% User Time,% Privileged Time,Page Faults/sec,Working Set

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.

Mandatory: No (either showUsers or hideUsers)
Default: All user processes

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.

Mandatory: No (either showUsers or hideUsers)
Default: All user processes

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.

Mandatory: No (either showProcesses or hideProcesses)
Default: All processes

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.

Mandatory: No (eithershowProcesses or hideProcesses)
Default: All processes