4.21 ResourcePoolMemUsage

This script monitors memory metrics for the vSphere resource pool. It raises an event if a monitored metric exceeds the threshold you set. In addition, this script generates a data stream for percentage of memory used and the amount of memory balloon in megabytes per second. This script monitors and collects data for the following performance metrics:

  • Memory active - Sum of active memory for all powered-on virtual machines in the resource pool.

  • Memory balloon - The sum of values for all memory balloon values for all powered-on virtual machines in the resource pool.

  • Memory consumed - Sum of all memory used by all powered-on virtual machines in the resource pool.

  • Memory granted - Sum of all granted memory for all powered-on virtual machines in the resource pool.

NOTE:This script will not work with existing ResourcePoolMemUsage jobs. As a result, you will need to start new ResourcePoolMemUsage jobs after installing this release.

  • Memory usage - Percentage of available machine memory usage.

4.21.1 Prerequisite

To enable the Knowledge Script to collect accurate memory related data for a resource pool, 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_ResourcePoolMemUsage 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 the vCenter, see the VMware Virtual Infrastructure 3 documentation.

4.21.2 Resource Objects

  • vSphere resource pool

  • vSphere virtual appliance (vApp)

4.21.3 Default Schedule

By default, this script runs every 15 minutes.

4.21.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 the threshold

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

Raise event when memory balloon exceeds the threshold?

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

Event severity when memory balloon exceeds the threshold

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

Raise event when memory consumed exceeds the threshold?

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

Event severity when memory consumed exceeds the threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which memory consumed exceeds the threshold you set. 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 you set. 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 unselected.

Event severity when memory usage exceeds threshold

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

Raise event when memory metrics are not available?

Select Yes to raise an event if 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 memory metrics are not available. 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 ResourcePoolMemUsage job fails unexpectedly

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

Data Collection

Collect data for memory active?

Select Yes to collect data about memory active for charts and reports. The default is unselected.

Collect data for memory balloon?

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

Collect data for memory consumed?

Select Yes to collect data about memory consumed for charts and reports. The default is unselected.

Collect data for memory granted?

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

Collect data for memory usage?

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

Monitoring

Maximum threshold for memory active

Specify the maximum amount of memory active that can occur before an event is raised. The default is 1024 MB.

Maximum threshold for memory balloon

Specify the maximum amount of memory balloon that can occur before an event is raised. The default is 100 KB.

Maximum threshold for memory consumed

Specify the maximum amount of memory consumed that can occur before an event is raised. The default is 1024 MB.

Maximum threshold for memory granted

Specify the maximum amount of memory granted that can occur before an event is raised. The default is 1024 MB.

Maximum threshold for memory usage

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