Performance Condition

See Also

 About Events & Conditions | All Available Conditions | Condition Behavior | Setting Conditions | AMCondition

Description

Starts the task when a system or process threshold (such as CPU utilization or memory usage) is met. It can also be used in the middle of a workflow to wait for a specific system threshold to occur 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 Watcher 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 Tab

 

Use Local Computer

If enabled, the trigger will monitor performance on the local machine (enabled by default).

 

Use Remote Computer

If enabled, the trigger will monitor performance on a remote machine. To specify the remote machine, enter its Host name or IP Address in the field provided.

 

Category

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

 

Counter

Specifies the 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 system performance category selected.

 

Instance

Specifies 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 Tab

All available Conditions contain Behavior properties that dictate how it should handle a monitored event or condition. These properties determine whether the Condition should act as a trigger, a wait object or conditional (or decision making) object. By default, new Conditions are set to wait for the specified event/condition indefinitely, allowing it to act as a trigger object. For more details, see Condition Behavior.

 

AMTrigger Parameters

When this trigger is activated, it automatically passes the "AMTrigger" object to the task. AMTrigger can be used within a task to determine whether or not the task was started by a trigger, which trigger started the task, when the trigger was activated and other trigger related properties. For more details, see

 

Common AMTrigger Fields

Every instance of AMTrigger populates a list of common fields which are described in the table below.

Name

Data Type

Return Value

AMTrigger.Trigger

String

Returns the name of the event or condition that triggered the task. Each event or condition contains a unique name. For this trigger, the value is always AMPERFORMANCETRIGGER.

AMTrigger.TaskName

String

Returns the name of the managed task that the trigger was attached to. Useful to determine the responsible task when two managed tasks point to the same AML file.

AMTrigger.TriggerredDateTime

String

Returns the date and time when the trigger occurred.

AMTrigger.TriggeredOn

String

Returns the machine name where the trigger occurred.

AMTrigger.WasLocked

Boolean

If the workstation was locked when the trigger occurred, the value returned is 1. Otherwise, it will be 0.

AMTrigger.WasLoggedOff

Boolean

If the workstation was logged off when the trigger occurred, the value returned is 1. Otherwise, it will be 0.

AMTrigger.AML

String

Returns a verbose set of information about the triggered event or condition in AML (AutoMate Markup Language) format.

 

Specific AMTrigger Fields

 

The AMTrigger field listed below is specific only to the Performance condition.

 

Name

Data 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 Parameters

 

When this condition is used in the middle of a workflow (as opposed to triggering condition) it automatically passes the AMCondition object to the task.

Common AMCondition Fields

Each condition contains its own set of unique AMCondition values. Therefore, the total number of fields that AMConditon creates during runtime and what they are called depend largely on the condition that was activated. However, every instance of AMCondition is populated with the following general fields:

Name

Data Type

Return Value

AMCondition.Agent

String

Returns the name of the agent where the condition activated.

AMCondition.DateTime

String

Returns the date and time of when the condition occurred.

AMCondition.Name
 

String

Returns the name of the activated condition. Each condition contains a unique name. For example, if the File condition was initiated, the value returned would be . See the help topic for each condition to determine that object's unique name.

AMCondition.Result
 

String

Returns the result of the activated condition (True or False).

AMCondition.WasLocked

Boolean

If the workstation was locked when the condition occurred, the value returned is 1. Otherwise, it will be 0.

AMCondition.WasLoggedOff

Boolean

If the workstation was logged off when the condition occurred, the value returned is 1. Otherwise, it will be 0.

AMCondition.AML

String

Returns verbose data about the activated condition in AutoMate Markup Language (AML) format.

 

Exclusive AMCondition Fields

The AMCondition fields described in the table below are specific only to the Performance condition.

 

Name

Data 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

All Available Events & Conditions

Condition_Behavior