Performance Monitor Action Properties

The DM Action properties vary for for the three different types of monitors available. The type of monitor to which an action refers is set by the Category of the slot. The category is defined as a Performance Monitor counter (PM), a service (SC) or a process (PR).

 

Performance Counters (PM)

IDX Performance monitor slots are slots that are set up to monitor any defined performance counter on a Windows server. Performance monitor slots can only be of type IDX_FLOAT. The Category of a performance monitor tag is always PM:

 

Value

Data Type

Default Value

Description

Bias

Float

0.0

Configures a BIAS or offset value to apply to a value after it is read from the server.

Category

PM/PR/SC

 

Defines the category of the tag. For a performance monitor counter, this value is set as PM.

Gain

Float

1.0

Configures a Gain multiplier to be applied to the tag value after it is read from the server.

Node Name

String

Null

The Windows server name/IP address from which the performance monitor counter is to be read.

Object

String

Null

The performance monitor object to read. This is in the format:

PerformanceObject(ParentInstance/ObjectInstance#InstanceIndex)\Counter

e.g.: Process(idx)\Private Bytes *

Poll Rate

Float

500ms

1s

10s

1min

1hour

1day

500ms

The rate at which to poll the server object for updates.

Service Log Type

STATE/STARTTYPE

 

Not used for Performance monitor (PM) counters.

Type

RAW/MIN/MAX/AVE

RAW

Specifies whether the object data is RAW/Minimum/Maximum/Average.

RAW: specifies that values are read on a real-time basis from the server

Minimum: returns only the minimum value encountered since server-side Performance monitor logging began.

Maximum: returns only the maximum value encountered since server-side Performance monitor logging began.

Average: returns only the average value encountered since server-side performance monitor logging began.

 

* Note that these objects can be configured using the Performance Monitor import wizard.

Service Monitor (SC)

The service monitor actions allow the IDX Performance Monitor module to monitor the state of any service running on a Windows machine. The Category for the slot action is SC.

Service states are reported by the module as follows:

·      SERVICE_STOPPED

·      SERVICE_START_PENDING

·      SERVICE_RUNNING

·      SERVICE_STOP_PENDING

 

In addition, the module can monitor the service start type, which is reported as follows:

·      SERVICE_DEMAND_START (Manual)

·      SERVICE_AUTO_START (Automatic)

·      SERVICE_DISABLED (Disabled)

 

The service monitor tags are set up as follows:

 

Value

Data Type

Default Value

Description

Bias

Float

0.0

Configures a Bias or offset value to apply to a value after it is read from the server.

Category

PM/PR/SC

 

Defines the category of the tag. For the services list, this value is set as SC.

Gain

Float

1.0

Configures a Gain multiplier to be applied to the tag value after it is read from the server.

Node Name

String

Null

The Windows server name/IP address from which the list of services is to be read.

Object

String

Null

The service name to read. *

Poll Rate

Float

500ms

1s

10s

1min

1hour

1day

500ms

The rate at which to poll the server object for updates.

Service Log Type

STATE/STARTTYPE

 

For the STATE setting, the service state can be one of four values.

If the slot type is IDX_STR the values can be:

·      SERVICE_STOPPED

·      SERVICE_START_PENDING

·      SERVICE_RUNNING

·      SERICE_STOP_PENDING

If the slot type is set as IDX_DWORD the values can be:

1 – (Stopped)

2 – (Start Pending)

3 – (Stop Pending)

4 – (Running)

 

If the Service Log type is STARTTYPE, the service start type can be one of three values.

If the slot type is IDX_STR, the values can be:

·      SERVICE_DEMAND_START (Manual)

·      SERVICE_AUTO_START (Automatic)

·      SERVICE_DISABLED (Disabled)

If the slot is set as an IDX_DWORD, the values can be:

2 – (Automatic)

3- (Manual)

4 – (Disabled)

 

Type

RAW

RAW

Only the RAW type can be used for SC

 

* Note that these objects can be configured using the Performance Monitor import wizard.

 

* Note that these objects can be configured using the Performance Monitor import wizard.

Process Monitor (PR)

If the category of the slot is set to be a process monitor (PR), it will determine whether a process on a server is running or not. The Process monitor tag can be set to be an IDX_STR or an IDX_DWORD.

If it is an IDX_STR the value can be

·      RUNNING

·      NOT RUNNING

 

If it is IDX_DWORD the values can be:

 0 – Not running

 1 – Running

 

Value

Data Type

Default Value

Description

Bias

Float

0.0

Configures a Bias or offset value to apply to a value after it is read from the server.

Category

PM/PR/SC

 

Defines the category of the tag. For the process list, this value is set as PR.

Gain

Float

1.0

Configures a Gain multiplier to be applied to the tag value after it is read from the server.

Node Name

String

Null

The Windows server name/IP address from which the list of processes is to be read.

Object

String

Null

The process name to read. *

Poll Rate

Float

500ms

1s

10s

1min

1hour

1day

500ms

The rate at which to poll the server object for updates.

Service Log Type

STATE/STARTTYPE

 

NOT USED by the Process Monitor

 

Type

RAW

RAW

Only the RAW type can be used for PR

* Note that these objects can be configured using the Performance Monitor import wizard.