Page History

...

ExcerptThe Geronimo monitoring plug-in is broken down between server and client plug-ins, referred to as the 'Agent' and 'Console' respectively. When properly setup, these plug-ins provide both local and remote real-time JSR77 compliant statistic monitoring, as well as historical tracking of any exposed statistic with visual representations drawn in the form of graphs through the Dojo Toolkit's dojoX Charting packages.

Agent (Server) The Agent plug-in can be deployed headless on an instance of Geronimo requiring no administrative console able to be polled by the console plug-in from any instance of Geronimo that can communicate with it. There are two flavors of the Agent plug-in available; the first allowing for EJB connections, and the second allowing for JMX connections between the Console and Agent.

...

Select a server to monitor by providing a host name or IP address. Select the protocol for communication and any security credentials. Save this server definition by pressing Save.

Fill in the fields, and click Add. For example:

• Name=Local System
• IP/Hostname=localhost
• Protocol=[EJB/JMX] (The JMX protocol requires a plugin named agent-car-jmx must be installed and enabled.)
• Port=[4201/1099] (4201 for EJB and 1099 for JMX.)
• Username=system
• Password=manager
• Password(verify)=manager

Alternatively, it is possible to test the connection using the information provided via the Test these settings link on the right navigation pane.

After a server is successfully added, the browser will be redirected to the main monitoring console page, again listing all Views, Servers, and Graphs configured on the console.

If configuring monitoring on a freshly deployed instance of the monitoring agent, you need to click the Enable Query link associated with the added server. This will enable snapshot collection on the default duration of 5 minutes.

Adding a Graph

Select information to display by adding a graph. Select the server you are monitoring, and then choose an MBean that publishes server information by choosing an MBean from the MBean drop down control. Once you have selected an MBean, you can see what information is available by selecting data from the Data series drop down control. When you have described the data, save this graph by pressing Save.

Select more information to display by adding a second graph. As the two data series scroll in time, we will be able to detect any correlation between the data. Once again, choose a server and an MBean to monitor. Select data from the Data series drop down control. Since data sent increases over time, also select delta for the Data series, so we see the rise and fall of the data over time. Save this graph by pressing Save.

After the graph is added, the browser is redirected to the main monitoring console page, where selecting the name of the graph will open a window that displays the graph.

Adding a View

Now group one or more graphs into a view. Here we add a view for "JVM vs Bytes Sent" by selecting two of the graphs we created in earlier steps. Save the view by pressing Save.

...