Chapter 6. JBoss Operations Network (JON) Plug-in
The GateIn JON plug-in itself does not provide any operations; it's sole purpose is reporting and statistics relating to applications/portlets and sites. The JBoss Operations Network AS plug-in supports many management operations, and is included in the portal binaries. With the AS plug-in, the following non-exhaustive list of actions are possible:
- Server control: start, stop, restart.
- Application control: deploy, and remove EAR and WAR applications.
- Resource control: manage other components of the platform, such as data sources.
For detailed information about JBoss Operations Network, and how it can be used to manage platforms, see the How to Manage JBoss Servers guide, chapter JBoss Operations Network available from https://access.redhat.com/site/documentation/en-US/Red_Hat_JBoss_Operations_Network/.
6.1. Metrics Collected by JON Plug-in
The metrics collected by the GateIn JON plug-in include site and application/portlet statistics. Each portlet contains statistics relevant to the individual portlet, and one additional throughput statistic for site portlets. See, table Site and Portlet Statistics for a description of the available metrics.
Note
The discovery of sub-resources such as Sites and Portlet Applications is performed once a day by JON. Hence, it is normal that new Sites and Applications do not appear immediately in JON, unless one triggers a manual discovery.
The manual discovery can be triggered in the JON UI, under the top level server node for example,
"localhost.localdomain" > Operations > Schedules > New > Operation: "Run Autodiscovery", Detailed Discovery: yes.
The metrics and statistics are runtime only values, and do not persist on the server. When the server is restarted, the runtime values are reset. JBoss Operations Network keeps a history of these statistics and metrics to give an accurate view of the data over time.
Table 6.1. Site and Portlet Statistics
|
Metric
|
Description
|
|---|---|
|
Average Execution Time
|
The average execution time in seconds for a page or application/portlet to render within a site.
|
|
Execution Count
|
The amount of times the application/portlet or site has been accessed.
|
|
Maximum Execution Time
|
The maximum execution time in seconds for a page or application/portlet to render within a site.
|
|
Minimum Execution Time
|
The minimum execution time in seconds for a page or application/portlet to render within a site.
|
|
Throughput (only for site portlets)
|
The number of requests per second for a site.
|
6.2. About JBoss Operation Network Plug-in
The portal provides a JBoss Operations Network plug-in (GateIn JON Plug-in) to assist with monitoring the platform.
The plug-in captures application/portlet and site statistics. A different set of statistics are collected depending on the context of each portlet. The basic JON interface is shown in Figure 6.1, “GateIn JON Plug-in Interface”.
Follow the download and installation instructions in the Installation Guide to activate administration and monitoring.