GlassFish is an open source application server project sponsored by Oracle corporation. Configure Site24x7 plugin to monitor the performance of your GlassFish servers.
This document details how to configure the Oracle GlassFish plugin and the monitoring metrics for providing in-depth visibility into the performance, availability, and usage stats of GlassFish servers.
GlassFish performance monitoring metrics:
Troubleshoot your GlassFish environment with ease by keeping track of critical metrics including:
Committed heap/non-heap memory
The metrics 'usedheapsize-count' and 'usednonheapsize-count' gives us the total amount of used heap/non-heap memory in bytes.
Maximum heap/non-heap memory
The metrics 'maxheapsize-count' and 'maxnonheapsize-count' gives us the maximum amount of heap/non-heap memory in bytes that can be used for memory management.
Initial heap/non-heap memory
The metrics 'initheapsize-count' and 'initnonheapsizecount' gives us the total amount of heap/non-heap memory in bytes that the JVM initially requests from OS for memory management.
Committed heap/non-heap memory
The metrics 'committedheapsize-count' and 'committednonheapsize-count' gives us the total amount of heap/non-heap memory in bytes that is committed for the JVM to use.
Object pending finalization
The metric 'objectpendingfinalization-count' gives us the approximate amount of objects for which finalization is pending.
Get information on the number of threads in deadlock waiting to acquire object monitors or ownable synchronizers using the metric 'deadlockedthreads'.
Get information on the number of threads created and also started since the JVM started using the metric 'totalstartedthreadcount'.
Get information on the number of live daemon threads using the metric 'daemonthreadcount'.
Monitor deadlocked threads
Get information on the number of threads in deadlock waiting to acquire object monitors using the metric 'monitordeadlockedthreads'.
Current thread user time
Get information on the CPU time for a thread executed in user mode using the metric 'currentthreadusertime'.
Peak thread count
Get information on the peak live thread count since the JVM started or peak was reset using the metric 'peakthreadcount'.
Get information on the number of live threads including daemon and non-daemon threads using the metric 'threadcount'.
Current thread CPU time
Get information on the total CPU time for the current thread in nanoseconds using the metric 'currentthreadcputime'.
Use the metric 'numpotentialconnleak' and get the number of potential connection leaks possible.
Logical connection released
Use the metric 'numconnreleased' and get the number of possible logical connections released to the pool.
Queued connection requests
Use the metric 'waitqueuelength' and get the number of connection requests in the queue waiting to be serviced.
Use the metric 'numconnfree' and get the number of free connections in the pool.
Use the metric 'averageconnwaittime' and get the average wait-time duration per successful connection request.
Connections timed out
Use the metric 'numconntimedout' and get the number of connections in the pool that timed out from start time.
Use the metric 'numconncreated' and get the total number of physical connections that were created since the last reset.
- Ensure GlassFish is installed in the server and it is up and running.
GlassFish plugin installation:
- Create seperate directories for all the three plugins with the name "glassfish_jvm_memory", "glassfish_jvm_thread", "glassfish_resource_connectionpool" under the Site24x7 Linux agent's plugin directory - /opt/site24x7/monagent/plugins/
cd /opt/site24x7/monagent/plugins/sudo mkdir glassfish_jvm_memorysudo mkdir glassfish_jvm_threadsudo mkdir glassfish_resource_connectionpool
- Download the file ""glassfish_jvm_memory.py" from our GitHub repository and place it under the "glassfish_jvm_memory" directory
cd glassfish_jvm_memorysudo wget https://raw.githubusercontent.com/site24x7/plugins/master/glassfish_jvm_memory/glassfish_jvm_memory.py
- Download the file "glassfish_jvm_thread.py" from our GitHub repository and place it under the "glassfish_jvm_thread" directory
cd glassfish_jvm_threadsudo wget https://raw.githubusercontent.com/site24x7/plugins/master/glassfish_jvm_thread/glassfish_jvm_thread.py
- Download the file "glassfish_resource_connectionpool.py" from our GitHub repository and place it under the "glassfish_resource_connectionpool" directory
cd glassfish_resource_connectionpoolsudo wget https://raw.githubusercontent.com/site24x7/plugins/master/glassfish_resource_connectionpool/glassfish_resource_connectionpool.py
Steps to enable monitoring in GlassFish server
- The following steps need to be peformed to enable monitoring for your GlassFish server:
cd /bin/asadmin./asadminset server.monitoring-service.module-monitoring-levels.jvm=LOWset server.monitoring-service.module-monitoring-levels.jdbc-connection-pool=LOW
GlassFish plugin configuration:
- The default python path given in the plugin script is #!/usr/bin/python. If you wish to provide an alternate python path, replace the existing one preceded by the shebang character "#!".
- Configure host and port values for the GlassFish plugin
HOST = "localhost"ADMINPORT = "4848"USERNAME = NonePASSWORD = None
- The same edits can be done for connection pool and thread plugins as well.
- Save the changes and restart the agent.
Monitoring additional metrics:
- To monitor additional metrics, edit any one of the plugin files and add the new metrics that need monitoring
- Increment the plugin version value in the plugin file to view the newly added metrics ( For e.g. Change the default plugin version from PLUGIN_VERSION = "1" to "PLUGIN_VERSION = "2")
- Redis plugin - Monitor performance metrics of your Redis databases
- MongoDB plugin - Monitor performance metrics of your MongoDB databases
- Memcached plugin - Analyze performance of your Memcached server
- Nagios plugin - Execute thousands of Nagios plugins in Site24x7 without the need of running a Nagios server
- Out-of-the-box plugins - Monitor your entire app stack with our extensive list of integrations
- Create custom plugins - Create custom Linux and Windows plugins and monitor custom attributes