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 Count

SSL Active Request Count

Busy Threads Max

SSL Busy Threads Max

Busy Threads Current

SSL Busy Threads Current

Busy Threads Min

SSL Busy Threads Min

Bytes Received

SSL Bytes Received

Bytes Sent

SSL Bytes Sent

Error Count

SSL Error Count

Open Connections Current

SSL Open Connections Current

Open Connections Max

SSL Open Connections Max

Open Connections Min

SSL Open Connections Min

Request Time CurrentTime

SSL Request Time CurrentTime

Request Time MaxTime

SSL Request Time MaxTime

Request Time MinTime

SSL Request Time MinTime

Request Time TotalTime

SSL 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