github-mirrors/logstash
1
0
Fork 0
mirror of https://github.com/elastic/logstash.git synced 2025-04-24 06:37:19 -04:00
Code Issues Projects Releases Packages Wiki Activity

Bump docs + release notes for 6.0.0 GA (#8656)

Browse source 
* Bump docs + release notes for 6.0.0 GA

This has a variety of changes. I rolled up more breaking plugin changes in here.
I also rolled up all 6.0 release notes and diffed them with 5.6.3. I removed release notes
that only dealt with improvements across 6.0 pre-release versions

* Incorporate various PR feedback

* Fixed a small typo
This commit is contained in:
Andrew Cholakian 2017-11-14 02:02:45 -05:00 • committed by DeDe Morton
parent 7484d8d00a
commit 97508c7417
2 changed files with 63 additions and 64 deletions
Download patch file Download diff file Expand all files Collapse all files

44
docs/static/breaking-changes.asciidoc vendored
View file

@ -23,8 +23,8 @@ These changes can impact any instance of Logstash and are plugin agnostic, but o
[float]
==== RPM/Deb package changes
* For `rpm` and `deb` release artifacts, config files that match the `*.conf` glob pattern must be in the conf.d folder,
or the files will not be loaded.
* For `rpm` and `deb` release artifacts, config files that match the `*.conf` glob pattern must be in the conf.d folder,
or the files will not be loaded. If there are non-configuration files in this folder this can be problematic.
[float]
==== Command Line Interface behavior
@ -36,6 +36,8 @@ These changes can impact any instance of Logstash and are plugin agnostic, but o
[float]
=== Plugin Changes
Note that the list of plugins included with Logstash has changed. Please check that the new plugin list still includes all plugins you use.
[float]
==== Elasticsearch output changes
@ -69,6 +71,44 @@ These changes can impact any instance of Logstash and are plugin agnostic, but o
** It is recommended to use the multiline support in Filebeat as a replacement - see https://www.elastic.co/guide/en/beats/filebeat/current/multiline-examples.html[configuration options available in Filebeat] for details.
* The options `congestion_threshold` and `target_field_for_codec` are now obsolete.
[float]
=== TCP Input Changes
* Changed the behaviour of the host field to contain the resolved peer hostname for a connection instead of its peer IP.
* Removed the `data_timeout` and `ssl_cacert` options because they are now obsolete.
* Moved the peer's IP to the new field `ip_address`.
[float]
=== TCP Output Changes
* Breaking: removed the `message_format` option because it is now obsolete.
[float]
=== SQS Output Changes
* Breaking: removed the `batch` and `batch_timeout` options because they are now obsolete.
[float]
=== Redis Output Changes
* Removed the `name` and `queue` options because they are now obsolete.
[float]
=== RabbitMQ Input/Output Changes
* Removed the `debug`, `tls_certificate_path`, and `tls_certificate_password` options because they are now obsolete.
[float]
=== Logstash Output HTTP
* Removed the `ssl_certificate_verify` option because it is now obsolete.
[float]
=== Logstash Input HTTP Poller
* Removed the `ssl_certificate_verify` option because it is now obsolete.
[float]
=== GeoIP Changes
* Removed the `lru_cache_size` option because it is now obsolete.
[float]
=== CEF Codec Changes
* Removed the `sev` and `deprecated_v1_fields` options because they are now obsolete.
[float]
==== List of plugins bundled with Logstash

83
docs/static/releasenotes.asciidoc vendored
View file

@ -3,12 +3,7 @@
This section summarizes the changes in the following releases:
* <<logstash-6-0-0-rc2,Logstash 6.0.0-rc2>>
* <<logstash-6-0-0-rc1,Logstash 6.0.0-rc1>>
* <<logstash-6-0-0-beta2,Logstash 6.0.0-beta2>>
* <<logstash-6-0-0-beta1,Logstash 6.0.0-beta1>>
* <<logstash-6-0-0-alpha2,Logstash 6.0.0-alpha2>>
* <<logstash-6-0-0-alpha1,Logstash 6.0.0-alpha1>>
* <<logstash-6-0-0,Logstash 6.0.0>>
ifdef::include-xpack[]
See also:
@ -16,68 +11,32 @@ See also:
* <<release-notes-xls>>
endif::include-xpack[]
[[logstash-6-0-0-rc2]]
=== Logstash 6.0.0-rc2 Release Notes
* https://github.com/elastic/logstash/commit/840439722d8ef4737c7e8101c59652ced191bbea[Improved performance]
* https://github.com/elastic/logstash/commit/546951fa889902d8ec56f8a7cec1dc41a21088ff[Modules: Set default credentials for Kibana if es info is present]
* More small consistency fixes for Windows
* Fix bug where the Elasticsearch output would not correctly log errors but rather log an exception in the error handler, thus hiding the actual error message.
[[logstash-6-0-0-rc1]]
=== Logstash 6.0.0-rc1 Release Notes
* https://github.com/elastic/logstash/pull/8318[Added all commercially supported plugins to bundled plugins]
* existing `JAVA_OPTS` env var is now ignored for consistency with Elasticsearch
* JAVA_TOOL_OPTIONS env var is cleared for consistency with Elasticsearch
* Now only LS_JAVA_OPTS env var is supported to append options to parsed options from the jvm.options file.
* dropped support of the LS_JVM_OPTS env var
* dropped support of the USE_RUBY and USE_DRIP environment variables
* Fixed https://github.com/elastic/logstash/pull/8226[password support] in modules
* A variety of small consistency / testing fixes for the Windows platform
* Misc stability fixes
[[logstash-6-0-0-beta2]]
=== Logstash 6.0.0-beta2 Release Notes
* Added `cloud.id` and `cloud.auth` support for modules to provide an easy way to integrate with Elastic Cloud service.
* Added an explicit `--setup` phase for modules which is used to install dashboards and Elasticsearch template.
* Enabled DLQ support for multipipelines
[[logstash-6-0-0-beta1]]
=== Logstash 6.0.0-beta1 Release Notes
[[logstash-6-0-0]]
=== Logstash 6.0.0 Release Notes
* This list does not include all breaking changes, please consult the <<breaking-changes,breaking changes>> document separately.
* Added new `logstash.yml` setting: `config.support_escapes`. When enabled, Logstash will interpret escape sequences in
strings in the pipeline configuration.
* Breaking: The setting `config.reload.interval` has been changed to use time value strings such as `5m`, `10s`, etc for
convenience. Previously, users had to convert this to a second time value themselves.
* Breaking: The list of plugins bundled with Logstash 6.0.0-beta1 release has changed. Please consult the breaking changes document
for a complete list.
* Added an explicit --setup phase for modules. This phase is used to install dashboards and the Elasticsearch template.
* Added support for running multiple pipelines in the same Logstash instance. Running multiple pipelines
allows users to isolate data flow, provide separate runtime pipeline parameters and helps simplify complex
configurations. This can be configured via the new `pipelines.yml` file.
* https://github.com/elastic/logstash/commit/840439722d8ef4737c7e8101c59652ced191bbea[Improved performance].
* https://github.com/elastic/logstash/commit/546951fa889902d8ec56f8a7cec1dc41a21088ff[Modules: Set default credentials for Kibana if es info is present].
* A variety of small consistency and testing fixes for the Windows platform
* https://github.com/elastic/logstash/pull/8318[Added all commercially supported plugins to bundled plugins].
* The existing `JAVA_OPTS` env var is now ignored for consistency with Elasticsearch.
* JAVA_TOOL_OPTIONS env var is cleared for consistency with Elasticsearch.
* Now only LS_JAVA_OPTS env var is supported to append options to parsed options from the jvm.options file.
* Dropped support for the LS_JVM_OPTS environment variable.
* Dropped support for the USE_RUBY and USE_DRIP environment variables.
* Added `cloud.id` and `cloud.auth` support for modules to provide an easy way to integrate with Elastic Cloud service.
* Enabled DLQ support for multipipelines.
* Added an {xpack} feature to manage Logstash configurations centrally in Elasticsearch. We've also added a UI to manage
configurations directly in Kibana without having to restart Logstash.
* Users can now visualize the Logstash configuration pipeline as part of the {xpack} monitoring feature.
* We now report an error if config file referenced in the `pipelines.yml` is missing.
[[logstash-6-0-0-alpha2]]
=== Logstash 6.0.0-alpha2 Release Notes
==== Plugins
* Breaking: Currently, when Logstash is installed and set up via package managers, it loads all files found
in `/etc/logstash/conf.d` as configuration. This can be problematic if there are non-configuration files in this
folder. Starting from alpha2, Logstash will only glob files ending with `.conf` extension in `/etc/logstash/conf.d` ({lsissue}6979)[Issue 6979)]).
* Added support for running multiple pipelines in the same Logstash instance. Running multiple pipelines
allow users to isolate data flow, provide separate runtime pipeline parameters and helps simplify complex
configurations.
* A new `pipelines.yml` configuration file has been added to define pipelines.
[[logstash-6-0-0-alpha1]]
=== Logstash 6.0.0-alpha1 Release Notes
* Introducing a new internal representation for the existing Logstash configuration that forms the
foundation of many new features. This is not a breaking change, and existing configs will work as is.
[float]
==== Filter Plugins
*`GeoIP`*: You can now use MaxMind's commercial database to get enriched Geo information. ASN data can be
* `GeoIP Filter`: You can now use MaxMind's commercial database to get enriched Geo information. ASN data can be
obtained via the GeoIP2-ISP database.