Performance Trigger

Description

Triggers the task when a system or process threshold (such as CPU utilization and memory usage) is met. The Performance trigger is ideal for monitoring servers in a "back office" environment. For example, if available memory is too low, a task can automatically restart the entire system or specific processes using the ‘Restart’ action. or ‘Start Process’ action. In the above scenarios, the entire process is automated, eliminating the need for human intervention. Additionally, this trigger has the capability to monitor system performance on a remote computer as long as that computer resides on the same network as the computer where AutoMate is installed. Specifying the remote system to monitor is as easy as entering the remote machine’s Host name or IP Address.

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

Practical Usage

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

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

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

The Performance trigger generally uses the same powerful and intelligent system performance detection capabilities and gathers the same comprehensive hardware and system information used by Windows Performance Monitor (perfmon.exe), whereas, system performance is based mainly on performance counters, which are essentially measurements of system state and/or activity. They can be included in the operating system or can be part of individual applications.

Parameters

General Properties

 

Property

Description

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 (disabled by default). To specify the remote machine, enter its Hostname or IP Address in the field provided. If this parameter is enabled, the Use Local Computer parameter is ignored.

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

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.

Behavior Properties

Property

Description

Trigger on startup if condition is true

If enabled, the system will act upon conditions that already exist upon startup of the current trigger. For example, if the Notepad window is already open on the desktop, a newly created Window trigger set to monitor for the existence of a Notepad window will immediately launch the task as a result. If disabled, the trigger will ignore the open Notepad window upon startup. This parameter is disabled by default.

Trigger after the condition has been met 'X' times.

If enabled, specifies how many times the trigger condition must be met before the task is started. For example, if a Window trigger is set to monitor for the appearance of a Notepad window and this parameter is set to 3, the task will not launch until the third instance of Notepad appears on the desktop.

 

AMTrigger

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 Using AMTrigger. The AMTrigger field listed in the table below are specific only to the Performance trigger.

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.

 

NOTE: A full list of AMTrigger objects exclusive to each trigger can be viewed from the Expression Builder by expanding Objects -> Triggers and selecting the desired trigger.

See Also

↑ Top of Page