HomeDocumentation > Configuring and administering > Monitoring the health of the Apache Geronimo server > Monitoring components on Geronimo Server > Monitoring the server with predefined graphs and views

In Geronimo, a set of predefined graphs and views are provided for server monitoring, and a new account monitor is added with the authority only to view the graphs and views that are defined for server monitoring.

Monitoring the server using the newly added account

Before you can monitor the server using the new account, you must check prerequisite requirements with the default account and password: system/manager.

Prerequisite Requirements

To begin monitoring a server, it is necessary to first check the server you want to monitor is in the servers list. The list can be viewed by clicking Monitoring under the Server category after loging in to the administrative console using the default account and password: system/manager. When your server is not in the servers list, you need to add a server. Once the server is displayed in the servers list, you can view information such as IP address or hostname, Status (Online/Disabled), Snapshot Thread (running/stopped), and Snapshot Duration.

Make sure Status for the server to be monitored is online and Snapshot Thread is running before you monitor the server using the newly added account. If Status for your sever is Disabled, click the Enable link associated with the server to enable the server. If Snapshot Thread is stopped, click the Enable Query link associated with the server to enable snapshot querying. When the snapshot querying is enabled, the monitoring agent immediately begins taking statistics snapshots on the default interval of 5 minutes which can be changed by clicking the Edit link associated with the server.

How to use the new account

Follow these steps to monitor a server using the new account monitor. The default password for this account is password.

  1. Log on to the administrative console with user name monitor and password password. The navigation area on the left side of the page only contains the Server category under which there are four features:
    • Information shows how long the server has been active and displays information about the Java environment when the server was started.
      Note: IE cannot display the JVM memory usage graph in the administrative console, as the Adobe SVG plugin is no longer supported.
    • Java System Info displays the current system properties in the Java environment.
    • Thread Pools displays the status of the common thread pools.
    • Monitoring helps you view a number of server statistics and monitor the Web server performance.
  2. Click Monitoring to view the server list and monitor the server performance with defined graphs and views.

Note: This account only has the authority to view the graphs/views that are already defined. Log on to the administrative console with user name system and password manager to perform any configuration, including enabling/disabling snapshot collection, adding/editing views or graphs. For more information about how to monitor the performance of a server, see Monitoring components on Geronimo Server.

Introduction to the predefined graphs and views

Views

A view is used to bundle related graphs together for more manageable use. For example, all graphs related to a specific server can be bundled together. Two predefined views, TomcatWebConnector View and TomcatWebSSLConnector View, are provided to monitor the statistics for the Tomcat Web Connector and the Tomcat Web SSL Connector being used respectively. The following table lists the predefined graphs that are bundled to these two predefined views. See graphs for description of each graph.

Predefined Graphs Bundled to TomcatWebConnector View Predefined Graphs Bundled to TomcatWebSSLConnector View
JVM Heap Size Current JVM Heap Size Current
Active Request CountSSL Active Request Count
Busy Threads MaxSSL Busy Threads Max
Busy Threads CurrentSSL Busy Threads Current
Busy Threads MinSSL Busy Threads Min
Bytes ReceivedSSL Bytes Received
Bytes SentSSL Bytes Sent
Error CountSSL Error Count
Open Connections Current SSL Open Connections Current
Open Connections MaxSSL Open Connections Max
Open Connections MinSSL Open Connections Min
Request Time CurrentTimeSSL Request Time CurrentTime
Request Time MaxTimeSSL Request Time MaxTime
Request Time MinTimeSSL Request Time MinTime
Request Time TotalTimeSSL Request Time TotalTime

Graphs

A set of graphs that are predefined for server monitoring are listed as follows with definitions:

  • JVM Heap Size Current — Current heap size of JVM

  • Active Request Count — Number of active connections for the connector
  • Busy Threads Max — Maximum number of busy threads for the connector
  • Busy Threads Current — Number of current busy threads for the connector
  • Busy Threads Min — Minimum number of busy threads for the connector
  • Bytes Received — Number of bytes received by the connector
  • Bytes Sent — Number of bytes sent by the connector
  • Error Count — Number of errors detected by the connector
  • Open Connections Current — Number of current open connections for the connector
  • Open Connections Max — Maximum number of open connections for the connector
  • Open Connections Min — Minimum number of open connections for the connector
  • Request Time CurrentTime — Current request processing time for the connector
  • Request Time MaxTime — Maximum request processing time for the connector
  • Request Time MinTime — Minimum request processing time for the connector
  • Request Time TotalTime — Total request processing time for the connector

  • SSL Active Request Count — Number of active connections for the SSL connector
  • SSL Busy Threads Current — Number of current busy threads for the SSL connector
  • SSL Busy Threads Max — Maximum number of busy threads for the SSL connector
  • SSL Busy Threads Min — Minimum number of busy threads for the SSL connector
  • SSL Bytes Received — Number of bytes received by the SSL connector
  • SSL Bytes Sent — Number of bytes sent by the SSL connector
  • SSL Error Count — Number of errors detected by the SSL connector
  • SSL Open Connections Current — Number of current open connections for the SSL connector
  • SSL Open Connections Max — Maximum number of open connections for the SSL connector
  • SSL Open Connections Min — Minimum number of open connections for the SSL connector
  • SSL Request Time CurrentTime — Current request processing time for the SSL connector
  • SSL Request Time MaxTime — Maximum request processing time for the SSL connector
  • SSL Request Time MinTime — Minimum request processing time for the SSL connector
  • SSL Request Time TotalTime — Total request processing time for the SSL connector