GoAlert v0.34.1

This is a maintenance release that includes dependency updates, a memory leak fix, and a quality-of-life improvement for service monitoring.

🚀 New Features

Recent Events on Service Details

Service details pages now display an aggregated view of recent alert log entries, making it easier to quickly see what's been happening with a service without navigating to the full alerts page.

• service details: Add "Recent Events" as an aggregated alert log by @mastercactapus in #4389

🐛 Bug Fixes

Memory Leak Fix

Fixed a long-standing memory leak in the cycle monitor that could cause gradual memory growth over time in long-running deployments.

• engine: Fix cycle monitor leak by @mastercactapus in #4420

🔧 Improvements

Documentation Updates

• docs: Update recommended version to Postgres 17 by @mastercactapus in #4406
• docs: clarify Mailgun API Key instructions and add info to config by @mastercactapus in #4411

📦 Dependencies

This release includes comprehensive dependency updates for both Go and JavaScript packages to ensure security and compatibility.

• build(deps): bump the go-deps group across 1 directory with 18 updates by @dependabot[bot] in #4415
• build(deps-dev): bump vite from 6.2.7 to 6.3.6 by @dependabot[bot] in #4412
• build(deps-dev): bump the js-deps group across 1 directory with 53 updates by @dependabot[bot] in #4410
• build(deps): bump github.com/99designs/gqlgen from 0.17.80 to 0.17.81 in the go-deps group by @dependabot[bot] in #4417

Full Changelog: v0.34.0...v0.34.1

v0.34.1 Latest

Latest

Compare

Choose a tag to compare

GoAlert v0.34.0

We're excited to announce GoAlert v0.34.0! This release continues building on the foundation laid in v0.33.0, with significant improvements to messaging capabilities, administrative tools, and system reliability.

⚠️ Important: PostgreSQL Version Support

GoAlert v0.34.0 adds full support for PostgreSQL 17!

• ✅ Fully tested with PostgreSQL 13, 14, 15, 16, and 17 (all versions pass our complete test suite)
• 🏭 PostgreSQL 13 and 17 validated in production environments
• 📅 PostgreSQL 13 reaches EOL in November 2025
• ⭐ PostgreSQL 17 is now our recommended version for all deployments

For those looking to upgrade their DB without downtime (live migration from old to new), we have documentation around the Switchover feature here. As with any major DB change make sure to take, and validate, a full backup just in case.

While this isn't a new feature, it may be the first time some are hearing about it. For those interested, there is additional information about how it works here and here.

🚀 New Features

RCS Messaging Support

GoAlert now supports Rich Communication Services (RCS) through Twilio. If your Twilio messaging service is configured for RCS, GoAlert will automatically leverage the enhanced messaging capabilities including better delivery tracking and richer content support.

• notification/twilio: add base RCS support by @mastercactapus in #4315
• twilio/sms(RCS): Fix display bugs by @mastercactapus in #4328

Heartbeat Monitor Muting (API Only)

You can now mute heartbeat monitors during planned maintenance or expected downtime, preventing unnecessary alerts during known service interruptions. This helps reduce alert fatigue and keeps your alert history clean during maintenance windows.

• heartbeat: allow muting a heartbeat monitor by @mastercactapus in #4103

Calendar Subscription Enhancements

Calendar subscriptions now support JSON format in addition to existing iCal formats, and you can generate direct links for creating schedule overrides, making it easier to share override creation workflows with team members.

• calsub: Add JSON as a supported format for calendar subscriptions by @mastercactapus in #4196
• schedules: add support for linking directly to creating a new schedule override by @mastercactapus in #4242

Enhanced Alert Statistics

Services now expose detailed alert statistics through the GraphQL API (alertStats field), providing administrators with better insights into service performance and alert patterns for reporting and analysis.

• graphql: add alertStats field on Service by @mastercactapus in #4293
• fix: Correct Average Ack Time in reporting by @codylewandowski in #4375

Administrative Maintenance Tools

New admin maintenance page provides tools for system maintenance tasks, including the ability to re-encrypt stored data when needed for security or compliance requirements.

• admin: Add maintenance page, with action to re-encrypt data by @mastercactapus in #4323

Service Search Enhancement

The service search functionality now supports an "only" filter option, allowing for more precise filtering of services.

• Feat: ServiceSearch "only" by @weefatboi in #4384

🛠️ Universal Integration Keys Improvements

Continued enhancements to the experimental Universal Integration Keys feature (enabled with --experimental=univ-keys):

• uik: Add code editor for Expr fields by @mastercactapus in #4151
• adding info link to expr syntax by @ethan-haynes in #4194
• uik: Single dialog for default actions by @mastercactapus in #4193
• uik: Update rules list for single-dialog and re-ordering by @mastercactapus in #4195
• uik: add direct links for externally created uik with warning by @KatieMSB in #4392
• services/search: enhance integration key input handling and add user guidance by @mastercactapus in #4388

🔧 System Improvements

Message Status Tracking

Enhanced notification system now records and displays complete message status history, providing administrators with full visibility into notification delivery status and helping with troubleshooting delivery issues.

• messages: record and display full message status history for notificaitons by @mastercactapus in #4324

Performance & Reliability

Improved shared locking enables better concurrent work processing, database indexing improvements for better performance with large message volumes, and enhanced testing capabilities for better performance validation.

• engine/processinglock: enable shared locking for concurrent work by @mastercactapus in #4153
• db: create index on message_id to help with cascading deletes and lookups by @mastercactapus in #4350
• test/load: Expands operations performed and use unique users for each VU by @mastercactapus in #4141

Security Enhancements

Added comprehensive HTTP security headers and enhanced route security with proper HTTP method restrictions and response codes.

• http: Add Secure Headers by @mastercactapus in #4071
• http: Add method restrictions to routes, fix response codes by @mastercactapus in #4243
• fix various HTTP response codes by @mastercactapus in #4403

🐛 Bug Fixes

Critical Fixes

• feat: fix rotation advance when removing a user by @mastercactapus in #4260
• schedules: Fixes a bug where 'replace' overrides would behave as an 'add' + 'delete' rather than replace by @mastercactapus in #4306
• rotations: fix v1 -> v2 migration logic by @mastercactapus in #4292
• sqlutil: fix deadlock in NOTIFY listener (refactor) by @mastercactapus in #4299
• fix(lifecycle): skip shutdown wait on run failure by @mastercactapus in #4261
• fix: fix override dialog extra button by @mastercactapus in #4368

Reliability Improvements

• fix: Exclude disabled subscriptions from inactivity queries by @mastercactapus in #4320
• engine: update rate limit rules for on-call user notifications by @mastercactapus in #4262
• service: fix label error messaging for create and edit by @mastercactapus in #4259
• profile: Fix on-call assignments page data by @mastercactapus in #4343
• fix: increase timeout in TestIDLocker_CancelQueue for better stability by @mastercactapus in #4385

🔌 Integration Improvements

Twilio Enhancements

• feat: add Twilio configuration check in AdminToolbox component by @mastercactapus in #4255

Slack Integration

• dest/slack: add bot name and hint to slack channel selection by @mastercactapus in #4367

🏗️ Behind the Scenes

This release includes significant architectural improvements that lay the groundwork for future enhancements. Notably, v0.34.0 represents a major milestone in our migration to a job queue architecture, which will enable better multi-instance deployments and improved performance at scale in future releases.

Job Queue Migration

Continued migration of background processes to job queue architecture for better reliability and performance at scale. These improvements are largely invisible to end users but provide a foundation for better multi-instance support and performance improvements in future releases.

• event: add event bus to replace manual trigger of periodic jobs by @mastercactapus in #4185
• engine: migrate status update manager to job queue by @mastercactapus in #4164
• engine/cleanupmanager: move alert cleanup to job queue and sqlc by @mastercactapus in #4186
• engine/cleanupmgr: Migrate shifts to job queue by @mastercactapus in #4192
• engine/cleanupmgr: move schedule data cleanup to job queue by @mastercactapus in #4203
• engine/cleanupmgr: individualize schedule data cleanup jobs by @mastercactapus in #4209
• engine/cleanupmgr: move alert log operations to job queue by @mastercactapus in #4211
• engine/cleanupmgr: finalize migration to job queue for cleanup operations by @mastercactapus in #4218
• engine: refactor rotations to process through job queue by @mastercactapus in #4269
• river: call .Start() synchronously by @mastercactapus in #4336
• engine/schedulemanager: refactor schedule calculation for maintainability and job queue migration by @mastercactapus in #4391

Architecture & Performance Improvements

• schedule: migrate schedule store to sqlc by @mastercactapus in #4394
• dataloader: refactor for simplicity and param support by @mastercactapus in #4381
• dataloader: add aggregate functions by @mastercactapus in #4387
• auth-check: replace "auth check" mechanism with proper external call counting by @mastercactapus in #4397
• chore: update pg_query_go to fix MacOs build error by @Forfold in #4393

Code Quality & Development

Ongoing TypeScript migration, SQLC migration for type-safe database queries, code modernization efforts, and build system improvements including the migration from Yarn to Bun for faster package management.

• build: yarn to bun by @mastercactapus in #4083
• Converted all remaining selection .js to typescript by @Azakahul in #4282
• Jsx to tsx convert calendar subscribe jsx files by @Azakahul in #4300
• ui/icons: convert icon components to typescript by @KatieMSB in #4278
• ui/service: convert ServiceLabelForm to typescript by @KatieMSB in #4279
• ui/util: convert js files to typescript by @KatieMSB in #4283
• dev: migrate from JSX.Element -> React.JSX.Element (part 1) by @mastercactapus in #4258
• ui/dev: Introduce CompList to replace FlatList by @mastercactapus in #4304
• ui/dev: Add ReorderGroup and ReorderableItem for CompList by @mastercactapus in #4305
• ui/services: migrate service components from FlatList to CompList by @mastercactapus in #4313
• ui/users: migrate user components from FlatList to CompList by @mastercactapus in #4314
• engine/compatmanager: migrate to sqlc by @mastercactapus in #4104
• Sqlc alert store by @cwhy22 in #4307
• dev: cache gettool by @mastercactapus in #4339

Dependencies & Build System

This release includes comprehensive dependency updates for both Go and JavaScript packages to ensure security and compatibility, along with improvements to our CI/CD pipeline.

🙏 New Contributors

Thanks to our new contributors who helped make this release possible:

• @Azakahul made their first contribution in #4282
• @cwhy22 made their first contribution in #4307
• @codylewandowski made their first contribution in #4375
• @weefatboi made their first contribution in #4384

Full Changelog: v0.33.0...v0.34.0

v0.34.0

Compare

Choose a tag to compare

GoAlert v0.33.0

After a significant hiatus since our last release, we're thrilled to announce GoAlert v0.33.0! This release lays the groundwork for some exciting future features while also delivering numerous fixes and stability improvements to enhance your current experience.

GraphQL API Keys

GraphQL API Keys are now fully supported and out of the experimental phase! We've introduced a dedicated editor to manage your API keys more efficiently, simplifying the process of creating, editing, and organizing your keys.

• gql-api-keys: only setState once when duplicating key by @mastercactapus in #3792
• gql-api-keys: Takes GQL API keys out of experimental state by @mastercactapus in #3797
• gqlapi: Ensure stable hash for API key policy by @mastercactapus in #3941
• admin/apikeys: add CodeMirror editor for editing keys by @mastercactapus in #4149

Alert Metadata

Introducing Alert Metadata: You can now attach arbitrary key-value metadata to alerts, enhancing the context and flexibility of your alerting workflow. This feature allows for more detailed and informative alerts, facilitating better incident management.

To add metadata to an alert, include it in your request parameters or JSON body. For example:

Via URL parameters:

bash
Copy code

/api/v2/generic/incomming?token=<token>&meta=example_key=example_value&meta=example_key2=example_value2

Or in a JSON body:

{
  "summary": "test",
  "details": "test",
  "meta": {
    "example_key": "example_value",
    "example_key2": "example_value2"
  }
}

Refer to the documentation (/docs) on your GoAlert instance for more details.

• Add alert metadata by @shivanishendge in #3764

Miscellaneous Enhancements

We've introduced several improvements to enhance usability and reliability:

• Custom End Time for Service Maintenance Mode: You can now specify a custom end time when putting a service into maintenance mode, giving you more control over maintenance scheduling.

• Externally Managed Integration Keys: Integration keys can now be marked as "externally managed," allowing seamless integration with external systems that manage keys.

• Improved SMTP Reliability: The remote monitor will now retry sending emails if the SMTP server is unavailable, increasing the robustness of email notifications.

• service maint: allow specifying a custom end time by @mastercactapus in #3815
• int keys: Add support for externally-managed integration keys by @mastercactapus in #3818
• add smtp retries by @nimjor in #4115

Bug Fixes

This release includes numerous UI bug fixes and log improvements to enhance stability and user experience. We've addressed issues related to alert details, markdown links, schedule notifications, and more, reducing log noise and fixing various edge-case bugs.

• fix: alert detail markdown link bug by @allending313 in #3683
• util/Markdown: fix handling of links with URL-escapable characters by @mastercactapus in #3721
• sched/notif: retain time and weekday filter if swapping radio options by @mastercactapus in #3741
• graphql: Convert empty UUID strings to NullUUID by @mastercactapus in #3744
• intkeys: fix site24x7 label bug by @mastercactapus in #3763
• graphql: use tx with create alert by @mastercactapus in #3776
• util/sqlutil: fix handling of block delimiters in SplitQuery by @mastercactapus in #3775
• engine/statusmgr: Skip status updates without an associated log entry by @mastercactapus in #3794
• webworker: add check on worker method name by @mastercactapus in #3795
• profile: fix flicker when opening dialogs by @mastercactapus in #3790
• ui/list: padding and console fixes by @Forfold in #3850
• list pages: fix conditional create button rendering by @mastercactapus in #3855
• ui: fix step number display for EP step delay text by @Forfold in #3916
• ui: fix edit empy temp sched bug by @Forfold in #4019
• Fix no-rows bug with last message status by @mastercactapus in #4061
• test contact method: Fix verification dialog, and refactor send test dialog by @mastercactapus in #4062
• fix: fix slice init length by @cuishuang in #4090
• log: cleanup erroneous log messages by @mastercactapus in #4122
• util/timeutil: Ensure exponents are never encoded into the output String() by @mastercactapus in #4123
• engine: update advisory lock handling and add locked transaction support by @mastercactapus in #4152

Admin Features

Pprof Profiling Support

Administrators can now create Go pprof profiles for performance analysis. By setting the --listen-pprof flag, you can access profiling data to help diagnose and optimize GoAlert's performance.

• Pprof endpoint by @mastercactapus in #3686

Future Features

A significant portion of this release is dedicated to laying the groundwork for upcoming major features:

• Programmable Integration Keys
• Plugin System for Outgoing Messages
• Job Queue System for Processing Tasks

Universal Integration Keys (Experimental)

We are excited to introduce Universal Integration Keys, currently available behind the univ-keys experimental flag. This powerful feature allows you to use Expr expressions to define custom rules for handling incoming messages, providing unprecedented flexibility in configuring alert processing.

With Universal Integration Keys, you can programmatically control how alerts are created, modified, or suppressed based on dynamic conditions. Additionally, you can send "signals" for less critical payloads and pipe a request directly to a Slack message, for example.

For more information, please refer to the Universal Integration Keys documentation.

• univ-keys: add Expr <-> Condition support by @mastercactapus in #3778
• add type universal to integration keys by @Forfold in #3836
• intkey: update old code to use API-driven key types by @mastercactapus in #3837
• ui: add route for universal integration keys by @Forfold in #3838
• uik: add basic CRUD operations by @mastercactapus in #3847
• expr: use scalar GraphQL types to handle validation by @mastercactapus in #3849
• ui: update breadcrumbs to handle doubly nested routes by @Forfold in #3848
• uik: add bounds/limits on int key config by @mastercactapus in #3851
• uik: add token generation and rotation by @mastercactapus in #3873
• uik: add deleteSecondaryToken mutation by @mastercactapus in #3877
• uik: add methods of updating single rules by @mastercactapus in #3880
• uik: implement new endpoint and authorization by @mastercactapus in #3879
• uik: add token rotation dialogs and controls by @mastercactapus in #3894
• uik: add dynamic actions api by @mastercactapus in #3898
• ui: add DynamicActionField component by @mastercactapus in #3909
• uik: switch from global to per-rule continue option by @mastercactapus in #3924
• dest/action: simplify error flow in forms by @mastercactapus in #3926
• Update DynamicParams to use ExprStringMap by @mastercactapus in #3944
• Add Universal Key Actions management forms by @mastercactapus in #3945
• Add default action edit and rule management dialogs by @mastercactapus in #3946
• uik: Add ability to edit and manage rules by @mastercactapus in #3950
• uik: Add pending_signals table by @mastercactapus in #3959
• uik: Enhance channel creation and rule compilation by @mastercactapus in #3960
• engine/signal: Add signal manager module and support for sending signal messages by @mastercactapus in #3975
• uik: Add defaultValue to dynamic action params by @mastercactapus in #3976
• uik: Refactor config to use specific UIK types by @mastercactapus in #3978
• ui: combine create and edit uik dialogs by @Forfold in #3994
• ui: universal integration keys by @Forfold in #3947
• ui: add tooltip to formdialog action buttons, use for universal keys by @Forfold in #4000
• graphql: Improve error handling for validation for arg and param types by @mastercactapus in #4054
• Add documentation for Universal Integration Keys by @mastercactapus in #4025
• integrationkey/uik: Wrap error in validation for HTTP response by @mastercactapus in #4073
• integrationkey/uik: refactor eval logic by @mastercactapus in #4142

Plugin System for Outgoing Messages

We have made significant progress towards developing a plugin system for outgoing messages. This new system will allow you to extend GoAlert's notification capabilities by integrating with custom or third-party services.

As part of this effort, all destination structures have been normalized, providing a central registry to manage and register notification destinations. This lays the groundwork for a more modular and extensible notification system, paving the way for future enhancements and custom integrations.

• ep: destinations: update step list/actions to use dest-types by @mastercactapus in #3665
• dest: return proper data in graphql errors by @mastercactapus in #3676
• users: use generic destinations for user contact method list component by @tony-tvu in #3684
• dest: fix error handling for user contact method form by @mastercactapus in #3685
• dest api: Clean up error API by @mastercactapus in #3698
• users: use generic destinations for user CM create dialog component by @tony-tvu in #3664
• dest/graphql: convert comments to description strings by @mastercactapus in #3702
• users: use generic destinations for User Notification Rule List component by @ethan-haynes in #3701
• dest: add API support to create EP step with destinations by @tony-tvu in #3700
• dest/graphql: normalize schema fields by @mastercactapus in #3703
• dev: fix PR merge conflict by @mastercactapus in #3706
• dest: add sched notif form by @mastercactapus in #3704
• dev: format graphql files with prettier by @mastercactapus in #3715
• dest: sched notifications create dialog by @mastercactapus in #3705
• dest/escalation-policies: use destinations for EP step form by @tony-tvu in #3717
• dest: add dest version of schedule notification edit dialog by @mastercactapus in #3719
• dest/escalation-policies: use destinations for EP step create dialog by @tony-tvu in #3718
• user contact method edit dialog dest by @ethan-haynes in #3720
• dest: Remove disabled message by @mastercactapus in #3761
• graphql: remove experimental directive for dest-types by @mastercactapus in #3777
• dest: use destinations for EP step edit dialog by @allending313 in #3772
• dest: Destination display error handling by @mastercactapus in #3779
• ui/config: always request dest types by @mastercactapus in #3800
• ui/sched: always use Dest API by @mastercactapus in #3785
• ui: update material select tests by @Forfold in #3874
• ui/profile: add helpers and move notification rule tests to playwright by @mastercactapus in #3876
• profile: optimize on-call query by @mastercactapus in #3871
• ui/policy: always use Dest API by @mastercactapus in #3867
• ui/profile: always use Dest API by @mastercactapus in #3875
• ui: update escalation policy step button text by @Forfold in #3878
• playwright: fix flaky contact method tests by @mastercactapus in #3882
• expflag: remove dest-types flag by @mastercactapus in #3881
• ui/on-call notifications: always show quick link, show error on no days by @Forfold in #3893
• dev/test-components: fix race when waiting for chips to appear in ep step test by @mastercactapus in #3896
• storybook: allow for per-story graphql mocking by @mastercactapus in #3899
• ui/chore: remove "Dest" suffix from relevant UI files by @Forfold in #3895
• ui: update EP step form destination UX by @Forfold in #3897
• graphql: add StringMap for destinations by @mastercactapus in #3938
• Add ErrorConsumer by @mastercactapus in #3939
• DestinationField StringMap update by @mastercactapus in #3940
• dest: update user forms to use StringMap instead of FieldValuePair[] by @mastercactapus in #3943
• dest: update user_contact_methods and notification_channels to have a dest column by @mastercactapus in

Note truncated.

v0.33.0

Compare

Choose a tag to compare

Bumps cross-spawn from 6.0.5 to 6.0.6.

• Changelog
• Commits

updated-dependencies:

• dependency-name: cross-spawn
  dependency-type: indirect
  ...

Signed-off-by: dependabot[bot] [email protected]
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

GoAlert v0.32.0

Welcome to the unveiling of GoAlert v0.32.0! This release is a comprehensive package, featuring a range of exciting new features, critical bug fixes, and essential developer improvements to elevate your alert management experience.

Experimental Features

API Key Support

The 'API Keys' feature is currently an experimental feature. To explore this functionality, administrators must opt in by configuring GoAlert with EXPERIMENTAL=gql-api-keys. As an experimental feature, it may change, and your feedback is appreciated. Caution is advised in production, and expect updates as we refine and enhance its capabilities.

Explore an up-and-coming new feature of GoAlert while it's still in its experimental stage! Once activated, discover the new 'API Keys' option in the admin sidebar, allowing administrators to create and tailor access using GraphQL queries or mutations for a more secure and customizable integration.

More information on implementation details and the decisions around this new feature can be found in an ADR here.

• add listGQLFields query by @mastercactapus in #3276
• add base admin API key support by @mastercactapus in #3274
• add role to gql api key info by @mastercactapus in #3312
• api key UI by @1ddo in #3324
• Implement Duplicate Functionality for API Keys by @mastercactapus in #3395
• add warning icon, update expires grammar by @Forfold in #3401
• add adr for api key arch by @mastercactapus in #3441
• allow omitting the api key's fixed query by @mastercactapus in #3464
• allow copy as JSON and fix query formatting by @mastercactapus in #3434
• Fix timestamp displays by @mastercactapus in #3415
• Switch policy from allowedFields to query by @mastercactapus in #3411
• Add integration test for GQL API keys by @mastercactapus in #3400
• Allow entering a query directly to generate Allowed Fields by @mastercactapus in #3370
• only enforce unique name on non-deleted keys by @mastercactapus in #3369
• cache policy info lookup & last usage updates by @mastercactapus in #3291
• add list and update of graphql api keys by @mastercactapus in #3292
• apikey: Fix issue where omitting the query field doesn't work by @mastercactapus in #3491

New Features

Monthly Rotations

Simplify your team's schedule with monthly handoffs! The new 'Monthly' option in Rotations enhances scheduling convenience, ensuring smooth handoffs once a month in GoAlert.

• add monthly rotation option by @allending313 in #3243
• add monthly rotations UI by @allending313 in #3257

Service Metrics

Elevate service monitoring with new comprehensive metrics in GoAlert. Admins can now keep an eye on service health, check for setup issues, and review notification channels—all in one place for better awareness and management.

• add service metrics data table by @KatieMSB in #3368
• Add usage graphs by @KatieMSB in #3297
• fix service status in data table by @KatieMSB in #3455
• Add filtering for admin service metrics by @KatieMSB in #3382
• service metrics hooks by @KatieMSB in #3300

Full Calendar Subscription

Users can now opt into subscribe to all shifts on a schedule in GoAlert. Get a complete view of your commitments and your teammates for more comprehensive schedule management.

• Full Schedule Support in Calendar Subscriptions by @mastercactapus in #3289

User Profile Calendar

The user profile page now renders a calendar for all on-call schedule shifts (broken down by schedule)

• gql: add field "assignedSchedules" to type "User" by @Forfold in #3231
• ui: add user shifts calendar to profile by @Forfold in #3229

Misc Improvements

We've made a number of QOL improvements including a new splash screen, fixed favicon, labels are visible on services, and improved timestamp support in markdown.

• ui: splash screen from index.html by @Forfold in #3513
• ui: Markdown timestamp support by @mastercactapus in #3558
• add label chips to service details by @mastercactapus in #3530
• ui: update favicon by @Forfold in #3580
• ui/schedules: flip timezone locale for shifts list by @Forfold in #3510
• heartbeats: Add support for specifying additional details by @mastercactapus in #3559

Admin Options

There were a few new config options and tweaks added for admins, like requiring labels on services and closing stale alerts.

• config: add Service.RequiredLabels by @mastercactapus in #3531
• config: Add option to auto-close acked alerts by @mastercactapus in #3604
• prometheus: add service_id to created alerts and sent notification counters by @mastercactapus in #3603
• statusmgr: expire status subscriptions after 7 days by @mastercactapus in #3610

Bug Fixes

Temporary Schedules Improvements

A number of bug fixes for the Temporary Schedules features have been addressed and some new features!. Soft limits for start and end dates provide better control, default values are now set accurately, and temporary schedules seamlessly merge as intended.

Schedules are now broken down by a default shift length, and while custom shifts remain supported, this intends to make it easier to create and manage even handoffs amongst team members.

Additionally, if you need to edit a temporary schedule, you will now be prompted to confirm the changes, so you know EXACTLY what is being changed before saving!

• Add soft limits for min and max, apply to override and temp sched by @mastercactapus in #3474
• fix default value not set for temp sched dialog by @Forfold in #3380
• fix soft limits while typing by @mastercactapus in #3478
• Fix schedule not merging bug by @KatieMSB in #3473
• ui/schedules: create confirmation component for editing a temporary schedule by @Forfold in #3561
• ui/temp-sched: Add fixed shifts for temporary schedules by @KatieMSB in #3606

Misc Bug Fixes

Lots of bugs were squashed in this update to improve the overall GoAlert experience! Enhancements include improved linter and formatting, optimized search functionalities, enhanced concurrency and performance, streamlined dependency management, meticulous timestamp handling, and robust error handling.

• increase linter timeout by @mastercactapus in #3280
• preserve line breaks in markdown by @mastercactapus in #3344
• limit HistoryBySchedule to 3 concurrent calls by @mastercactapus in #3334
• use static query for override search by @mastercactapus in #3317
• resolve circular dependency in make db-schema target by @mastercactapus in #3273
• normalize whitespace before comparing timestamps in jest by @mastercactapus in #3277
• fix wrong param by @mastercactapus in #3355
• show metrics up to current time, instead of start of bucket by @Forfold in #3345
• increase variance in delayminutes by @mastercactapus in #3359
• redirect on complete by @KatieMSB in #3461
• use a sane default for the max num of graph points by @Forfold in #3479
• use iso for storage, locale for display by @mastercactapus in #3476
• fix prettier formatting in vscode by @mastercactapus in #3458
• update linter to use version of Go used by project by @mastercactapus in #3275
• preserve field/type information when parsing ISODuration by @mastercactapus in #3272
• update search to include maintenance mode by @KatieMSB in #3341
• search: fix handling of underscores and add contains match for names by @mastercactapus in #3514
• graphql: Fix 500 errors on invalid JSON by @mastercactapus in #3499
• cli: check for scheme on public-url by @mastercactapus in #3626
• cli: normalize public url by @mastercactapus in #3627

Dev Improvements

Architectural Decision Records (ADRs)

Introducing Architectural Decision Records (ADRs) in GoAlert! We now document key decisions around new and complex features, providing transparent insights into our development process. ADRs serve as a valuable resource for understanding the rationale behind design choices and enhancing collaboratoin within the GoAlert community.

Learn more about ADRs here.

Some of our current ADRs include decisions on tech migrations and the new API key architecture, and can be found here.

• add ADR directory and template by @mastercactapus in #3358

Migrations

We've invested significant efforts in addressing technical debt by migrating to new technologies. This includes transitions to TypeScript, SQLc, URQL, React Suspense, and React Hooks.

• integration keys sqlc by @andrewbenington in #3293
• user contactmethod sqlc by @allending313 in #3310
• use sqlc for user favorites by @mastercactapus in #3288
• convert non-search store methods to sqlc by @mastercactapus in #3414
• update admin queries and mutations by @Forfold in #3431
• transition to urql and use suspense to load user details by @Forfold in #3430
• convert UserContactMethodSelect to typescript by @KatieMSB in #3438
• convert ScheduleRuleForm to typescript by @KatieMSB in #3439
• convert FormContainer to use hooks by @KatieMSB in #3432
• ui: convert UserContactMethodEditDialog to typescript by @KatieMSB in #3472
• ui: remove unused component by @KatieMSB in #3487
• ui/urql: rotations by @Forfold in #3489
• ui/profile: convert UserContactMethodVerificationDialog to ts by @KatieMSB in #3490
• ui/profile: convert UserContactMethodCreateDialog to urql by @KatieMSB in #3488
• ui/urql: convert user lists to urql by @KatieMSB in #3495
• ui/profile: convert UserContactMethodVerificationForm to typescript by @KatieMSB in #3494
• ui/service: convert ServiceOnCallList to typescript by @KatieMSB in #3512
• fix: add missing typenames by @KatieMSB in #3532
• ui/urql: convert user dialogs to urql by @KatieMSB in #3493
• ui: update Select gql imports to use urql by @Forfold in #3582
• ui: update ServiceCreateDialog and ServiceLabelCreateDialog to use urql by @Forfold in #3583
• ui/schedules: convert ScheduleRuleList, ScheduleRuleCreateDialog, ScheduleRuleEditDialog to typescript by @tony-tvu in #3525
• ui: update SetFavoriteButton and graphql.test.js to urql by @Forfold in #3584
• ui: update temp sched dialogs to use urql, add additionalTypenames by @Forfold in #3587
• ui: update schedule oncall hooks and util to use urql by @Forfold in #3589
• ui: update WizardRouter to use urql by @Forfold in #3585
• ui: convert CalendarSubscribe dialogs to ts and to use urql instead of apollo by @Forfold in #3590
• ui/urql: update schedule queries and mutations by @Forfold in #3625
• web: convert user contact method .js dependencies to .jsx by @tony-tvu in #3652
• dev: rename components from .js to .jsx by @mastercactapus in #3657

Misc Dev Improvements

We've fine-tuned user interactions, enriched logging, and polished alert management for an even smoother GoAlert experience. Notable updates, including refined canonical zone names, the addition of an ExpFlag component for conditional rendering, and enhanced alert noise reduction.

• Use canonical zone names by

Note truncated.

v0.32.0

Compare

Choose a tag to compare

GoAlert v0.31.1

This point release fixes some regressions present in the v0.31.0 release. Additionally, containers and binaries for this version were built with Go 1.21.1.

Bug Fixes

• Fixed issue with SMTP server when multiple RCPT TO addresses were sent
• Added a missing column for the alerts feature that prevented switchover from working properly
• Fixed an issue that prevented adding webhooks to escalation policies when Slack is disabled
• Fixed search behavior when matching multiple words

• fix: prefix search by @andrewbenington in #3234
• smtpsrv: return proper errors and limit RCPT TO by @mastercactapus in #3251
• swo: add missing id column to alert_feedback by @mastercactapus in #3256
• ep: fix webhook expansion when slack is disabled by @mastercactapus in #3264

Misc

• The Google Analytics feature was re-introduced and updated
• Dependency and driver updates
• New TypeScript conversion

• dev: update sqlc to latest version (1.20.0) by @mastercactapus in #3244
• ui/deps: upgrade mui packages to latest by @Forfold in #3253
• dev: update all devtools to use pgx v5 by @mastercactapus in #3255
• ui/components: Convert NewUserSetUp to ts by @leyasalazar in #3242
• feat: add google analytics support by @KatieMSB in #3254
• db: switch driver to pgx5 by @mastercactapus in #3258

Full Changelog: v0.31.0...v0.31.1

v0.31.1

Compare

Choose a tag to compare

GoAlert v0.31.0

Unveiling the latest GoAlert update with enhanced alert tracking, seamless system migration, and more. Experience greater control and efficiency in your alert management.

Container image: goalert/goalert:v0.31.0

New Features

Alert Noise Tracking

Users may now mark alerts as "noisy" and see the overall counts and escalations on the Alert Metrics page.

• add option to set noise reasons for an alert by @Forfold in #3133
• view noisy alert count on service alert metrics graph by @Forfold in #3161

Message Logs Frequency Graph

There is now a graph to visualize sent messages:

• ui: preflight changes for message logs graph by @Forfold in #3026
• admin/message logs: Add field for querying statistics on outgoing messages by @mastercactapus in #3059
• ui/admin: add message logs notification count line graph by @Forfold in #2481

Switchover UI

You can now migrate a live system from one DB server to another without downtime.
More information is available in the Switchover Guide.

• switchover: refactor and move SWO toolset to UI by @mastercactapus in #2523
• swo: add guide and in-app documentation by @mastercactapus in #3246
• swo: Polish the guide/documentation rendering by @mastercactapus in #3247

Email Integration Keys via Built-In SMTP

Alerts created by email are now supported by pointing an MX record directly to GoAlert documentation available here.

• Add built-in SMTP ingress server by @nimjor in #3184

Set/Update User Password

Users and admins are now able to update passwords from the UI

• auth/basic: add createBasicAuth and updateBasicAuth for managing Basic credentials via GraphQL by @allending313 in #3062
• ui/user: Allow setting/changing basic auth passwords in UI by @allending313 in #2991

Slack DM Contact Method

Users can now add Slack direct messages as a contact method on their profile when Slack is enabled.

• slack: add new contact method type for direct messages (experimental) by @mastercactapus in #2805
• slack: add UI for Slack DM contact method type (experimental) by @mastercactapus in #2815
• slack-dm: add compat module by @mastercactapus in #2821
• slack-dm: fix dm message updates by @mastercactapus in #2864
• slack: fix DM display and pending state by @mastercactapus in #2890
• slack: Add smoketest for Slack DM notificaitons by @mastercactapus in #3047
• fix slack dm status updates by @mastercactapus in #3060
• status updates: switch to per-contact-method behavior by @mastercactapus in #2824
• expflag: remove slack-dm flag by @mastercactapus in #3071

Alert Auto-Close

You can now set a global auto-close time for unacknowledged alerts under Maintenance on the Admin -> Config page.

• admin: add alert auto-close feature by @Lakshmi2107 in #2660

Twilio Voice Customization

Configuring the Twilio voice name and language from the admin panel is now possible.

• feat: Adding more natural sounding voices to phone calls by @AlaricWhitney in #2575
• feat: breaking out voice calls into a testable function by @AlaricWhitney in #2768

Webhook Support

Webhooks can now be set as a destination for scheduled on-call notifications and directly on an escalation policy step! Additionally, the service name is now included for alerts.

• feat: adding webhooks as a notification channel type by @nataliekorzh in #2809
• feat: add UI for chanWebhooks escalation policy step option by @nataliekorzh in #2871
• fix: webhook check on edit escalation policy step by @andrewbenington in #3040
• feat: webhook on call notification by @andrewbenington in #3036
• feat: add happy path integration test for on call notification webhook by @allending313 in #3155
• feat: add smoke test for on call notification webhooks by @allending313 in #3162
• feat: remove webhook exp flag by @allending313 in #3168
• feat: add service name/id field to webhook alerts by @allending313 in #3199

Escalate via Voice and SMS

You can now escalate an alert by voice and SMS.

• Feature/escalate via ivr by @Lakshmi2107 in #2818

Update Slack Usergroup

Slack usergroups can now automatically be updated by setting an on-call notification on a schedule!

• slack: allow saving user group ID to schedule notification rules by @mastercactapus in #2882
• slack: add user group queries to graphql schema by @mastercactapus in #2907
• slack: update user-group membership for configured schedules by @mastercactapus in #2926
• ui: add slack user groups to on call notifications by @Forfold in #2932
• migrate: move user group migration to latest by @mastercactapus in #3012
• slack: use usergroup handle instead of name by @mastercactapus in #3037
• feat: on call notification channel separation by @andrewbenington in #3046
• feat: add integration test for slack usergroup feat by @allending313 in #3129
• feat: add happy path smoke test for slack user groups by @allending313 in #3137
• chore: remove slack usergroup exp flag by @allending313 in #3144

Generic Alert API

It is now possible to get the alert and service ID when creating an alert via a Generic API key by setting the Accept header to application/json

• sending alert object as create alert response body by @sudhabindu-apm in #3124

Backend & API

We hardened security, expanded maintenance mode, and fixed some cleanup issues.

• user/cm: cleanup unverified contact methods by @cmarquis in #2764
• auth: set SameSite to strict on session cookie by @mastercactapus in #3111
• auth: Validate redir on return from auth by @mastercactapus in #3114
• auth: use samesite=lax for oauth cookies by @mastercactapus in #3158
• feat: extending maintenance allowance through API by @theautoroboto in #3160
• twilio: always use messaging SID if set by @mastercactapus in #3165

Improvements

We moved the add buttons on wide-screen devices from a floating-action button to a named button at the top to reduce confusion for new users.

• ui: move profile add buttons by @Forfold in #2709
• ui: add desktop service create buttons by @Forfold in #2735
• ui: move create buttons for schedule assignments and notification rules by @Forfold in #2733
• ui: move create button on main list pages by @Forfold in #2715
• ui: move button for adding user to rotation by @Forfold in #3089
• ui: update button styling on profile by @Forfold in #3091
• ui: move button creating a step on an EP by @Forfold in #3090

We also made various improvements around accessibility, typography, and inputs around the application. Notably:

• disabled notification options will now be shown (as disabled) to users rather than being hidden
• Users can now enter heartbeat intervals as hours, days, or weeks.
• Service descriptions can now be up to 6KiB
• Calendar subscriptions now include the app and schedule name with shifts
• Alert log now indicate delivery delays
• improved the draggable list UX on EP and rotation pages

• ui: some small fixes by @Forfold in #2737
• ui/profile: use title instead of aria-label for icon buttons by @mastercactapus in #2749
• ui/services: sort on call users by escalation step by @KatieMSB in #2729
• ui: disable backdrop close for temp schedules by @Forfold in #2759
• ui: use calendar override dialog for schedule and override lists by @Forfold in #2728
• add notices to services when nearing unackd alerts system limit by @Forfold in #2891
• calsub: add app and schedule name to shifts by @mastercactapus in #2915
• feat: add markdown supported hint, increased description size to 6KiB for service form by @allending313 in #2927
• feat: clarify permissions around contact methods by @allending313 in #2933
• ui: fix slack link typography in dialog by @Forfold in #2977
• feat: show disabled notification options by @andrewbenington in #3138
• heartbeats: Increase max duration and improve UI for long-durations by @mastercactapus in #3088
• fix: aligning esc policy notices by @andrewbenington in #3198
• alert details: show sent notification delivery delays in alert log by @cmarquis in #3182
• ui: update draggable list ux by @Forfold in #3207

Time Component

We've introduced a new Time component to normalize the display and accessibility of timestamps and durations across the application.

• ui: add Time component by @mastercactapus in #2830
• ui/time: use Time for services and alert details by @mastercactapus in #2833
• ui/time: update rotations to use Time component by @mastercactapus in #2831
• ui/Time: increase underline offset by @mastercactapus in #2886
• ui/Time: use Time component for calendar subs and on-call form by @mastercactapus in #2896

Bug Fixes

We squashed a whole lot of bugs! Most notably those with long public URLs will no longer get errors when sending SMS messages as multi-segment messages are now supported.

• fixed escalation policy update description by @NitishBalajee in #2717
• add escalation policy created via service to favourites by @rajeshggwp in #2725
• fix items being filtered from options list by @Forfold in #2702
• ui: Fix default time not being set correctly for new schedule assignments by @cmarquis in #2738
• ui: update failing cypress tests by @Forfold in #2758
• Fix UI bugs on removing user from rotation by @ram191 in #2761
• admin/message-log: reflect sent time in sort order by @cmarquis in #2742
• notification/slack: sort on-call users by name by @mastercactapus in #2786
• ui/profile: display proper errors in send test dialog by @cmarquis in #2734
• alert: add escalation checks by @mastercactapus in #2840
• ui: fix snackbar not showing latest alert notification by @Forfold in #2880
• auth/basic: lower bcrypt difficulty, limit 1 compare at a time by @mastercactapus in #2923
• auth/github: prevent cryptic error on no name set by @mastercactapus in #2945
• auth/basic: separate password hashing from DB insert by @mastercactapus in #2990
• Fix smtp default port by @mastercactapus in #3025
• slack: lower slack cache time by

Note truncated.

v0.31.0

Compare

Choose a tag to compare