v1.4.0

Release v1.4.0

Release Notes

Gogios v1.4.0 focuses on Prometheus integration, alert suppression for maintenance windows, peer failover alerting, and improved reporting — making Gogios more capable in heterogeneous monitoring environments.

Features

Prometheus Integration

Gogios can now scrape alerts from Prometheus Alertmanager and include them in monitoring reports. Configure one or more Prometheus hosts with automatic failover — if the first host is unreachable, Gogios tries the next. The Prometheus Watchdog alert receives special handling: its absence triggers a CRITICAL alert, ensuring you're notified if Alertmanager itself stops working.

Alert Suppression (OnlyIfNotExists)

Suppress alerts during planned maintenance by creating a simple marker file. Suppression works globally for all Prometheus alerts or per individual check, with a configurable maximum age so alerts automatically resume even if you forget to remove the file. Suppressed alerts appear in a dedicated section of reports for visibility.

Peer Failover Alerting

Configure a peer Gogios instance so that if your primary monitoring node goes down, the secondary can detect stale reports and raise alerts. This eliminates single points of failure in your monitoring infrastructure.

Minimum Notification Interval

New MinNotifyIntervalS setting batches email notifications over a configurable window, reducing alert noise during flapping or cascading failures. Emails are only sent when the interval has elapsed and a state change has occurred.

JSON Status Report

A machine-readable JSON report is now written alongside the HTML status page, enabling integration with dashboards, scripts, or other tooling.

Status Page Link in Emails

Email notifications now include a link to the HTML status page (StatusPageURL), giving recipients one-click access to the full report.

Improvements

• OK checks section added to the HTML status page for a complete view of all monitored services
• Stale alerts now exclude checks in OK status, reducing noise from benign staleness
• Summary line updated to C:# W:# U:# S:# SU:# OK:#, adding suppressed count
• Version management centralized into internal/version.go
• Error handling improved in main.go — Gogios now exits with a proper error code and message on failure
• OpenBSD cross-compilation fixed to use per-command environment variables instead of global os.Setenv, preventing side effects in the build process

Breaking Changes

• Status summary format changed from C:# W:# U:# S:# OK:# to C:# W:# U:# S:# SU:# OK:#. If you parse the subject line or summary string, update your parsing logic.
• State file fields output and federatedFrom are now exported (Output, FederatedFrom). Existing state files will lose these values on first run after upgrade, triggering a one-time re-notification.