Memory Usage – OS Test

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

Target of the test : Oracle VM Server

Agent deploying the test : A remote agent

Outputs of the test : One set of results for each powered-on VM of the Oracle VM Server being monitored.

Configurable parameters for the test
Parameters	Description
Test Period	How often should the test be executed.
Host	The host for which the test is to be configured.
Port	The port at which the specified Host listens. By default, this is NULL.
Oracle VM Manager, Oracle VM Manager User, Oracle VM Manager Password, and Confirm Password	This test remotely connects to the Oracle VM Manager that manages the monitored Oracle VM Server and uses the web services API of the Oracle VM Manager to pull out metrics of interest. To enable this test to communicate with the web services API, you first need to configure the test with the IP address or host name of the Oracle VM Manager. This can be done using the Oracle VM Manager text box. Then, you need to configure the test with the credentials of a user with Admin rights to the Oracle VM Manager. Use the Oracle VM Manager User and Oracle VM Manager Password parameters to configure these credentials. Finally, confirm the password by retyping it in the Confirm Password text box.
SSL	By default, the Oracle VM Manager is SSL-enabled. Accordingly, the SSL flag is set to Yes by default. This indicates that the eG agent will communicate with the Oracle VM Manager via HTTPS by default.
WebPort	By default,, the Oracle VM Manager listens on 7002. This implies that while monitoring an Oracle VM server via an SSL-enabled Oracle VM Manager, the eG agent, by default, connects to port 7002 of the Oracle VM Manager to pull out metrics. In some environments however, this default port may not apply. In such a case, against the WebPort parameter, you can specify the exact port at which the Oracle VM Manager in your environment listens so that the eG agent communicates with that port.
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 VMs Inside View	Administrators of some high security Oracle 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 Oracle VM server 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.
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.
Ignore WINNT	By default, the eG agent does not support the inside view for VMs executing on Windows NT operating systems. Accordingly, the Ignore WINNT flag is set to Yes by default.
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 memory	Indicates the total memory of this VM.	MB
Used memory	Indicates the used memory of this VM.	MB
Free memory	Indicates the free 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.
Memory utilized	Indicates the percent usage of 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 memory	Indicates the amount of memory, immediately available for allocation to a process or for system use.	MB	Not all of the Available memory is Free memory. Typically, Available 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 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 VM, the memory usage percent that the detailed diagnosis reports per process does not consider the OS cache memory.