Help Center

Creating a Threshold

Thresholds are created through the Windows Client, it is not currently possible to create a Threshold through the Web Application.

To create a Threshold use the following procedure.

Open the Threshold properties dialog box by using one of the following methods:

  • From the Menu bar select File>New>Threshold.

  • If visible, click the  icon on the Toolbar, select Threshold then click OK.

  • Right-click on a folder In the Document Navigator where this document is to be saved and then select New>Threshold.

  • Press Ctrl+N, select Threshold from the list and then click OK.

The various tabs on the properties dialog box are used to enter the information required to create the Threshold document.

Threshold Properties - Conditions Tab
Enter a 'Threshold Process Name'. The name for each Threshold Process must be unique and can be up to 18 characters long. This name is used to identify the Threshold in the Node Navigator under the node on which it is running and defines the group of conditions contained within the particular Threshold. Multiple Threshold Conditions can be created within one Threshold, however, it is advisable to limit the number and keep them in a logical grouping based on what they are intended to do.

When finished select the  icon to open the Threshold Conditions dialog box.

If a Threshold condition already exists and is highlighted, selecting the  icon will open the Add Log Destinations dialog box.

Threshold Conditions - Where Clause Tab
On this dialog box a Condition to monitor is defined by creating a 'Where Clause' (e.g. Where the CPU is busy more than 90 percent, i.e. CPUBUSY > 90). The 'Where Clause' will set the condition to trigger the Threshold to perform the action specified by the Message Destination.

A 'Where Clause' can be entered directly into the Where Clause box at the bottom of the screen or the Fields list and buttons can be used to complete the Where Clause details.

Threshold Conditions - Timing Tab
When a Threshold is started, trigger conditions are evaluated as soon as the data arrives. If it does not find the condition to be true, it uses the information specified in the Check Interval field to determine how often to check for the condition. If it finds the condition to be true, it uses the information specified in the Log Frequency fields to determine how often to log the message.

In the Check Interval field select a time period for how often the Threshold should check for the condition.

Check the 'Acknowledgement required by operator' box if all reported cases of this Condition are required to be manually acknowledged by an operator. This option is only available if the condition logs to the PROBLEM record and will cause the PROBLEM record to remain in a special state until the problem is acknowledged by the operator. Until acknowledged, the particular problem will not be reported again. For details see the Operator Acknowledgement for Thresholds.

The Schedule section is used to set the days of the week that this condition is to be monitored. This can be set to an individual schedule or it can be set to use the overall Threshold settings that are entered on the Schedule tab of the Threshold Properties Window.

To avoid unnecessary or repetitive notifications special attention should be made to the Thresholds Log Frequency fields. This is not how often the Threshold checks for exceptions, it simply specifies that after the Threshold has been exceeded, at what frequency should the Threshold issue a message.

Threshold Conditions - Message Destination Tab

Specify where the message will be sent. When creating a new Threshold this tab will default to the Problem Summary destination. Depending on the destination of the message various information must be entered. If more than one message destination has been set, a tab will be shown for each destination.

To add a new destination select the New button. The Add Log Destinations dialog box is opened.

Select the destination for the message and click OK. All listed destinations are available on Windows, UNIX and HPE NonStop with the exception of Process Log and Terminal Log, which are only available on HPE NonStop.

Message destinations can be attached to a Threshold and/or to individual conditions within a Threshold. Single or multiple message destinations can be attached to each Threshold condition and these destinations will override any overall Threshold destination that has been set. To add multiple destinations to one Threshold condition, go to the Thresholds - Threshold Conditions Tab, highlight a Threshold condition, right click and select New from the shortcut menu.

For all message destinations text can be entered that will be output when one or more of the Threshold Conditions are met. See Threshold Event Text for details.

Threshold Conditions - Nodes to Monitor Tab
Specify which nodes should be monitored for the condition. On this tab you can specify which nodes in the system are to be monitored by this Threshold condition.& Double-click the required node in the Available Nodes list to add it to the Selected Nodes list or highlight the required node and click Add.

Threshold Conditions - Associate Names Tab
Associate names are only related to the use of the Availability record (AVMON). For this particular record, you can specify the type of entity (Available Name) that you wish to monitor.

The Available Names are:

¨   Application
¨   Disk
¨   Port
¨   Process
¨   Service
¨   TCP/IP

You can also include all entities with;

-   #AllNames

Threshold Conditions - Subsystem Configuration Tab
On this tab you can specify the parameters that are used by the operating system utility to collect the entity. When data is collected on different operating systems, system utilities can be used to access the required data.

For example, on HPE NonStop, Measure is used to collect entities. In this case, the keyword PARAM is used to specify a list of strings or numbers that will be associated with the record. In most cases, automatic Measure PARAM creation is performed by the Where Clause engine.

When all the properties are set click OK. You will be returned to the Threshold Properties Window.

Threshold Properties - Default Destinations Tab
This tab is used to specify the message destination details for all conditions within this Threshold (File names must not contain spaces). The actual types of messages and the text are added to the Threshold Conditions - Message Destination tab.

Thresholds Properties - Schedule Tab
Use this tab to add the default scheduling details for all conditions within the Threshold, i.e. the times/days that the Threshold is to monitor for the specified condition. This can be overridden by individual Conditions.

Threshold Properties - Nodes to Run On Tab
From the Available Nodes list select the nodes that this Threshold is to run on. This is done by either double-clicking on a required node name to add it to the Selected Nodes list, or by highlighting the node name and then selecting the Add button.

Note that these are the nodes where the Threshold will run, NOT the nodes that will be monitored for the condition. See Threshold Conditions - Nodes To Monitor Tab.

Threshold Properties - General Tab
In the Name field enter a unique name for this Threshold document. The Name field is mandatory and must be completed before the document can be saved. The Description and User Notes fields are optional and can be used to include any additional information.

When complete, select the OK button to save the Threshold document.

A Threshold can also be created by copying an existing Threshold document that has similar properties and saving it with a new name. Any necessary changes can then be made to the copy in order to create the required Threshold functionality. Using a copied document will ensure that the original document is retained and that the changed document will not be overwritten by any future upgrades.
Provide feedback on this article