Hide file download links

Show file download links

Bug fixes and updates.

Breaking Changes

The following items create a breaking change in the behavior, response or operation of this release.

• Packages

  Previously, LogScale would allow dashboard YAML template files to not contain a $schema field, but this is no longer optional. The $schema field is what LogScale uses to determine how it should read the template file, so it is important that it is correct. Before this change, if the $schema field was missing from a dashboard template, LogScale would assume the file was a dashboard template, using the dashboard schema version 0.1.0, which was released in 2020. As this old schema version doesn't recognize any features released since then, using it as the default value can cause confusing error messages if you try to omit the $schema field. Therefore, the field is now required instead. If you now have a dashboard YAML template file that LogScale rejects due to this change, try adding the following line to the file: $schema": "https://schemas.humio.com/dashboard/v0.1.0, which should make it work as before.

Deprecation

Items that have been deprecated and may be removed in a future release.

The Humio-Usage package has been deprecated and scheduled for removal in version 1.189 LTS.

The color field on the Role type has been marked as deprecated (will be removed in version 1.195).

The storage task of the GraphQL NodeTaskEnum is deprecated and scheduled to be removed in version 1.189. This affects the following items:

• The supportedTasks field of the ClusterNode type.

• The assignedTasks field of the ClusterNode type.

• The unassignedTasks field of the ClusterNode type.

• The assignTasks() mutation.

• The unassignTasks() mutation

• The INITIAL_DISABLED_NODE_TASKS configuration variable.

LogScale is deprecating free-text searches that occur after the first aggregate function in a query. These searches likely did not and will not work as expected. Starting with version 1.190.0, this functionality will no longer be available. A free-text search after the first aggregate function refers to any text filter that is not specific to a field and appears after the query's first aggregate function. For example, this syntax is deprecated:

logscale Syntax

"Lorem ipsum dolor"
| tail(200)
| "sit amet, consectetur"

Some uses of the wildcard() function, particularly those that do not specify a field argument are also free-text-searches and therefore are deprecated as well. Regex literals that are not particular to a field, for example /(abra|kadabra)/ are also free-text-searches and are thus also deprecated after the first aggregate function.

To work around this issue, you can:

• Move the free-text search in front of the first aggregate function.

• Search specifically in the @rawstring field.

If you know the field that contains the value you're searching for, it's best to search that particular field. The field may have been added by either the log shipper or the parser, and the information might not appear in the @rawstring field.

Free-text searches before the first aggregate function continue to work as expected since they are not deprecated. Field-specific text searches work as expected as well: for example, myField=/(abra|kadabra)/ continue to work also after the first aggregate function.

The use of the event functions eventInternals(), eventFieldCount(), and eventSize() after the first aggregate function is deprecated. For example:

Invalid Example for Demonstration - DO NOT USE

logscale

eventSize() 
| tail(200) 
| eventInternals()

Usage of these functions after the first aggregate function is deprecated because they work on the original events, which are not available after the first aggregate function.

Using these functions after the first aggregate function will be made unavailable in version 1.190.0 and onwards.

These functions will continue to work before the first aggregate function, for example:

logscale Reformat

eventSize() 
| tail(200)

The setConsideredAliveUntil and setConsideredAliveFor GraphQL mutations are deprecated and will be removed in 1.195.

The lastScheduledSearch field from the ScheduledSearch datatype is now deprecated and planned for removal in LogScale version 1.202. The new lastExecuted and lastTriggered fields have been added to the ScheduledSearch datatype to replace lastScheduledSearch.

The EXTRA_KAFKA_CONFIGS_FILE configuration variable has been deprecated and planned to be removed no earlier than version 1.225.0. For more information, see RN Issue.

Behavior Changes

Scripts or environment which make use of these tools should be checked and updated for the new configuration:

• Storage

  The S3 SDK retry logic has been broadened:

  • LogScale will now do retries for bucket storage operations on a much broader range of exceptions (SDKException).

  • Segment uploads that fail after the SDK call will no longer be retried immediately, but will still be re-queued.

  • Uploads of global snapshots and uploaded files will still be retried implicitly, and the retry log lines now specify which type of upload is initiating it.

Upgrades

Changes that may occur or be required during an upgrade.

• Installation and Deployment

  The bundled JDK has been upgraded to version 24.0.1.

New features and improvements

Fixed in this release

Improvement

Recent Package Updates

The following LogScale packages have been updated within the last month.