Breaking changes in 2.2 Although 2.2 is fully compatible with configurations from older versions, there are some architectural changes to the pipeline that users need to take into consideration before deploying in production. These changes are not strictly "breaking" in the semantic versioning sense, but they make Logstash behave differently in runtime, and can also affect performance. We have compiled such a list in the Upgrading Logstash to 2.2 section. Please review it before deploying 2.2 version.
Changes in 2.0
Version 2.0 of Logstash has some changes that are incompatible with previous versions of Logstash. This section discusses what you need to be aware of when migrating to this version.
Elasticsearch Output Defaultedit
Starting with the 2.0 release of Logstash, the default Logstash output for Elasticsearch is HTTP. To use the
transport protocols, download the Elasticsearch Java plugin. The
Logstash HTTP output to Elasticsearch now supports sniffing.
elasticsearch_java plugin has two versions specific to the version of the underlying Elasticsearch cluster.
Be sure to specify the correct value for the
--version option during installation:
* For Elasticsearch versions before 2.0, use the command
bin/plugin install --version 1.5.x logstash-output-elasticsearch_java
* For Elasticsearch versions 2.0 and after, use the command
bin/plugin install --version 2.0.0 logstash-output-elasticsearch_java
The Elasticsearch output plugin configuration has the following changes:
hostconfiguration option is now
hosts, allowing you to specify multiple hosts and associated ports in the
max_inflight_requestsoption, which was deprecated in the 1.5 release, is now removed
hostsoption allows specification of ports for the hosts, the redundant
portoption is now removed
protocoloptions have been moved to the
The following deprecated configuration settings are removed in this release:
input plugin configuration settings:
output plugin configuration settings:
filter plugin configuration settings:
Configuration files with these settings present are invalid and prevent Logstash from starting.
Kafka Output Configuration Changesedit
The 2.0 release of Logstash includes a new version of the Kafka output plugin with significant configuration changes. Please compare the documentation pages for the Logstash 1.5 and Logstash 2.0 versions of the Kafka output plugin and update your configuration files accordingly.
Metrics Filter Changesedit
Prior implementations of the metrics filter plugin used dotted field names. Elasticsearch does not allow field names to have dots, beginning with version 2.0, so a change was made to use sub-fields instead of dots in this plugin. Please note that these changes make version 3.0.0 of the metrics filter plugin incompatible with previous releases.
Filter Worker Default Changeedit
Starting with the 2.0 release of Logstash, the default value of the
filter_workers configuration option for filter
plugins is half of the available CPU cores, instead of 1. This change increases parallelism in filter execution for
resource-intensive filtering operations. You can continue to use the
-w flag to manually set the value for this option,
as in previous releases.