4.4 ClusterMemUsage

Use this Knowledge Script to monitor the memory usage of the cluster. This script raises an event when a monitored value exceeds the threshold you set. This script monitors and collects data for the following performance metrics:

  • Memory active: the amount of host machine memory used by all powered-on virtual machines in the cluster. A cluster’s consumed memory consists of virtual machine consumed memory and overhead memory. It does not include host-specific overhead memory, such as memory used by the service console or VMkernel.

  • Memory balloon: the amount of memory allocated by the virtual machine memory control driver, which is installed with VMware Tools.

  • Memory granted: the amount of memory (in kilobytes) that has been allocated to virtual machines running on all hosts in the cluster.

  • Memory swap used: the sum of the memory swapped by the powered-on virtual machines on all hosts in the cluster.

  • Memory usage: the amount of total configured memory available for use.

4.4.1 Prerequisite

To enable the Knowledge Script to collect accurate memory related data, set the following Statistics Collection Intervals appropriately in the vCenter Management Server Configuration:

  • Collection Frequency: The interval duration in vCenter must be less than or equal to the AppManager job interval schedule. For example, if you run the VirtualCenter_ClusterMemUsage Knowledge Script at 15-minute intervals, the interval duration in vCenter must be less than or equal to 15 minutes.

For more information about setting the Interval Duration and Statistics Level in vCenter, see the VMware Virtual Infrastructure 3 documentation.

4.4.2 Resource Object

vSphere cluster

4.4.3 Default Schedule

By default, this script runs every 15 minutes.

4.4.4 Setting Parameter Values

Set the following parameters as needed:

Parameter

How to Set It

Event Notification

Raise event when memory active exceeds the threshold?

Select Yes to raise an event when memory active exceeds the threshold you set. The default is unselected.

Event severity when memory active exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which memory active exceeds the threshold. The default is 15.

Raise event when memory balloon used exceeds the threshold?

Select Yes to raise an event when memory balloon used exceeds the threshold you set. The default is Yes.

Event severity when memory balloon used exceeds the threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which memory balloon used exceeds the threshold. The default is 15.

Raise event when memory granted exceeds the threshold?

Select Yes to raise an event when memory granted exceeds the threshold you set. The default is unselected.

Event severity when memory granted exceeds the threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which memory granted exceeds the threshold. The default is 15.

Raise event when memory swap used exceeds the threshold?

Select Yes to raise an event when memory swap used exceeds the threshold you set. The default is Yes.

Event severity when memory swap used exceeds the threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which memory swap used exceeds the threshold. The default is 15.

Raise event when memory usage exceeds the threshold?

Select Yes to raise an event when memory usage exceeds the threshold you set. The default is Yes.

Event severity when memory usage exceeds the threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which memory usage exceeds the threshold. The default is 15.

Raise event when memory metrics are not available?

Select Yes to raise an event if the memory metrics are not available. The default is Yes.

Event severity when memory metrics are not available

Set the event severity level, from 1 to 40, to indicate the importance of an event in which AppManager failed to retrieve metrics from vCenter. The default is 15.

Event severity when AppManager failed to get metrics

Set the event severity level, from 1 to 40, to indicate the importance of an event in which AppManager failed to retrieve metrics from vCenter. The default is 15.

Event severity when AppManager failed to log in

Set the event severity level, from 1 to 40, to indicate the importance of an event in which AppManager failed to log in to vCenter. The default is 5.

Event severity when ClusterMemUsage job fails unexpectedly

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the ClusterMemUsage job fails unexpectedly. The default is 5.

Data Collection

Collect data for memory active?

Select Yes to collect cluster memory usage data for charts and reports. The default is unselected.

NOTE:Because VMware permits over-allocation of resources, it is possible for data collection to return cluster memory usage data points in excess of 100 percent.

Collect data for memory balloon used?

Select Yes to collect cluster memory balloon used data for charts and reports. The default is unselected.

NOTE:Because VMware permits over-allocation of resources, it is possible for data collection to return cluster memory balloon data points in excess of 100 percent.

Collect data for memory granted?

Select Yes to collect cluster memory granted data for charts and reports. The default is unselected.

Collect data for memory swap used?

Select Yes to collect cluster memory swap data for charts and reports. The default is unselected.

NOTE:Because VMware permits over-allocation of resources, it is possible for data collection to return cluster memory swap data points in excess of 100 percent.

Collect data for memory usage?

Select Yes to collect cluster memory usage data for charts and reports. The default is unselected.

NOTE:Because VMware permits over-allocation of resources, it is possible for data collection to return cluster memory usage data points in excess of 100 percent.

Monitoring

Maximum threshold for memory active

Specify the maximum percentage of cluster memory active that can occur before an event is raised. The default is 20 percent.

Maximum threshold for memory usage

Specify the maximum percentage of cluster memory usage that can occur before an event is raised. The default is 80 percent.

Maximum threshold for memory balloon used

Specify the maximum percentage of cluster memory balloon that can occur before an event is raised. The default is 20 percent.

Maximum threshold for memory granted

Specify the maximum percentage of cluster memory granted that can occur before an event is raised. The default is 1024 megabytes.

Maximum threshold for memory swap used

Specify the maximum percentage of cluster memory swap used that can occur before an event is raised. The default is 20 percent.