Memory Usage - OS Test

This test reports statistics related to the usage of physical memory of the VMs.

Target of the Test: A RHEV Hypervisor

Agent running the test: A remote agent

Output of the test: One set of results for every VM on an RHEV server.

Configurable parameters for the test
Parameter	Description
Test period	How often should the test be executed.
Host	The host for which the test is to be configured.
Port	The port number at which the specified Host listens to. By default, this will be 31438.
RHEL MGR Host, RHEL MGR Port, RHEL MGR Domain, RHEL MGR User RHEL MGR Password	To auto-discover the VMs on a target RHEV hypervisor and obtain the outside view of the performance of each VM, the eG agent needs to connect to the RHEV Manager that manages the target RHEV hypervisor. To enable the eG agent to obtain the outside view, you need to configure the test with the following: RHEL MGR Host - The IP address/host name of the RHEV manager that the eG agent should connect to. RHEL MGR Port - The port number at which the said RHEV manager listens. RHEL MGR Domain - The domain to which the RHEV manager belongs. RHEL MGR User and RHEL MGR Password - The credentials of a user with read-only access to the Restful API on the RHEV manager. To know how to create a read-only role and assign it to a user, follow the steps detailed in Configuring the eG Agent to use the RESTful APIs on the RHEV Manager to Obtain the “Outside View”. If the RHEV hypervisor being monitored was discovered via an RHEV manager, then the IP address, port number, domain name, and user credentials of the RHEV manager used for discovery will be automatically displayed against the respective parameters. If the RHEV hypervisor being monitored was not discovered via an RHEV manager, but you still want to use an RHEV manager for obtaining the outside view, then, you can select any IP address of your choice from the RHEL MGR host list. By default, this list will be populated with the IP addresses/host names of all the RHEV managers that were configured for the purpose of discovering the RHEV hypervisors. If you select an RHEL MGR host from this list, then the corresponding port number, domain name, and user credentials will be automatically displayed against the respective parameters. On the other hand, if the RHEV manager that you want to use for metrics collection is not available in the RHEL MGR Host list, then, you can configure an RHEV manager on-the-fly by picking the Other option from the RHEL MGR Host list. An ADD THE RHEV MANAGER DETAILS window will then pop up. Refer to Configuring an RHEV Manager to Use for Monitoring the RHEV Hypervisor to know how to add an RHEV manager using this window. Once the RHEV manager is added, its IP address, port number, domain name and user credentials will be displayed against the corresponding parameters.
Confirm Password	Confirm the RHEL MGR Password by retyping it here.
SSL	If the RHEV manager to which the eG agent should connect is SSL-enabled, then set this flag to Yes. If not, set it to No.
Ignore VMs Inside View	Administrators of some high security RHEV environments might not have permissions to internally monitor one/more VMs. The eG agent can be configured to not obtain the 'inside view' of such ‘inaccessible’ VMs using the Ignore VMs Inside View parameter. Against this parameter, you can provide a comma-separated list of VM names, or VM name patterns, for which the inside view need not be obtained. For instance, your ignore VMs inside view specification can be: xp,lin,win,vista. Here, the * (asterisk) is used to denote leading and trailing spaces (as the case may be). By default, this parameter is set to none indicating that the eG agent obtains the inside view of all VMs on an RHEV host by default. Note: While performing VM discovery, the eG agent will not discover the operating system of the VMs configured in the Ignore VMs Inside View text box.
Exclude VMs	Administrators of some virtualized environments may not want to monitor some of their less-critical VMs - for instance, VM templates - both from 'outside' and from 'inside'. The eG agent in this case can be configured to completely exclude such VMs from its monitoring purview. To achieve this, provide a comma-separated list of VMs to be excluded from monitoring in the Exclude VMs text box. Instead of VMs, VM name patterns can also be provided here in a comma-separated list. For example, your Exclude VMs specification can be: xp,lin,win,vista. Here, the * (asterisk) is used to denote leading and trailing spaces (as the case may be). By default, this parameter is set to none indicating that the eG agent obtains the inside and outside views of all VMs on a virtual host by default. By providing a comma-separated list of VMs/VM name patterns in the Exclude VMs text box, you can make sure the eG agent stops collecting 'inside' and 'outside' view metrics for a configured set of VMs.
Ignore WINNT	By default, the eG agent does not support the inside view for VMs executing on Windows operating systems. Accordingly, the Ignore WINNT flag is set to Yes by default.
Inside View Using	By default, this test obtains the “inside view” of VMs using the eG VM Agent. Accordingly, the Inside view using flag is set to eG VM Agent by default. The eG VM Agent is a piece of software, which should be installed on every VM on a hypervisor. Every time the eG agent runs this test, it uses the eG VM Agent to pull relevant 'inside view' metrics from each VM. Once the metrics are collected, the eG agent then communicates with each VM agent and pulls these metrics, without requiring administrator privileges. Refer to Configuring the Remote Agent to Obtain the Inside View of VMs for more details on the eG VM Agent.
Domain, Admin User, and Admin Password, and Confirm Password	By default, these parameters are set to none. This is because, by default, the eG agent collects 'inside view' metrics using the eG VM agent on each VM. Domain administrator privileges need not be granted to the eG agent if it uses this default approach to obtain the 'inside view' of Windows VMs.
Report By User	While monitoring a RHEV Hypervisor, the Report By User flag is set to No by default, indicating that by default, the guest operating systems on the hypervisor are identified using the Hostname specified in the operating system. On the other hand, while monitoring a RHEV Hypervisor - VDI, this flag is set to Yes by default; this implies that in case of the VDI model, by default, the desktops will be identified using the login of the user who is accessing them. In other words, in VDI environments, this test will, by default, report measures for every username_on_virtualmachinename.
Report Powered OS	This flag becomes relevant only if the Report By User flag is set to ‘Yes’. If the Report Powered OS flag is set to Yes (which is the default setting), then this test will report measures for even those VMs that do not have any users logged in currently. Such guests will be identified by their virtualmachine name and not by the username_on_virtualmachinename. On the other hand, if the Report Powered OS flag is set to No, then this test will not report measures for those VMs to which no users are logged in currently.
Exclude IP	Typically, when performing VM discovery, the eG agent automatically discovers the operating system on which every VM runs, and all the IP addresses that each VM supports. If two are more VMs on a target vSphere server are in a VM cluster, then the eG agent will also auto-discover the cluster IP address. Since the cluster IP address is shared by all VMs in the cluster, this IP address will be in the discovery list of every VM in the cluster. In this case, if the eG agent attempts to obtain the 'inside view' of each VM in a cluster using their cluster IP address, incorrect metrics may be reported sometimes. To avoid this, you may want to instruct the eG agent to not use the cluster IP address when collecting 'inside view' metrics. For this, specify a comma-separated list of cluster IP addresses to be excluded in the EXCLUDE IP text box.
Group Processes with Arguments	By default, the detailed diagnosis of the Used physical memory measure of this test reports the number of instances of each process running on the VM, and the aggregated memory usage (in MB and %) of every process across all its instances. For example, if users to a VM are together having 15 instances of Chrome open on the machine at around the same time, then the detailed diagnosis of the Used physical memory measure will compute and display the collective memory usage of all 15 instances against the Application Name, Chrome. From this, you can quickly identify the exact process that is 'collectively' (i.e., across its instances) over-utilizing the memory. Sometimes, administrators might want to isolate not just the process, but also similar process arguments that are guilty of abnormal memory consumption. This granular insight will take administrators closer to the root-cause of the memory bottleneck on a desktop. For instance, in the Chrome example above, say 8 of the 15 instances are used to access the same YouTube video, and 7 instances are accessing a shopping site. In such a case, if memory usage is aggregated at the URL-level and not the process-level, then administrators can quickly identify which precise URL is draining memory - the YouTube video? or the shopping site? For this, detailed diagnostics should be grouped by process arguments (eg., URLs) and not just by process/application names. To enable grouping by arguments, set the Group Processes With Arguments flag to Yes. By default, this flag is set to No.
Memory Utilization in Percent	By default, this parameter is set to 75 percentage indicating that by default this test will display top-10 memory intensive processes on a VM in the detailed diagnosis of the Physical memory utilized measure only when the memory utilization reaches/exceeds 75 percentage. On the other hand, if the memory utilization is lower than the value specified against this parameter, then, this test displays only top-3 memory intensive processes in the detailed diagnosis of the Physical memory utilized measure so as to conserve storage space on the database. However, this setting can be overridden if required.
Automated Action Enabled	A memory shortage caused due to memory space hogged by modified and standby memory lists has become an increasingly frequent and critical problem. The memory shortage can make a server stutter or run more slowly than usual. Such operational interruptions can make you spend more time on waiting for pages and programs to load, disturbing your work flow and leading to work delays. Moreover, memory shortage can not only impair user productivity, but can also bring crucial business processes to a halt, and can severely degrade overall user experience with the server. To avoid such an outcome, administrators need to rapidly empty the memory space unnecessarily hogged by the modified and standby memory lists. This way, administrators can ensure that adequate memory is always available for executing business-critical processes. To enable administrators to achieve this, eG Enterprise offers 'Automation Actions'. These actions are governed by the 'Automation Action Enabled' flag. This flag, if enabled, automatically initiates user-configured actions, so that the memory hogged by modified and standby memory lists can be cleared when memory utilization crosses a configured limit. Note: The 'Automation Action Enabled' parameters, once configured, will apply only to the chosen component. These settings will not be applied to other components even if the Apply to other components button is clicked in the Specific Test Configuration page.
Automation Memory Limit	This flag appears only if the Automated Action Enabled flag is enabled. In this text box, specify the upper limit for memory utilization in percentage beyond which this test should trigger user-configured automation actions. By default, 95 percentage is set against this parameter. When the memory utilization reaches/exceeds the value specified in this text box, the user-configured actions will be automatically triggered. However, you can override this settings if required.
Empty Modified Memory	This flag appears only if the Automated Action Enabled flag is enabled. Modified memory contains cached data and code that is not actively in use by processes, the system and the system cache. This memory needs to be written out before it will be available for allocation to a process or for system use. You can easily clear this memory using the Empty Modified Memory flag. By default, this flag is set to No. When this flag is set Yes, amount of memory assigned to the modified list will be automatically cleared if the memory utilization reaches/exceeds the value specified against the Automation Memory Limit parameter.
Empty Standby Memory	This flag appears only if the Automated Action Enabled flag is enabled. Standby memory is a page of physical memory that is not actively used. When writing a series of frequently used information in the memory area, the programs and services running on the server will use part of memory as cache. The cache should be released and made available after executing programs and services. If the standby memory is not cleared on a regular basis, it can slow down the server operations. Therefore, it is necessary to clear the standby memory at regular intervals. This can easily done using the Empty Standby Memory flag. By default, this flag is set to No. When this flag is set Yes, memory that is allocated to the standby page list will be automatically cleared if the memory utilization reaches/exceeds the value specified against the Automation Memory Limit parameter.
Detailed Diagnosis	To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option. The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled: The eG manager license should allow the detailed diagnosis capability Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.

Measurements made by the test
Measurement	Description	Measurement Unit	Interpretation
Total physical memory	Indicates the total physical memory of this VM.	MB
Used physical memory	Indicates the used physical memory of this VM.	MB
Free physical memory	Indicates the free physical memory of the VM.	MB	This measure typically indicates the amount of memory available for use by applications running on the target VM. On Unix operating systems (AIX and Linux), the operating system tends to use parts of the available memory for caching files, objects, etc. When applications require additional memory, this is released from the operating system cache. Hence, to understand the true free memory that is available to applications, the eG agent reports the sum of the free physical memory and the operating system cache memory size as the value of the Free physical memory measure while monitoring AIX and Linux guest operating systems.
Physical memory utilized	Indicates the percent usage of physical memory by this VM.	Percent	Ideally, the value of this measure should be low. While sporadic spikes in memory usage could be caused by one/more rogue processes on the VM, a consistent increase in this value could be a cause for some serious concern, as it indicates a gradual, but steady erosion of valuable memory resources. If this unhealthy trend is not repaired soon, it could severely hamper VM performance, causing anything from a slowdown to a complete system meltdown. You can use the detailed diagnosis of this measure to figure out which processes on the VM are consuming memory excessively.
Available physical memory	Indicates the amount of physical memory, immediately available for allocation to a process or for system use.	MB	Not all of the Available physical memory is Free physical memory. Typically, Available physical memory is made up of the Standby List, Free List, and Zeroed List. When Windows wants to trim a process' working set, the trimmed pages are moved (usually) to the Standby List. From here, they can be brought back to life in the working set with only a soft page fault (much faster than a hard fault, which would have to talk to the disk). If a page stays in the standby List for a long time, it gets freed and moved to the Free List. In the background, there is a low priority thread (actually, the only thread with priority 0) which takes pages from the Free List and zeros them out. Because of this, there is usually very little in the Free List. All new allocations always come from the Zeroed List, which is memory pages that have been overwritten with zeros. This is a standard part of the OS' cross-process security, to prevent any process ever seeing data from another. If the Zeroed List is empty, Free List memory is zeroed and used or, if that is empty too, Standby List memory is freed, zeroed, and used. It is because all three can be used with so little effort that they are all counted as "available". A high value is typically desired for this measure.
Modified memory	Indicates the amount of memory that is allocated to the modified page list.	MB	This memory contains cached data and code that is not actively in use by processes, the system and the system cache. This memory needs to be written out before it will be available for allocation to a process or for system use. Cache pages on the modified list have been altered in memory. No process has specifically asked for this data to be in memory, it is merely there as a consequence of caching. Therefore it can be written to disk at any time (not to the page file, but to its original file location) and reused. However, since this involves I/O, it is not considered to be Available physical memory.
Standby memory	Indicates the amount of memory assigned to the standby list.	MB	This memory contains cached data and code that is not actively in use by processes, the system and the system cache. It is immediately available for allocation to a process or for system use. If the system runs out of available free and zero memory, memory on lower priority standby cache page lists will be repurposed before memory on higher priority standby cache page lists. Typically, Standby memory is the aggregate of Standby Cache Core Bytes,Standby Cache Normal Priority Bytes, and Standby Cache Reserve Bytes. Standby Cache Core Bytes is the amount of physical memory, that is assigned to the core standby cache page lists. Standby Cache Normal Priority Bytes is the amount of physical memory, that is assigned to the normal priority standby cache page lists. Standby Cache Reserve Bytes is the amount of physical memory, that is assigned to the reserve standby cache page lists.
Cached memory	This measure is an aggregate of Standby memory and Modified memory.	MB

Note:

While monitoring Linux/AIX guest operating systems, you may observe discrepancies between the value of the Physical memory utilized measure and the memory usage percentages reported per process by the detailed diagnosis of the same measure. This is because, while the Physical memory utilized measure takes into account the memory in the OS cache of the Linux/AIX VM, the memory usage percent that the detailed diagnosis reports per process does not consider the OS cache memory.