Files
graylog2-server/UPGRADING.md
Zack King 502cd61f87 Simplify aggregation condition names (#24703)
* Simplify new event aggregation_condition field names

* unit test

* rename var

* Changelog

* Fix test with new format

* Add breaking change to UPGRADING.md
2026-01-14 08:13:43 -06:00

1.8 KiB

Upgrading to Graylog 7.1.x

User Session Termination

All user sessions will be terminated when upgrading because the internal storage format for sessions has been changed. Users will have to log in again.

Breaking Changes

External Authentication Services: Changed Default User Time Zone

The authentication backends for Active Directory, LDAP, OIDC, Okta, and SAML previously set the time zone for newly synchronized users to the value of the root_timezone config file setting. ("UTC" by default)

Graylog 7.1 introduces a configurable "default user time zone" setting for all authentication backends. The default value is unset, meaning that the browser's time zone will be used by default.

Formatting Change of aggregation_conditions Field in Aggregation Events

The aggregation_conditions map previously used keys with parentheses on the aggregation type. These needed to be escaped if they were used directly in Notification templates, e.g. ${aggregation_conditions.count\\(\\)}, ${aggregation_conditions.sum\\(fieldname\\)}. To avoid the need for escaping, their format has been modified to use underscores instead, e.g. ${aggregation_conditions.count}, ${aggregation_conditions.sum_fieldname}. Any existing notifications using the escaping of parentheses in explicit aggregation_conditions key names will need to be modified to instead use the underscore format.

Configuration File Changes

Option Action Description
tbd added

Java API Changes

  • tbd

REST API Endpoint Changes

The following REST API changes have been made.

Endpoint Description
GET /<endpoint> Description of the endpoint change