Performance Condition

Description

Starts a task/workflow when a system or process threshold (such as CPU or memory utilization) is met. It can also be used to pause workflow execution until the occurrence of a specific system or process threshold or used as a conditional object to determine the course of a workflow depending on whether or not a particular system/process threshold has been met.

Practical Usage

Used to monitor a server or workstation for certain performance characteristics or thresholds. This is useful for servers in a "back office" environment.

Example 1: Using the Performance condition, if available memory is too low - the entire system or specific processes could automatically be restarted.

Example 2: If disk space is too low, a notification message could be sent to the system administrator.

Parameters

General Properties

Property

Description

Use Local Computer

If enabled, the condition will monitor performance on the local machine. If this parameter is enabled, the Use Remote Computer parameter becomes inactive (enabled by default).

Use Remote Computer

If enabled, the condition will monitor performance on a remote machine. To specify the remote machine, enter its host name or IP Address in the field provided. If this parameter is enabled, the Use Local Computer parameter becomes inactive.

Category

The system category in which to monitor (i.e. Processor, Memory, Paging File, etc.). A category catalogues performance counters in a logical unit.

Counter

The type of counter related to the category in which to monitor. Performance counters are combined together under categories. They are used to measure various aspects of performance, such as transfer rates for disks or, for processors, the amount of processor time consumed. Specific counters are populated in this section depending on the performance category selected.

Instance

The instance related to the category in which to monitor. A performance counter can be divided into instances, such as processes, threads, or physical units.

Trigger when

Specifies the performance threshold and duration to monitor as it relates to the Category, Counter and/or Instance values selected.

Show Description

If enabled, a detailed description will appear for each selection.

NOTE: AutoMate gathers the same system information used by Windows Performance Monitor (perfmon.exe).

Behavior Properties

The Behavior tab properties dictate how the system should react upon the occurrence of a condition. These properties are significant in determining whether the AutoMate Condition should act as a trigger object (used to fire off workflow execution), wait object (used to suspend workflow execution) or conditional (decision making) object.

More about condition behavior

AMTrigger

When an AutoMate Condition is used to trigger task/workflow execution, a pre-named (or fixed field) dataset called "AMTrigger" is created and populated with a collection of data which is passed onto the associated task. AMTrigger can be used to determine important properties related to the triggered event, such as where (machine name) and when (date/time) the trigger commenced, which AutoMate Event or Condition was responsible for the triggered event and which task started as a result.

 

Exclusive AMTrigger Parameters

A unique set of AMTrigger values exclusive to each Condition are created and populated along with the collection of common values created by every instance of AMTrigger. The AMTrigger values described in the table below are exclusive only to a Performance Condition.

 

Name

Type

Return Value

AMTrigger.ProcessID

Number

Specifies the unique Process ID that caused the condition to activate. This is dependent on if the condition is monitoring for a specific process threshold.

AMTrigger.ThreadID

Number

Specifies the Thread ID that caused the condition to activate. This is dependent on the condition properties.

AMTrigger.Value

Number

The value of the parameter that caused the task to start. This is dependent on the trigger properties. For example, if the trigger is set to watch for total memory to drop below a certain threshold, this value will contain the total amount of memory below that threshold when the task triggered.

 

AMCondition

When an AutoMate Condition is used as a wait or conditional (decision making) element in the middle of a workflow, it automatically passes a special dataset called "AMCondition" to the connected task. AMCondition can be used to determine important information about the condition that took place.

Exclusive AMCondition Parameters

A unique set of AMCondition values exclusive to each AutoMate Condition are created and populated along with a collection of common values created by every instance of AMCondition. The values described in the table below are exclusive only to a Performance Condition.

Name

Type

Return Value

AMCondition.ProcessID

Number

Returns the value of the parameter that caused the condition to activate. This is dependent on the condition properties. For example, if the condition is set to watch for total memory to drop below a certain threshold, this value will contain the total amount of memory below that threshold.

AMCondition.ProcessID

Number

Specifies the Process ID that caused the condition to activate. This is dependent on if the condition is monitoring for a specific process threshold. A process ID is a number automatically assigned to a process by Windows. The process ID can be used by other actions in AutoMate to specify an instance of an application.

AMCondition.ThreadID

Number

Specifies the Thread ID that caused the condition to activate. This is dependent on the condition properties.

 

NOTE: A full list of AMTrigger and AMCondition objects exclusive to each Event/Condition can be viewed from the Expression Builder by expanding the Objects folder and selecting the desired object from either the Triggers or Conditions folder .

See Also


About Events & Conditions | Condition Behavior | Event Log Condition | File Condition | Idle Condition | Key Event | Logon Condition | Performance Condition | Process Condition | SNMP Trap Condition | Window Condition | WMI Condition