logstash/docs/static/breaking-changes.asciidoc
2018-06-15 12:39:48 -07:00

56 lines
2.1 KiB
Text

[[breaking-changes]]
== Breaking Changes
This section discusses the changes that you need to be aware of when migrating to Logstash 6.0.0 from the previous major releases.
See also <<releasenotes>>.
[float]
=== Breaking change across PQ versions prior to Logstash 6.3.0
If you are upgrading from Logstash 6.2.x or any earlier version (including 5.x)
and have the persistent queue enabled, we strongly recommend that you drain or
delete the persistent queue before you upgrade. See <<upgrading-logstash-pqs>>
for information and instructions.
We are working to resolve issues with data incompatibilities in our 6.3.0
release so that additional steps won't be required for future upgrades.
[float]
=== Changes in Logstash Core
These changes can impact any instance of Logstash and are plugin agnostic, but only if you are using the features that are impacted.
[float]
==== Application Settings
* The setting `config.reload.interval` has been changed to use time value strings such as `5m`, `10s` etc.
Previously, users had to convert this to a millisecond time value themselves.
[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.
[float]
==== Command Line Interface behavior
* The `-e` and `-f` CLI options are now mutually exclusive. This also applies to the corresponding long form options `config.string` and
`path.config`. This means any configurations provided via `-e` will no longer be appended to the configurations provided via `-f`.
* Configurations provided with `-f` or `config.path` will not be appended with `stdin` input and `stdout` output automatically.
[float]
==== List of plugins bundled with Logstash
The following plugins were removed from the 5.0 default bundle based on usage data. You can still install these plugins manually:
* logstash-codec-oldlogstashjson
* logstash-input-couchdb_changes
* logstash-input-irc
* logstash-input-log4j
* logstash-input-lumberjack
* logstash-filter-uuid
* logstash-output-xmpp
* logstash-output-irc
* logstash-output-statsd