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.0.0-beta1 #13373

Merged
merged 11 commits into from
Nov 8, 2021
45 changes: 44 additions & 1 deletion docs/static/releasenotes.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,54 @@

coming[8.0.0]

* <<logstash-8-0-0,Logstash 8.0.0>>
jsvd marked this conversation as resolved.
Show resolved Hide resolved
This section summarizes the changes in the following releases:

* <<logstash-8-0-0-beta1,Logstash 8.0.0-beta1>>
* <<logstash-8-0-0-alpha2,Logstash 8.0.0-alpha2>>
* <<logstash-8-0-0-alpha1,Logstash 8.0.0-alpha1>>

[[logstash-8-0-0-beta1]]
=== Logstash 8.0.0-beta1 Release Notes

[[nanosecond-precision]]
jsvd marked this conversation as resolved.
Show resolved Hide resolved
As processing times speed up, millisecond granularity is not always enough. Inbound data increasingly has sub-millisecond granularity timestamps.
The pull request https://github.com/elastic/logstash/pull/12797[#12797] allows the internal mechanisms of Logstash that hold moment-in-time data - such as the Logstash Event, the Persistent Queue, the Dead Letter Queue and JSON encoding/decoding - to have nanosecond granularity.

Timestamp precision is limited to the JVM and Platform's available granularity, which in many cases is microseconds.

This change also grants users access to https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html#patterns[Java time's improved formatters], which include support fort ISO quarters, week-of-month, and a variety of timezone/offset-related format substitutions. For example:

[source,json]
--------------------------------------------------------------------------------
filter {
mutate {
add_field => {"nanos" => "Nanos: %{{n}}" }
}
}
--------------------------------------------------------------------------------

Results in the following event:

[source,json]
--------------------------------------------------------------------------------
{
"@timestamp" => 2021-10-31T22:32:34.747968Z,
"host" => "logstash.lan",
"nanos" => "Nanos: 747968000",
"message" => "test",
"type" => "stdin",
"@version" => "1"
}
--------------------------------------------------------------------------------

NOTE: These prs below are also in 7.15/7.16, we can delete these entries before v8.0.0-beta1 release
* Secure API https://github.com/elastic/logstash/pull/13308[#13308]
* geoip integrate air-gapped bootstrap script https://github.com/elastic/logstash/pull/13104[#13104]
* Add deprecation warnings for JAVA_HOME/… https://github.com/elastic/logstash/pull/13365[#13365]
* Fixes to build and run Logstah on JDK 17 https://github.com/elastic/logstash/pull/13306[#13306]

jsvd marked this conversation as resolved.
Show resolved Hide resolved

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we add a note about which 7.x release the beta-1 plugins align with? (See lines 103-104 in this file for reference.)

[[logstash-8-0-0-alpha2]]
=== Logstash 8.0.0-alpha2 Release Notes

Expand Down Expand Up @@ -51,4 +94,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