Apache Geronimo is an open source J2EE/Java EE 5 web application server that integrates open source projects to create Java/OSGi server runtimes that meet the needs of enterprise developers and system administrators. Geronimo can host a variety of server applications and boasts a large base of users. It comes equipped with a relational database server and message broker, enabling you to immediately deploy your enterprise applications. With all this potential, monitoring Apache Geronimo can be a daunting task.
Applications Manager aims to help administrators implement performance management of their Apache Geronimo application servers and the business-critical applications running on them. Let’s take a look at what you need to see to optimize your Apache Geronimo servers and the performance metrics that you can gather with Applications Manager:
Supported Versions of Apache Geronimo: Version 2.1.3 to 3.0.1
Prerequisites to monitor Apache Geronimo metrics: Click here
Using the REST API to add a new Apache Geronimo monitor: Click here
To create an Apache Geronimo Monitor, follow the steps given below:
Note:
In case you are unable to add the monitor even after enabling JMX, try providing the below argument:
-Djava.rmi.server.hostname=[YOUR_IP]
Go to the Monitors Category View by clicking the Monitors tab. Click on the Apache Geronimo Server monitors under the Application Servers Table. Displayed is the Apache Geronimo Server bulk configuration view distributed into three tabs:
Click on the monitor name to see all the server details listed under the following tabs:
| Field | Description |
|---|---|
| Display Name | The display name of Apache Geronimo monitor. |
| Host Name / IP Address* | The name or Ip address of the host where Apache Geronimo is running. |
| Port | The Port in which Apache Geronimo server is running. |
| JMX Port | The JMX port of the server. |
| Username | The Username of Apache Geronimo instance. |
| Password | The password of Apache Geronimo instance. |
| JNDI Path | The JNDI Path of the server |
| Parameter | Description |
|---|---|
| Server Response Time | The response time of the Geronimo server. |
| Used heap memory percentage | The percentage of heap memory used. |
| Free heap memory percentage | The percentage of heap memory free. |
| Used non-heap memory percentage | The percentage of non heap memory used. |
| Free non-heap memory percentage | The percentage of non heap memory free. |
| THREAD USAGE | |
| Daemon Thread Count | The number of live daemon threads. |
| Peak Thread Count | The peak count of active threads in the system. |
| Live Thread Count | The current number of live threads. |
| Total Thread Started | The total number of threads started since the java virtual machine started. |
| TRANSACTIONS | |
| Active Count | The number of active transactions. |
| Total Commits | The total number of transaction commits. |
| Total Rollbacks | The total number of transaction rollbacks. |
| Parameter | Description |
|---|---|
| Class Loading | |
| Loaded class count | The number of classes currently loaded in the java virtual machine. |
| Unloaded class count | The number of classes unloaded since the java virtual machine has started. |
| Total Class count | The total number of classes loaded since the java virtual machine has started execution. |
| Garbage Collector | |
| PC Scavenge Collection count rate | The number of garbage collections carried out by the PC Scavenge |
| PC Scavenge Collection time rate | The time taken to collect garbage by PC Scavenge |
| PC MarkSweep Collection time rate | No. of garbage collected by MarkSweep |
| PC MarkSweep Collection time rate | Time taken to collect garbage by MarkSweep |
| Memory Details | |
| Name | Heap Memory/ Non- Heap Memory usage in MB. |
| Committed | Current allocated memory in MB. |
| Max | Max allocated memory in MB. |
| Used | Current used memory in MB. |
| Free | Current free memory in MB. |
| Free% | The percentage of currently free memory. |
| Used% | The percentage of currently used memory. |
| Buffer Pool | |
| Direct Buffer Connection Count | The total connections to Direct Buffer pool. |
| Direct Buffer Space Used | The total space used in the Direct Buffer pool. |
| Direct Buffer Total Space | The total space in the Direct Buffer pool. |
| Mapped Buffer Connection Count | The total connections to Mapped Buffer pool. |
| Mapped Buffer Space Used | The total space used in the Mapped Buffer pool. |
| Mapped Buffer Total Space | The total space in the Mapped Buffer pool. |
| Parameter | Description |
|---|---|
| Web apps | |
| Context | Web application's context name |
| Active Sessions | Number of active sessions at this moment |
| Duplicate Sessions | Number of duplicated session ids generated |
| Expired Sessions | Number of sessions that expired. |
| Rejected Sessions | Number of sessions we rejected due to maxActive being reached |
| Session Average Alive Time | Average time an expired session had been alive. |
| Session Max Alive Time | Longest time an expired session had been alive. |
| Session Create Rate | Session creation rate in sessions per minute. |
| Session Expire Rate | Session expiration rate in sessions per minute. |
| Global Request Processor | |
| Connector Name | Connector name of the global request processor. |
| Request Count | Number of requests served by this global request processor. |
| Error Count | Number of error request received. |
| Processing Time | Time taken by this global request processor to process the requests in milliseconds. |
| Bytes Sent Per Second | Average bytes sent per second. |
| Bytes Received Per Second | Average bytes received per second. |
| Successful Request (%) | Percentage of successful requests. |
| Failed Request (%) | Percentage of failed requests. |
| Parameter | Description |
|---|---|
| Name | Name of the data source. |
| Active Connections | Number of active connections to the data source. |
| Idle Connections | Number of idle connections to the data source. |
| Parameter | Description |
|---|---|
| EJP Pool | |
| Name | Name of the EJB Pool |
| Active Instances | The no. of active instances |
| Idle Instances | The no. of idle instances. |
| Initializing Instances | The no. of initializing instances. |
| Pooled Instances | The no. of pooled instances. |
| Access Timeouts | The no. of times, access timeouts occurred. |
| Aged | The no. of aged instances. |
| Flushed | The no. of times, the pool is flushed. |
| Garbage Collected | The no. of times, the garbage collection occurred. |
| Parameter | Description |
|---|---|
| Apache ActiveMQ Broker | |
| Name | Name of the Active MQ Broker. |
| Memory Usage Percentage | The percentage of the memory limit . |
| Dequeue Count | Number of messages that have been acknowledged on the broker. |
| Enqueue Count | Number of messages that have been sent to the broker. |
| Consumer Count | Number of message consumers subscribed to destinations on the broker. |
| Message Count | Number of unacknowledged messages on the broker. |
| Temp Usage Percentage | Percent of temp limit used. |
| Store Usage Percentage | Percent of store limit used. |
| Apache ActiveMQ Topic | |
| Name | Name of the Active MQ queue. |
| Queue Size | Number of messages in the destination which are yet to be consumed. Potentially dispatched but unacknowledged. |
| Dequeue Count | Number of messages that have been acknowledged (and removed from) from the destination. |
| Enqueue Count | Number of messages that have been sent to the destination. |
| Dispatch Count | Number of messages that have been delivered (but potentially not acknowledged) to consumers. |
| Expired Count | Number of messages that have been expired. |
| InFlight Count | Number of messages that have been dispatched to, but not acknowledged by, consumers. |
| Consumer Count | Number of consumers subscribed to this destination. |
| Producer Count | Number of producers publishing to this destination. |
| Max Enqueue Time | The longest time a message has been held this destination. |
| Min Enqueue Time | The shortest time a message has been held this destination. |
| Avg Enqueue Time | Average time a message has been held this destination. |
| Memory Usage Percentage | The percentage of the memory limit used |
The Universal Description, Discovery and Integration (UDDI) protocol is one of the major building blocks required for successful Web services. UDDI creates a standard interoperable platform that enables companies and applications to quickly, easily, and dynamically find and use Web services over the Internet (or Intranet).
| Parameter | Description |
|---|---|
| Name | Name of the JUDDI implementation. |
| Failed API Queries | Count of API queries failed. |
| Successful API Queries | Count of successful API queries. |
| Total API Queries | Total number of API queries performed. |
| Parameter | Description |
|---|---|
| Name | Name of the cache. |
| Cache Max Size | Max size of the cache. |
| Cache Size | Current cache size. |
| Access Count | Number of times the cache is accessed. |
| Hit Count | Number of cache hits. |
Note: Geronimo provides built-in caches for Active MQ, juddi, open-ejb server and system-database.
| Parameter | Description |
|---|---|
| HostName/IP Address | Host name or IP address of the server. |
| Port | The port geronimo is running |
| Geronimo Installation Directory | The file directory where geronimo installed. |
| Geronimo Version | The version of the geronimo server. |
| Host OS | The operating system where the server is running. |
| JVM Vendor | Vendor of the virtual machine. |
| JVM version | Version of the virtual machine. |
