Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Release notes for 8.16.0 #16605

Open
wants to merge 9 commits into
base: 8.16
Choose a base branch
from
79 changes: 78 additions & 1 deletion docs/static/releasenotes.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@

This section summarizes the changes in the following releases:

* <<logstash-8-16-0,Logstash 8.16.0>>
* <<logstash-8-15-3,Logstash 8.15.3>>
* <<logstash-8-15-2,Logstash 8.15.2>>
* <<logstash-8-15-1,Logstash 8.15.1>>
Expand Down Expand Up @@ -68,6 +69,82 @@ This section summarizes the changes in the following releases:
* <<logstash-8-0-0-alpha1,Logstash 8.0.0-alpha1>>


[[logstash-8-16-0]]
=== Logstash 8.16.0 Release Notes

==== Announcing the new {ls} Health Report API
edmocosta marked this conversation as resolved.
Show resolved Hide resolved

The new Health Report API (`GET /_health_report`) is available starting with {ls} `8.16.0`.
This API leverages indicators capable of detecting the degraded status of pipelines and
providing actionable insights https://github.com/elastic/logstash/pull/16520[#16520], https://github.com/elastic/logstash/pull/16532[#16532].
edmocosta marked this conversation as resolved.
Show resolved Hide resolved

NOTE for users upgrading to {ls} 8.16.0: if your existing automation relies on liveliness scripts that expect Logstash's API status to either not be available or return a hardcoded `green` status, there is an escape hatch to prevent the new Health API's status from affecting the top-level `status` field of Logstash's existing API responses. Setting the `logstash.forceApiStatus` system property to `green` will force other APIs to return the previous hard-coded `green` value. https://github.com/elastic/logstash/pull/16535[#16535]
edmocosta marked this conversation as resolved.
Show resolved Hide resolved

For a more detailed view please check <<logstash-health-report-api>>.
edmocosta marked this conversation as resolved.
Show resolved Hide resolved

[[featured-8.16.0]]
edmocosta marked this conversation as resolved.
Show resolved Hide resolved
==== New features and enhancements

* {ls} now gracefully handles `if` conditionals in pipeline definitions that can't be evaluated (https://github.com/elastic/logstash/pull/16322[#16322]), either by dropping
the event or by sending it to the pipeline's DLQ if enabled. https://github.com/elastic/logstash/pull/16423[#16423]

[[core-8.16.0]]
edmocosta marked this conversation as resolved.
Show resolved Hide resolved
==== Other changes to Logstash core

* Added deprecation logs for modules `netflow`, `fb_apache` and `azure`. https://github.com/elastic/logstash/pull/16548[#16548]

* Added deprecation logs for users that doesn't explicitly select a value for `pipeline.buffer.type` forcing them to proactively make a choice before version `9.0` when this setting will default to heap. https://github.com/elastic/logstash/pull/16498[#16498]

* The flag `--event_api.tags.illegal` was deprecated and will be removed in version 9. This flag remains available throughout all version 8.x releases. Users who rely on this flag to allow non strings assignment to `tags` field should update their pipeline. https://github.com/elastic/logstash/pull/16507[#16507]


==== Plugins
edmocosta marked this conversation as resolved.
Show resolved Hide resolved

*Cef Codec - 6.2.8*

* Added missing documentation of the `raw_data_field` option https://github.com/logstash-plugins/logstash-codec-cef/pull/105[#105]
edmocosta marked this conversation as resolved.
Show resolved Hide resolved

*Json_lines Codec - 3.2.2*

* Raised the default value of the `decode_size_limit_bytes` option to 512 MB https://github.com/logstash-plugins/logstash-codec-json_lines/pull/46[#46]

* Added the `decode_size_limit_bytes` option to limit the maximum size of JSON lines that can be parsed. https://github.com/logstash-plugins/logstash-codec-json_lines/pull/43[#43]

*Elastic_integration Filter - 0.1.15*

* Use Elasticsearch code from its `8.16` branch and adapt to changes in Elasticsearch GeoIP processor https://github.com/elastic/logstash-filter-elastic_integration/pull/170[#170]

*Geoip Filter - 7.3.1*

* Fixed a pipeline crash when looking up a database with customised fields https://github.com/logstash-plugins/logstash-filter-geoip/pull/225[#225]

*Azure_event_hubs Input - 1.5.0*

* Updated Azure Event Hub client library to version `3.3.0` https://github.com/logstash-plugins/logstash-input-azure_event_hubs/pull/96[#96]

*Beats Input - 6.9.0*

* Improved plugin's shutdown process and fixed a crash when a connection is terminated while processing messages https://github.com/logstash-plugins/logstash-input-beats/pull/500[#500]

*Http Input - 3.9.1*

* Fixed an issue where the value of `ssl_enabled` during `run` wasn't correctly logged https://github.com/logstash-plugins/logstash-input-http/pull/180[#180]

* Separated Netty boss and worker groups to improve the graceful shutdown https://github.com/logstash-plugins/logstash-input-http/pull/178[#178]

*Tcp Input - 6.4.3*

* Updated dependencies for TCP input https://github.com/logstash-plugins/logstash-input-tcp/pull/224[#224]

*Jdbc Integration - 5.5.0*

* Added support for SQL `DATE` columns to jdbc static and streaming filters https://github.com/logstash-plugins/logstash-integration-jdbc/pull/171[#171]

*Rabbitmq Integration - 7.4.0*

* Removed obsolete `verify_ssl` and `debug` options https://github.com/logstash-plugins/logstash-integration-rabbitmq/pull/60[#60]


[[logstash-8-15-3]]
=== Logstash 8.15.3 Release Notes

Expand Down Expand Up @@ -2545,4 +2622,4 @@ We have added another flag to the Benchmark CLI to allow passing a data file wit
This feature allows users to run the Benchmark CLI in a custom test case with a custom config and a custom dataset. https://github.com/elastic/logstash/pull/12437[#12437]

==== Plugin releases
Plugins align with release 7.14.0
Plugins align with release 7.14.0
Loading