Overview

This page references various configuration for the GroundWork Monitor portlets.

1.0 Host Information Portlet

1.1 Related Links

1. The Related Links section in the Host Information portlet enables the display of custom links for access to related information. This portlet is used in the Status application at the host level and the related links section is configurable by an administrator. This portlet can also be added to a custom dashboard and the related links are configured when editing preferences. Only administrators and operators users can see the links in this section.
2. As root user, edit the following file:

   vi /usr/local/groundwork/config/status-viewer.properties

3. In the section for Host Information, add or edit URL lines using the required format:

   # Custom URLs to be used in Information Portlets (just in StatusViewer and NOT in Dashboard)
   # HOST INFORMATION
   # Note: URL should be specified in this format: http://www.google.com. Formats other than this are invalid.
   # User can use $HOST$ token in the URL like - http://$HOST$/sample_page.html
   portal.statusviewer.host.custom.url.1=http://www.google.com
   portal.statusviewer.host.custom.url.1.display.name=GOOGLE
   portal.statusviewer.host.custom.url.2=
   portal.statusviewer.host.custom.url.2.display.name=
   portal.statusviewer.host.custom.url.3=
   portal.statusviewer.host.custom.url.3.display.name=
   portal.statusviewer.host.custom.url.4=
   portal.statusviewer.host.custom.url.4.display.name=
   portal.statusviewer.host.custom.url.5=
   portal.statusviewer.host.custom.url.5.display.name=

4. Save the file (e.g., Esc, :x).
5. Restart GroundWork services:

   /etc/init.d/groundwork restart gwservices

2.0 Seurat Portlet

This section reviews the configurable features available for the Seurat portlet. Parameters related to portal.statusviewer.seurat are in the status-viewer.properties file.

2.1 Recently Recovered Time

To set how long a recently recovered element remains in an OK state (green):

1. Edit the following file:

   vi /usr/local/groundwork/config/status-viewer.properties

2. Change the value which indicates the time in minutes a recently recovered element will display an OK status (green). The default time is 15 minutes.

   #recently recovered time in minutes
   portal.statusviewer.seurat.recentRecoveryTimeInMinutes=15

3. Save the file (e.g., Esc, :x).
4. Restart GroundWork services:

   /etc/init.d/groundwork restart gwservices

2.2 Non-OK State Blinking Time

Host icons will blink indicating the item is in a non-OK state. Items will not flash on initial load, but will begin to show the flashing state after the first update (one minute cycle). To change the time a state change will cause an item to flash:

1. As root user, edit the following file:

   vi /usr/local/groundwork/config/status-viewer.properties

2. Change the specific state times of your choice. As stated, all settings are in minutes.

   #This section controls Enterprise View, Seurat View icons blink timing, all settings are in mins.
   portal.statusviewer.seurat.host.unscheduleddown=15
   portal.statusviewer.seurat.host.unreachable=2
   portal.statusviewer.seurat.host.troubled100p=15
   portal.statusviewer.seurat.host.troubled75p=15
   portal.statusviewer.seurat.host.troubled50p=15
   portal.statusviewer.seurat.host.troubled25p=15
   portal.statusviewer.seurat.host.scheduleddown=2
   portal.statusviewer.seurat.host.pending=2
   portal.statusviewer.seurat.host.recentlyrecovered=2
   portal.statusviewer.seurat.host.up=2
   portal.statusviewer.seurat.host.suspended=2
   portal.statusviewer.seurat.host.nostatus=2

3. Save the file, (e.g., Esc, :x).
4. Restart GroundWork services:

   /etc/init.d/groundwork restart gwservices

3.0 Service Information Portlet

3.1 Related Links

1. The Related Links section in the Service Information portlet enables the display of custom links for access to related information. This portlet is used in the Status application at the service level and the related links section is configurable by an administrator. This portlet can also be added to a custom dashboard and the related links are configured when editing preferences. Only administrators and operators users can see the links in this section.
2. As root user, edit the following file:

   vi /usr/local/groundwork/config/status-viewer.properties

3. In the section for Service Information, add or edit URL lines using the required format:

   # SERVICE INFORMATION
   # Note: URL should be specified in this format: http://www.google.com. Formats other than this are invalid.
   # User can use $HOST$ and/or $SERVICE$ tokens in the URL like - http://$HOST$/index.html?servie_name=$SERVICE$
   portal.statusviewer.service.custom.url.1=
   portal.statusviewer.service.custom.url.1.display.name=
   portal.statusviewer.service.custom.url.2=
   portal.statusviewer.service.custom.url.2.display.name=
   portal.statusviewer.service.custom.url.3=
   portal.statusviewer.service.custom.url.3.display.name=
   portal.statusviewer.service.custom.url.4=
   portal.statusviewer.service.custom.url.4.display.name=
   portal.statusviewer.service.custom.url.5=
   portal.statusviewer.service.custom.url.5.display.name=
   

4. Save the file (e.g., Esc, :x).
5. Restart GroundWork services:

   /etc/init.d/groundwork restart gwservices