eG Agent JVM Memory Test

This test enables eG users to quickly detect and troubleshoot memory contentions in the eG agent’s JVM. By monitoring how the eG agent’s JVM is utilizing the memory available to it, the test proactively alerts eG users if it finds that the JVM is running out of free memory. This way, eG users are warned of probable slowness or failure of the eG agent that may be caused due to the lack of memory. Based on the usage reports provided by this test, eG users can figure out how to size the JVM, so as to ensure the continuous availability and peak performance of the eG agent.

Target of the test : Any system hosting the eG agent

Agent deploying the test : An internal agent

Outputs of the test : One set of results for the host being monitored

This test is disabled by default. To enable the test, go to the enable / disable tests page using the menu sequence : Agents -> Tests -> Enable/Disable, pick the desired Component type, set Performance as the Test type, choose the test from the DISABLED TESTS list, and click on the << button to move the test to the ENABLED TESTS list. Finally, click the Update button.

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 at which the specified host listens

Measurements made by the test

Measurement	Description	Measurement Unit	Interpretation
Maximum memory:	Returns the maximum amount of memory that the Java virtual machine will attempt to use. If there is no inherent limit then the maximum value will be returned.	MB	If you had configured the eG agent’s –Xmx setting with 512M, then the value of this measure will be 512 MB.
Current total memory:	Returns the total amount of memory in the Java virtual machine. The value returned by this method may vary over time, depending on the host environment.	MB	If you had configured the eG agent’s –Xrs setting with 214M, then the value of this measure will be 214 MB.
Current used memory:	Indicates the amount of memory that the JVM is using for the eG agent.	MB	The value of this measure is the difference between the value of the Current total memory and Current free memory measures. Ideally, the value of this measure should be low. A consistent rise in this value is a cause for concern.
Current free memory:	Indicates the amount of free memory in the JVM.	MB	Ideally, the value of this measure should be high. A consistent drop in this value is a cause for concern.
Maximum memory usage:	Indicates the percentage of maximum memory that is used by the eG agent.	Percent	The formula for calculating this measure is: (Current used memory / Maximum memory) *100 Ideally, the value of this measure should be low. If this value keeps growing closer to 100%, it indicates excessive memory usage by the eG agent, which in turn may cause the agent to fail or slow down. You may want to change the maximum memory configuration of the eG agent to avoid such an eventuality.

Note:

The Application Processes layer is also mapped to a Tcp Port Status test, which is disabled by default for the Windows Generic sever, just as in the case of the Generic server.