Release Notes for GroundWork Monitor



GroundWork Monitor Enterprise 8.1.2

These release notes describe the new features and improvements, known issues and limitations for GroundWork Monitor 8.1.2. They also provide announcements as of version 8.1.2, including currently supported and end-of-life versions of GroundWork Monitor. 

This is feature-rich release, and you will notice several welcome enhancements. As usual, we listened to our customers and made changes to enhance the usefulness of the user interface, along with repairing some missing or imperfect functions. Thanks to all those who contributed suggestions and reported issues. We love to hear from you anytime at Please read the Fixed Issues section below to see what has been addressed in this release. We recommend all users look through this section when upgrading, and for this release we want to make sure you do so, since so much has been added and changed.  

New features

GroundWork Monitor 8.1.2 has several new enterprise level features to announce. Please read on for details:

Updated Network Discovery

The Network Discovery portion of GroundWork provided by NeDi is now greatly enhanced, with many new UI screens, updated help, and better graphing, mapping and setup screens. We also updated our Policy Monitoring in the NeDi connector to allow more flexible tracking of connections in NetFlow traffic and packet capture. 

Status Filters

The Status Summary always sorts bad things to the top, so this feature isn't as essential as it was in older versions, but still it's nice to be able to filter by state as well as by name. 

Look for the new Monitor Status and Host Service Monitor Status filters located at the top of the Status dashboard. These filters will persist for your session, and apply to the objects you list. They are also present in the actions menus for the member lists.  » Learn more

Login Page Branding

You will see a new menu item Administration > Branding. This allows you to change logo images and add a text field of up to 2k to the login page. This is useful for access warnings or to explain to users what the system is for, and the logos allow you to personalize your copy of GroundWork, making it obvious what system you are logging into. » Learn more

Application Performance Monitoring Connector

We are seeing a trend in the industry towards code instrumentation for monitoring. This is a good thing, and one we have long advocated. While JMX monitoring has long been an option for Java apps (and we have a new profile for this), we are super-pleased to announce the Application Performance Monitoring (APM) connector. This all-new TCG Connector allows your developers to post data directly into the GroundWork Monitor system from running applications of virtually any type. The data shows up in easily processed form (metrics and status derived from thresholds), right next to all the data you gather from networks, cloud providers, and your data center systems. » Learn more

Separate Download for Custom Reporting Server

We constantly look for ways to improve GroundWork, both technically and in terms of honoring the commitments we have to our community, and so we decided to pull out, as a separate free download, the jasperserver container. We wanted to do this to honor the license restrictions pertaining to this reporting server, since it's really a stand-alone server and not a component feature of GroundWork Monitor. You can of course use it free, according to the terms of the Jasper Server license. This is the first containerized optional open source package we have done this with, but probably won't be the last! 

Make sure you read the installation and upgrade instructions to enable the Custom Reports menu option and use this free download. » Learn more

Fixed issues

This section describes the fixes we have included in the 8.1.2-GA release. 

GROUNDWORK-204Add timezone to timestamps in statusMinor UI enhancement. 
GROUNDWORK-476Status Summary does not update when Cloud Hub connector removedLong standing rare case of a problem deleting dynamic inventory on removal of a connector. This is now fixed. 
GROUNDWORK-503Merge in latest NeDi 2.0 into GW8Major update to Network Discovery features. 
GROUNDWORK-531Missing plugin check_casperjs.plThere's a useful little plugin to use phantomjs/casperjs scripting to test web sites we are now including. 
GROUNDWORK-569Event viewer filters contain impossible states for hosts, servicesWe were not careful enough to filter out the possible (in context) states from all states. This is fixed. 
GROUNDWORK-732SLA Dashboard service list not listing all host services in a host groupThere was an issue with a widget on the SLA dashboard not getting all the data it needed. Fixed. 
GROUNDWORK-754Add Alias to NOC BoardWe now show the host alias as a NOC Board column.
GROUNDWORK-758Add link to NOC BoardWe now show a link to any relevant Nagios CGI as a NOC Board column (t his was a feature request). 
GROUNDWORK-805More Actions button wrong shape, colorThe "More Actions" button is now the correct color and shape. 
GROUNDWORK-856Tab style needs to be more obviousMinor UI enhancement. 
GROUNDWORK-893Allow access to Cloud Hub connector screen if over license limit Sometimes you add a Cloud Hub connection and inadvertently start monitoring more hosts than your license allows. You can now access this screen and remove or scale back monitoring with Cloud Hub. 
GROUNDWORK-952Parent-managed-child Commit with empty host group still shows host groupThere is an edge case where a phantom (empty) host group got displayed, which is now suppressed. 
GROUNDWORK-1043Add ability to acknowledge any app type from the SLA/Business dashboardA feature request to add the acknowledge feature to the SLA dashboard was fulfilled. 
GROUNDWORK-1067Installer should exit on failed migrationSometimes firewall rules can block aspects of migration or installation. In such cases, the installer will now exit without actually doing anything, allowing you to adjust the firewall and retry. 
GROUNDWORK-1112Popup error messages should be visible only for defined interval of timePopup errors can occur when connections fail or are interrupted, or errors are exposed. These will now time out and not accumulate indefinitely. 
GROUNDWORK-1117Metrics, Synthetic Metric names and Custom names should not allow spacesMinor validation issue fixed. 
GROUNDWORK-1118Elastic Connector SyntheticsWe added the ability to create synthetic metrics using the Elastic connector. This improves the features available using this method to include monitoring ratios, calculated values, etc. 
GROUNDWORK-1119Allow Elastic Connector Group Naming by End UserEnhanced the naming of host groups to include user input, not just automatic field values from Elastic Stack. 
GROUNDWORK-1124NeDi connector improvementsWe revamped the policy monitoring for Network discovery, including NetFlow and packet capture. 
GROUNDWORK-1131NOC Board buttons disabled after form updateThe NOC Board had an error where it wasn't possible to update the board after updating it once. This is fixed. 
GROUNDWORK-1144Synchronizer aggressively takes host group ownershipA subtle issue with ownership setting that could make it difficult to remove host groups from the system in some situations has been fixed. 
GROUNDWORK-1153Connectors: Choose connector type is overlapped by main menuA simple UI issue in the connector screens. 
GROUNDWORK-1161LDAPS usability improvementsWe have greatly simplified and clarified the use of LDAPS. See documentation for details. 
GROUNDWORK-1164Metrics with unchecked graphs contain graphics on Status dashboardThe selection for graphs was ignored on some Cloud Hub and TCG connector configurations - graphs were always generated. 
GROUNDWORK-1166Synthetic Expression evaluation failing Synthetic expression evaluation was not working correctly for TCG connectors. This is fixed.
GROUNDWORK-1167Make option to show/hide Group Summary in NOC BoardThe NOC Board has an option to suppress the display of the summary portion of the screen when expanded.
GROUNDWORK-1170Connectors tab page refresh navigates user to another screenMinor UI issue was fixed. 
GROUNDWORK-1175Please add indication of logged in userFeature request for showing the logged in user was fulfilled (see the menu bar). 
GROUNDWORK-1177Form validation not needed for setting downtimeA validation of input was restricting valid input on the Downtime scheduler screen. Fixed. 
GROUNDWORK-1180Metrics: 500 error for adding metrics with decimal thresholdConnectors now support decimal (e.g., 0.5) values as thresholds.
GROUNDWORK-1191Monitored flag not handled for synthetics in some Cloud Hub connectorsIt wasn't always possible to set the monitored flag for synthetic metrics. Fixed. 
GROUNDWORK-1201Dashboards search field color improvementMinor UI issue fixed. 
GROUNDWORK-1205Ctrl limit reached in TCG NATs QueueWe were hitting a limit in the NATS queues in some connectors due to inadequate configuration settings. Fixed. 
GROUNDWORK-1208Preview of  Command "yiic downtime removeorphans"Feature request was made for this. When cleaning up old expired downtime records (for example on deleted hosts or services), it' now possible to run the deletion script by hand and get a listing of what would be deleted. 
GROUNDWORK-1210LDAP user names can be longer than the Monarch DB allowsWe made the Monarch DB take longer names. 
GROUNDWORK-1211Multiple NOC Boards sometimes refresh to the wrong oneNOC Board display bug was repaired. 
GROUNDWORK-1212NOC Board counts do not reflect filtersThe NOC Boards always displayed the counts from all services in the group, regardless of filter settings. This was changed to show only matching services. 
GROUNDWORK-1213Add CA Cert configuration to RevproxyWe now support private CA configurations in GW8 via the Entrypoint scripting. Previously this was possible only through manual adjustments. 
GROUNDWORK-1214Large child configuration does not sync to parentSome very large (10s of thousands of devices) configurations would fail to load on the parent server when sent to (or from) a child. This is fixed. 
GROUNDWORK-1216Adding and deleting users / admins should be recorded in audit logThis was a feature request, which we added. 
GROUNDWORK-1217Duplicate key error on device table when synchronizing child to parent inventoryThere was an issue with the process of synchronizing child inventory. This is fixed. 
GROUNDWORK-1224Elastic connector does not work with newest version 7.8.1 Elastic StackActually, it did work, but the port and URL changed. We updated the documentation. 
GROUNDWORK-1225Installer fails when no Internet availableWe had an issue with a specific container which was being pulled from an Internet registry instead of locally. This was fixed. 
GROUNDWORK-1226Installer should support command line optionsFeature request to support the --unattended and other command-line options on the installer was fulfilled.
GROUNDWORK-1228Wrong cursor used in alerts for close actionMinor UI bug. Fixed. 
GROUNDWORK-1230Adding downtimes for all services on a host is brokenWe inadvertently disabled a useful method of scheduling downtime using regex patterns. This is now restored. 
GROUNDWORK-1231Stopped containers should not be removed by Docker connectorWe had an issue where the stopping of a container would remove it from the UI, effectively disabling monitoring for it. This is fixed. 
GROUNDWORK-1232Decommission Nagios GW8 inventoryWe changed the way parent-child default inventory was added to be simpler. Actually we just took it out, since it was confusing. 
GROUNDWORK-1236GWMEE installer Welcome page should display correct versionWe enhanced the version display on the login page. 
GROUNDWORK-1240Containerize included connectors
GROUNDWORK-1244Maintain NOC Board column layout changesYou can re-arrange the columns in the NOC Board by dragging them, and now this re-arrangement will persist, where previously it did not. 
GROUNDWORK-1245Secure NOC Board Edit and Delete buttonsOnly the "admin" role can add, edit, or delete the NOC Boards now. 
GROUNDWORK-1249Add option to auto-expand NOC Board on page loadYou can select one (or more) NOC Boards on a page to auto-expand from the summary line. 
GROUNDWORK-1253Errors from tcg-elastic service not showing in connector status pageThere is a status page for each running connection, which was inaccurate. This is fixed. 
GROUNDWORK-1254$HOSTALIAS$ nagios standard macro not being passed to nomaThis was an issue when including the alias in notifications. This is now available. 
GROUNDWORK-1258Add filesystem monitoring to default docker profileThis was a routine enhancement to the monitoring we do with the Docker Cloud Hub connector by default. 
GROUNDWORK-1259Column titles in Connectors UI have resizable flagMinor UI issue fixed. 
GROUNDWORK-1265Stopping Cloud Hub Docker connector fails to update with NPEThere was an error in the shutdown of the Docker connector for Cloud Hub. This is fixed. 
GROUNDWORK-1272NOC Board pagination causes hang on navigationThere was a UI navigation error in the NOC Board, which is fixed. 
GROUNDWORK-1276First NOC Board created on every fresh install fails with errorThere was a harmless 500 error thrown each time you set up a new NOC Board. This is fixed. 
GROUNDWORK-1277NOC Boards created with "Add New Board" button don't fill defaults in UIMinor UI issue with the NOC Board. Fixed. 
GROUNDWORK-1278Improve synchronizer to handle service groupsThere was a bug in the synchronizer code that ignored Nagios defined service groups. They were not added to the Status UI. This is now fixed. 
GROUNDWORK-1279Connector status dates are suppressed in UIThere was another issue with the container status page we fixed. 
GROUNDWORK-1284Filter by stateFeature request added as noted above. 
GROUNDWORK-1287New User: uploading a photo always failsIf you create a new user, you couldn't upload a profile picture. 
GROUNDWORK-1289SNMP V3 not working correctly There was a missing library for SNMP plugins that use SNMP v3. This is now included. 
GROUNDWORK-1293Dynamic inventoryWe enhanced the way we add monitored resources to the system to be more dynamic, supporting on-the-fly additions and deletions as metrics are sent. 
GROUNDWORK-1295Deleting all default host groups breaks entire UITurns out there was an edge case when all hostgroups were deleted. Rare that you would want to do this, but it is fixed. 
GROUNDWORK-1302database slareport uses reserved word "group" for a table nameReserved word for a table name required a fix. It's now called "bsmgroup". 
GROUNDWORK-1311AWS Cloud Hub connector fails without explicit logsThere was an edge case where the AWS connector could stop unexpectedly. We fixed this, and the log messages. 
GROUNDWORK-1313Delete a downtime in the UI before it's regularly scheduled end time, the actual DT in Nagios persistsThere was a time zone issue with removing active downtimes from Nagios (not from GroundWork Foundation). This is now fixed. 
GROUNDWORK-1314Monarch and Nagios input/output must match the stored dataSome special characters in the Monarch database were not being displayed in Status Summary or the Nagios CGI interfaces correctly. 
GROUNDWORK-1319Errors in Nagios log on startupSome startup race conditions caused errors in the nagios container log. These were changed to warnings/info messages, as they are expected. 

Known issues

This section lists any known issues and limitations with work-arounds.

Monitoring PluginsSome plugins may not workThe plugins included with GroundWork Monitor 8.1.2 are incompletely testedIf you encounter a plugin you need to work that doesn't, please file a support case. We will get you a working version as soon as possible, and include it in later releases.
LDAPCannot delete user created by LDAP syncIf you sync LDAP to GroundWork, the users who log in are imported. There's not much point in deleting them unless you disconnect the LDAP server, but even if you do so, the delete function isn't working.There is a work-around, but then again there's no harm in leaving these user accounts alone. They will fail login once the LDAP server is inactive. If you really must delete them, please contact support. 
Business Service MonitoringDefault bsm-service-01 configured but emptyThe service bsm-service-01 on host bsm-host is included as an example of Business Service Monitoring. It is in the unknown state as the member list is empty. You can remove this (or add members) by going to the Configuration > BSM and SLAs > BSM > Manage Groups, and clicking the delete icon next to the group. 
Acknowledgements Notify Contacts check box does not workThere is a Notify Contacts checkbox on the Acknowledgment modal dialog that does not workDo not use this checkbox, It will be removed in a future version. 
Nagios ContainerIt's possible to overload the Nagios instance in GroundWorkNagios uses workers that communicate with the services it runs. In some cases the default provisioning isn't enough to keep up with a really active alert stream.You can override the default provisioning of workers in Nagios with the check_workers directive. See How to configure check_workers.
Docker ConnectorDocker connector does not detect service unknown on down containersTheres a bit of a strange look when a container goes down, since the services for memory and CPU etc. remain in an OK state. Use a ping to the container address to make sure you know  and get notified when a container dies. 
Custom ReportsOptional Jasper Server slow to startIf one starts the optional Jasper Server, it may take several minutes to become available. Wait several minutes after starting the system with the Jasper Server loaded before accessing the Custom Reports menu item. 
Status SummaryEmpty Connectors HostgroupThere's an empty hostgroup called Connectors that gets created. You can delete it under Configuration - Custom Groups - Hostgroups. It is harmless. 


Supported Versions

Current supported versions of GroundWork Monitor Enterprise include the latest versions 8.1.2, 8.1.1, 8.1.0, 8.0.1, and version 7.2.1. Support for version 7.2.1 will expire December 31, 2021.

For supported architectures and browser compatibility see System Requirements.

New Open Source Project

The GroundWork Transit Connection Generator (TCG) is open source and available on GitHub. Based on the popular NATS project, TCG allows connections between monitoring sources and GroundWork servers using the API to GroundWork Foundation. 

Copyright 2004-2020 GroundWork Open Source, Inc. ("GroundWork"). All rights reserved. Use is subject to GroundWork commercial license terms. GroundWork Monitor products are released under the terms of the various public and commercial licenses. For information on licensing and open source elements please see Licenses used in GroundWork. GroundWork, GroundWork Open Source, GroundWork Monitor Professional, GroundWork Monitor Open Source, GroundWork Community Edition, GroundWork Monitor Enterprise, GroundWork Foundation, GroundWork Status Viewer, Monarch, and GroundWork Guava are trademarks of GroundWork Open Source, Inc. Other trademarks, logos and service marks (each, a "Mark") used in GroundWork’s products, including Nagios, which is a registered trademark of Ethan Galstad, are the property of other third parties. These Marks may not be used without the prior written consent of GroundWork Open Source or the third party that owns the respective Mark.