Endeca Resource Usage Test

Endeca Server is a hybrid search-analytical engine that organizes complex and varied data from disparate sources and unifies search, navigation, and analytics to deliver fast answers on structured and unstructured data. The resource utilization including memory and disk usage by the Endeca server is crucial for its effective performance.

Excessive memory usage can cause significant deterioration in server performance. Endeca Resource Usage Test reports the memory usage of the Endeca server and the maximum memory that the server is configured to use along with that administrators are notified if the resident set size, disk usage, or throughput violates the acceptable limits.

Target of the test : An Endeca Search Application

Agent deploying the test : An internal agent

Outputs of the test : One set of results the Endeca search application being monitored.

Configurable parameters for the test

Parameter	Description
Test period	How often should the test be executed
Host	The IP address of the host for which this test is to be configured.
Port	The port at which the specified host listens to. The default port is 15000.
PerfStatURL	Specify the URL to access the page from which this test will be collecting the required statistics. The default URL will be in the format: http://{Endeca_Server_IP}:8000/admin?op=stats

Measurements made by the test

Measurement	Description	Measurement Unit	Interpretation
Number of requests	Indicates the number of requests given by the user.	Number
Resident set size	Indicates the size of the resident set allocated to the Endeca.	MB	The memory currently used by the server in the main memory is the Resident Set Size. When the resident set size is too small, performance can be affected.
Currently allocated memory	Indicates the total amount of memory allocated to the Endeca search engine.	MB	An unusually large usage of memory by the server which violates the current allocation is a cause of concern.
Heap size	Indicates the size of heap memory.	MB	To improve the performance of common functions such as displaying pages and performing searches, you can increase the heap size used by the server. When the heap size is too small, performance can be affected.
Max thread cache	Indicates the maximum size of thread cache.	MB	The value of this measure should be very low.
Current thread cache	Indicates the size of current thread cache.	MB
Free page heap	Indicates the size of free page in the heap memory.	MB	A high value is desired for this measure.
Unmapped page heap	Indicates the size of unmapped page in the heap memory.	MB
Current address space	Indicates the size of current address space.	MB
Throughput	Indicates the number of requests processed per second per server instance.	Requests/second	Ideally, the value for this measure should be high, if the value drops below acceptable levels then it indicates performance degradation in terms of latency.
Current disk usage	Indicates the amount of disk space used by the server.	MB	Ideally, the value of this measure should be low.
Disk usage high water mark	Indicates the higher threshold of disk space usage by the server.	MB	If the disk usage reaches high watermark value it can cause loss of data. Ideally, the value of this measure should be below the lower threshold that is the low watermark.