Release Notes for GroundWork Monitor



GroundWork Monitor Enterprise 8.1.0

GroundWork Monitor Enterprise | Version 8.1.0 | Release

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

This is an important release, one that has been anticipated for some time. With this release, all the major functionality of GroundWork Monitor 7.x versions that we plan to bring forward to 8.x is present. Parent child servers are now easily installed and supported without the need for GroundWork Professional Services assistance (though of course you are welcome to ask us for help), as is the Elastic connector (similar to LogBridge). We are also introducing the Transit Connection Generator (TCG), which fulfills several functions in GroundWork Monitor including feeding data from Nagios™ servers to the GroundWork Foundation data normalization layer. We are extending TCG for many more uses and plan to make it a major tool in the monitoring toolkit for the whole community to share.  

New features

GroundWork Monitor 8.1.0 offers new key features and improvements compared to the previous 8.0.1 release.

Parent Child Server Installations 

GroundWork Monitor 8.1.0 now allows for three additional installation modes in addition to the default "standalone" mode supported by versions 8.0.0 and 8.0.1. The new modes are: Parent, Parent-Managed-Child and Child-Managed-Child. These new modes allow you to configure GroundWork in distributed server configurations. The Child-Managed-Child mode is an entirely new way of delegating administration to remote teams and locations. 

Elastic Connector

The GroundWork Elastic connector updates the LogBridge functionality of GroundWork 7.x with an all-new, easy to use unified monitoring connection to Elastic Stack clusters. It's ready to use out-of-the-box, and works with existing Elasticsearch and Kibana installations you may already have in your infrastructure. You can now use GroundWork to track, notify and report on services based on Elastic Lucene queries.  

Dual Names, Dual Certs

GroundWork 8.1.0 allows you to address GroundWork servers with a primary and alternate DNS name, and associated certificates. This is useful when configuring front-end connections for user access with CA certs, and back-end connections with self-signed certs for management networks, as well as other purposes. 

Fixed issues

This section describes the fixes we have included in this release. As 8.1.0 is primarily a feature release, this number is relatively low. 

GROUNDWORK-271NeDi connector reports unreachable for hosts and servicesThis was due to not running. 
GROUNDWORK-374Hostgroups report state but there is no state for hostgroupsFixed.
GROUNDWORK-381Acknowledge service on dashboard is not workingThe SLA dashboard has this feature, and it works in all cases now. 
GROUNDWORK-576Occasional error on update with active network connectionFixed. 
GROUNDWORK-583SLA processing doesn't respect day borders if duration is more than one dayRare case, but SLA reports that were reprocessed over a day border could give you inconsistent output. Fixed. 
GROUNDWORK-588Host status is wrong (hosts can't be critical or warning)Fixed.
GROUNDWORK-649Add host top problems to Top Problems for groups that contain hostsIt just seemed like the right thing to do. 
GROUNDWORK-665Service list not working consistentlyIn the SLA dashboard, there's a handy widget called Service List. It's working fine now for all service types. 
GROUNDWORK-696Hosts Pending in Status view OK in NagiosThere's a little bit of latency still, but in general you won't see Pending state last long unless Nagios has it too. 
GROUNDWORK-702BSM notification message link is for old Status viewerFixed. 
GROUNDWORK-723Status view graph alignment needs tune-upFixed alignment. 
GROUNDWORK-726NeDi cleanup of landing pageThere were some html errors on this page that are now fixed. Don't blame NeDi, this was our doing. 
GROUNDWORK-728GroundWork Monitor: License, Error: Device allocation hard limit expiredFixed inconsistent messaging around the license limit being exceeded. 
GROUNDWORK-742Invalid ini dir running: check_wmi_plus.plThis plugin needs a little setup. See the docs, but it's easier now. 
GROUNDWORK-778Downtimes not removed when hosts deletedFixed. This actually affects version 7.2.1 as well, so we fixed it for both. 
GROUNDWORK-784Odd host added to Status with Google connector, no servicesThe host was named for the GCP availability zone and was added as a test of functionality for QA. We took it out so it wouldn't affect your license count. 
GROUNDWORK-789Orphaned downtimes are sometimes not deletedFixed.
GROUNDWORK-817Ack comments and Downtime comments doubled on Nagios hosts/servicesFixed. 
GROUNDWORK-833Copyright is 2019 in footerIt's 2020, so we updated the footer.
GROUNDWORK-835Rework the Service Group dialogIt's way easier to select servicegroup members now. Faster also. 
GROUNDWORK-836License reports Hard Limit on Soft Limit expirationFixed. 
GROUNDWORK-837Occasional failures to capture valid performance dataThis was a quoting problem, and is fixed. 
GROUNDWORK-840GroundWork does not start on host rebootFixed with a systemd unit file (you have to implement it).
GROUNDWORK-842Math Issue #1 - /api/perfdata calls with identical timeframes and intervals return different numbers of resultsAdjusted algorithm to pull data from InfluxDB correctly. 
GROUNDWORK-843Insight says and calculates correlation: yesterday when time period is 48 hours   Adjusted Insight dashboard to only show stats that make sense for the selected time range. 
GROUNDWORK-844Insight math use Raw Stats over Average StatsImproved the accuracy of the correlation and other stats in the Insight dashboard. 
GROUNDWORK-845Insight correlation Raw Data calculationImproved the accuracy of the correlation and other stats in the Insight dashboard. 
GROUNDWORK-860Elastic Network ELB metrics can't be savedIn the AWS connector for Network ELB metrics, adding your own new metrics didn't work. Fixed. 
GROUNDWORK-885Monarch container needs vi installedSometimes you need to edit a file in the monarch container. We added vi for you. 
GROUNDWORK-887Host "foundation" appears in Status SummaryIt's actually configurable now, and you can get rid of it or rename it, but it monitors the state of all your connectors. See docs. 
GROUNDWORK-899Fix usage message in monarch_assign_service_to_hostFixed. 
GROUNDWORK-928JavaScript error for hovering over menu Fixed.
GROUNDWORK-956Connectors: metrics list is not updated after metric removalActually, the removal did happen but wasn't visible until you refreshed the page. Now it is visible immediately. 
GROUNDWORK-965Events: incorrect icon for OK statusEvent viewer got an update and the icon was corrected. 
GROUNDWORK-995"Data too large" Elastic/Kibana exceptionsFixed. 
GROUNDWORK-999Dashboards > Status: Actions button does not expandIntermittent problem, fixed.
GROUNDWORK-1012Acknowledge issues: Notify contacts "list" link does not workActually, there's still a known issue here, but the link is removed at least.
GROUNDWORK-1021Nagios acknowledged property not setSometimes acknowledging a host or service wouldn't propagate to Nagios properly. This is fixed now. 
GROUNDWORK-1028Support link goes to knowledge base not main support pageFixed. 
GROUNDWORK-1037Curator failed with exit 1 on 8.0.1Fixed a misconfiguration of curator that caused it to crash.

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.0 are incompletely tested.If 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.
AcknowledgementsNo host down acknowledgement buttonThe Status Summary for a host does not include a button to acknowledge when a host is down.You can acknowledge this condition using the check boxes on the host listings and choosing "ack selected".
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 isn't 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. 
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. 
ReportsSome custom reports have errorsSome of the custom reports for availability  and events don't get created correctly. This issue will be fixed in a future release. 
LDAPIf you change the master cypher key, LDAP may fail to connectThere is an intermittent race condition that affects the LDAP connection when you update the master cypher. You won't be able to use LDAP to connect if this occurs. 
You can resolve this situation by restarting the groundwork container: 

cd gw8
docker-compose kill groundwork
docker-compose up -d groundwork
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 and replaced in a future version. 
SecurityChanging Master password does not workIt's possible to change the master password (and several other tokens) via the Administration-Security page.Do not change the master password. Doing so will not work, and may interrupt the transmission of monitoring data. This will be fixed in a future release. 

The issue can be corrected by removing lines containing webservices.acct.lastupdate.timestamp from /usr/local/groundwork/config/ in the Nagios container.


Supported Versions

Current supported versions of GroundWork Monitor Enterprise include the latest versions 8.1.0, 8.0.1, 8.0.0, 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.

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.