Product Documentation

Configuring Thresholds to Monitor Devices

May 24, 2012

Thresholds are used to monitor the state of a discovered Citrix device. You can set a threshold for a specific counter to monitor devices or instances of entities configured on managed devices as follows:

  • All devices. Thresholds are applied to all devices by default.
  • Specific instances of entities on managed devices. You can select specific instances of entities, such as virtual servers and services configured on managed devices, for which you want to set the threshold.
  • Specific devices. You can select specific devices on which you want to set the threshold.
  • Specific instances of specific entities of managed devices. You can select specific devices and then select instances of entities, such as virtual servers and services, for which you want to apply the threshold.

When monitored values (values collected during polling) for the counters are collected for each device instance, the Command Center server checks the monitored values against the corresponding threshold values. If the monitored value exceeds the threshold, Command Center generates an event to signify a performance-related issue on the device or the device instance.

When the threshold is breached, events are generated and displayed on the Fault tab. You can resolve these events from the Fault tab. For information about resolving the events, see Monitoring and Managing Events Generated on Citrix Devices. When the selected counter value matches the clear value specified in the threshold, the event is cleared, which means that the particular threshold has returned to its normal state.

You can perform the following tasks with thresholds:

Adding Threshold Limits

When adding threshold limits, you need to specify threshold values and clear values. When the monitored value of a counter exceeds the threshold value, Command Center generates an event to signify a performance-related issue on the device or the device instance. When the selected counter value matches the clear value specified in the threshold, the event is cleared, which means that the particular threshold has returned to its normal state.

You can also define an action associated with the threshold. When the threshold is breached, the action you define is taken automatically.

Note: Command Center 3.3 and later versions support only sending email notifications action.

To add a threshold and associated action

  1. On the Reporting tab, in the left pane, expand Performance, click Thresholds.
  2. In the right pane, under Thresholds, click Add.
  3. Under Add Threshold, do the following:
    • In Threshold Name, type a unique threshold name.
    • In Device Family, select the type of device on which you want to set the threshold limit.
      Note:

      The NetScaler device family includes NetScaler Gateway and NetScaler VPX device types.

      By default, the threshold applies to all devices. If you want to specify specific devices or specific entities of managed devices, clear the Apply to all devices check box, and then, in Devices, specify the devices or entities.

    • In Group, select the counter group. Depending on the type of group you select, the options in the Counter field change and the availability of the Type and Instance fields may vary. Provide the appropriate information as needed.
  4. Click Criteria and do the following:
    • Specify whether the monitored value is greater than or equal to or less than or equal to the threshold value.
    • In Threshold Value, type the value for which the event severity is calculated. For example, you may want to generate an event with critical severity if the monitored value for CPU usage reaches 80 percent. In this case, type 80 as the threshold value.
    • In Clear Value, type the value that indicates when to clear the value. For example, you may want to clear the CPU usage threshold when the monitored value reaches 50 percent. In this case, type 50 as the clear value.
    • In Event Severity, select the security level that you want to set for the threshold value.
    • In Event Message, type a message that you want to appear when the threshold is met. Command Center appends the monitored value and the threshold value to this message.
  5. Under Action, do the following:
    • In Action Type, select the action you want to specify (for example, Send e-mail Action).
      Note: Command Center 3.3 and later versions support only sending email notifications.
    • In From, To, and Server Name/IP Address, type the respective email address of the sender, the email address(es) of the recipients separated by commas, and the IP address of the mail server that you want to use to send the email notification.
      Note: If you have configured the mail server settings on the Admin tab, the From, To, and Server Name / IP Address fields are updated automatically.
    • Select the Mail server requires authentication check box, and type the user name and password if your mail server is configured to authenticate the email addresses.
  6. Click OK.

Modifying Thresholds

Updated: 2014-04-15

You can modify the devices or instances of a device associated to a particular threshold. You can also modify the threshold value you have set.

You can unset the action associated with the threshold when modifying the threshold.

To modify thresholds

  1. On the Reporting tab, in the left pane, expand Performance, click Thresholds.
  2. In the right pane, under Thresholds, click the threshold name that you want to modify, and then click Modify. Alternately, right-click the threshold name and click Modify. .
  3. Under Modify Threshold, edit the parameters you want to modify, and then click OK.
    Note: You can modify only the Devices and Instances fields and information on the Criteria and Action tabs.

Deleting Thresholds

You can delete a threshold if you do not want to use it anymore. When you delete a threshold, the action associated with that threshold is also deleted.

To delete thresholds

  1. On the Reporting tab, in the left pane, expand Performance, click Thresholds.
  2. In the right pane, under Thresholds, select the threshold that you want to delete and then click Delete.