This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.

« How to write a Java output plugin Breaking changes in 8.0 series »

›

Breaking changes

Coming in 9.0.0.

We strive to maintain backward compatibility between minor versions (8.x to 8.y, for example) so that you can upgrade without changing any configuration files. On occasion, we are forced to break compatibility within a given major release to ensure correctness of operation.

This section covers the changes that you need to be aware of when migrating to Logstash 9.0.0 and later.

Migrating directly between non-consecutive major versions (7.x to 9.x) is not recommended. We suggest that you upgrade to the last release in the 8.x series before you upgrade to 9.0.

Check out our Release Notes for additional release information.

Breaking changes in 9.0

Coming in 9.0.0.

Breaking change number one (sample)

Include:

change
user impact/decription/value prop
link to relevant docs for more information

Changes to SSL settings in Logstash plugins

We’ve removed deprecated SSL settings in some Logstash plugins, and have replaced them with updated settings. If your plugin configuration contains any of these obsolete options, the plugin may fail to start.

Click the arrow beside a plugin name to see the list of settings that have been removed and their replacements.

Plugins with changes to SSL settings

logstash-input-elasticsearch

Setting	Replaced by
ca_file	`ssl_certificate_authorities`
ssl	`ssl_enabled`
ssl_certificate_verification	`ssl_verification_mode`

logstash-output-elasticsearch

Setting	Replaced by
cacert	`ssl_certificate_authorities`
keystore	`ssl_keystore_path`
keystore_password	`ssl_keystore_password`
ssl	`ssl_enabled`
ssl_certificate_verification	`ssl_verification_mode`
truststore	`ssl_truststore_path`
truststore_password	`ssl_truststore_password`

logstash-output-http

Setting	Replaced by
cacert	`ssl_certificate_authorities`
client_cert	`ssl_certificate`
client_key	`ssl_key`
keystore	`ssl_keystore_path`
keystore_password	`ssl_keystore_password`
keystore_type	`ssl_keystore_password`
truststore	`ssl_truststore_path`
truststore_password	`ssl_truststore_password`
truststore_type	`ssl_truststore_type`

Breaking changes in earlier releases

See these topics for breaking changes in earlier releases:

« How to write a Java output plugin Breaking changes in 8.0 series »